Esta página foi traduzida pela API Cloud Translation.

Method: recall.linkPersona

Solicitação HTTP
Corpo da solicitação
- Representação JSON
Corpo da resposta
- Representação JSON
Escopos de autorização
RecallTokensCardinalityConstraint
ConflictingLinksResolutionPolicy
Estado
Testar

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

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`. }

{
  "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.
`conflictingLinksResolutionPolicy`	`enum (ConflictingLinksResolutionPolicy)` Obrigatório. 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.
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

Campos
`state`	`enum (State)` Apenas saída. Estado de uma tentativa de vinculação de perfil.

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

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.

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

Enumerações
`KEEP_EXISTING_LINKS`	Se já houver vínculos entre um jogador e uma persona que violariam o `RecallTokensCardinalityConstraint` especificado se o novo vínculo fosse criado, mantenha os vínculos atuais. Por exemplo, se Persona1-Player1 já estiver vinculado no escopo do aplicativo1 e uma nova vinculação Persona1-Player2 for criada no escopo do aplicativo1, o link antigo vai permanecer e nenhum novo link será adicionado. Se os links já existentes violarem a política especificada (o que pode ocorrer se nem todas as chamadas `recall.linkPersona` usarem o mesmo `RecallTokensCardinalityConstraint`), essa política vai deixar essas violações sem solução. Para resolver conflitos, a política {@link `CREATE_NEW_LINK` precisa ser usada para reescrever links que resolvem conflitos.
`CREATE_NEW_LINK`	Se já houver uma vinculação entre um jogador e uma persona que violaria o `RecallTokensCardinalityConstraint` especificado se a nova vinculação fosse criada, substitua as vinculações atuais pela nova. Por exemplo, se Persona1-Player1 já estiver vinculado no escopo do aplicativo1 e uma nova vinculação Persona1-Player2 for criada no escopo do aplicativo1, o link antigo será removido e o novo será adicionado para substituí-lo.

KEEP_EXISTING_LINKS

Se já houver vínculos entre um jogador e uma persona que violariam o RecallTokensCardinalityConstraint especificado se o novo vínculo fosse criado, mantenha os vínculos atuais.

Por exemplo, se Persona1-Player1 já estiver vinculado no escopo do aplicativo1 e uma nova vinculação Persona1-Player2 for criada no escopo do aplicativo1, o link antigo vai permanecer e nenhum novo link será adicionado.

Se os links já existentes violarem a política especificada (o que pode ocorrer se nem todas as chamadas recall.linkPersona usarem o mesmo RecallTokensCardinalityConstraint), essa política vai deixar essas violações sem solução. Para resolver conflitos, a política {@link CREATE_NEW_LINK precisa ser usada para reescrever links que resolvem conflitos.

CREATE_NEW_LINK

Se já houver uma vinculação entre um jogador e uma persona que violaria o RecallTokensCardinalityConstraint especificado se a nova vinculação fosse criada, substitua as vinculações atuais pela nova.

Por exemplo, se Persona1-Player1 já estiver vinculado no escopo do aplicativo1 e uma nova vinculação Persona1-Player2 for criada no escopo do aplicativo1, o link antigo será removido e o novo será adicionado para substituí-lo.

Estado

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

Enumerações
`LINK_CREATED`	O link especificado na solicitação foi criado.
`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.