Method: recall.linkPersona

Associar o principal do jogador do PGS codificado no ID da sessão de recuperação fornecido a uma conta no jogo

Solicitação HTTP

POST https://games.googleapis.com/games/v1/recall:linkPersona

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "sessionId": string,
  "persona": string,
  "token": string,
  "cardinalityConstraint": enum (RecallTokensCardinalityConstraint),
  "conflictingLinksResolutionPolicy": enum (ConflictingLinksResolutionPolicy),

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}
Campos
sessionId

string

Obrigatório. String opaca gerada pelo servidor que codifica todas as informações necessárias para identificar o jogador do PGS / usuário do Google e o aplicativo.
persona

string

Obrigatório. Identificador estável da conta no jogo. Não reutilize o mesmo perfil para jogos diferentes.
token

string

Obrigatório. Valor do token a ser criado. Oculto ao Google Play Games e considerado não estável (criptografado com rotação de chaves).
cardinalityConstraint

enum (RecallTokensCardinalityConstraint)

Obrigatório. Restrição de cardinalidade a ser observada ao vincular uma persona a um jogador no escopo de um jogo.
Campo de união expiration. Tempo de validade ou de expiração do token opcional. expiration pode ser apenas de um dos tipos a seguir:
expireTime

string (Timestamp format)

Apenas entrada. Prazo de validade opcional.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
ttl

string (Duration format)

Apenas entrada. Time to live opcional.

Uma duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

Corpo da resposta

Resultado de uma tentativa de vinculação de perfil.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "state": enum (State)
}
Campos
state

enum (State)

Apenas saída. Estado de uma tentativa de vinculação de perfil.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/androidpublisher

Para mais informações, consulte a Visão geral do OAuth 2.0.

RecallTokensCardinalityConstraint

Restrição de cardinalidade a ser observada ao vincular uma persona a um jogador no escopo de um jogo.

Enumerações
ONE_PERSONA_TO_ONE_PLAYER

Cardinalidade 1:1 entre perfis no jogo e jogadores dos serviços relacionados a jogos do Google Play.

Ao final da operação de vinculação, apenas uma entrada para o jogador e a persona deve permanecer no escopo do aplicativo.

A criação de um novo link quando essa restrição é especificada é determinada pelo ConflictingLinksResolutionPolicy escolhido:

  • Se KEEP_EXISTING_LINKS for especificado e o perfil fornecido já estiver vinculado a outro jogador ou o jogador já estiver vinculado a outro perfil, nenhum novo vínculo será criado e os vínculos já existentes vão permanecer como estão.

  • Se CREATE_NEW_LINK for especificado e a persona fornecida já estiver vinculada a um jogador diferente ou se o jogador já estiver vinculado a outra persona, as vinculações mais antigas serão removidas para que a nova seja criada.

ConflictingLinksResolutionPolicy

Política de resolução a ser aplicada quando a vinculação de uma persona a um jogador resultar na violação da restrição de cardinalidade especificada.

Enumerações

Estado

Estado de uma tentativa de vinculação de perfil.

Enumerações
PERSONA_OR_PLAYER_ALREADY_LINKED O link especificado na solicitação não foi criado porque os links já existentes resultariam na violação do RecallTokensCardinalityConstraint especificado se o novo link fosse criado.