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
Faça um teste

Associar o principal do jogador do PGS codificado no ID da sessão de recuperação informado 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 player do PGS / o usuário e o app do Google.
`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. Opaco para o Play Games e considerado não estável (criptografado com a rotação de chaves).
`cardinalityConstraint`	`enum (RecallTokensCardinalityConstraint)` Obrigatório. Restrição de cardinalidade a ser observada ao vincular um perfil 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 um perfil a um jogador resultaria na violação da restrição de cardinalidade especificada.
Campo de união `expiration`. Prazo de validade ou vida útil 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 UTC "Zulu" RFC3339, 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. 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 do 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 do perfil.

state

enum (State)

Apenas saída. Estado de uma tentativa de vinculação do 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 um perfil a um jogador no escopo de um jogo.

Enums

Enums
`ONE_PERSONA_TO_ONE_PLAYER`	Cardinalidade individual entre os perfis no jogo e os 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 `ConflictingLinksResolutionPolicy` escolhida determina se uma nova vinculação será criada ou não quando essa restrição for especificada: Se `KEEP_EXISTING_LINKS` for especificado e o perfil fornecido já estiver vinculado a outro jogador ou se o jogador já estiver vinculado a outra persona, nenhum novo link será criado e os links existentes permanecerão como estão. Se `CREATE_NEW_LINK` for especificado e o perfil fornecido já estiver vinculado a outro jogador, ou se o jogador já estiver vinculado a outra persona, os links mais antigos serão removidos para que o novo link seja criado.

ONE_PERSONA_TO_ONE_PLAYER

Cardinalidade individual entre os perfis no jogo e os 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 ConflictingLinksResolutionPolicy escolhida determina se uma nova vinculação será criada ou não quando essa restrição for especificada:

Se KEEP_EXISTING_LINKS for especificado e o perfil fornecido já estiver vinculado a outro jogador ou se o jogador já estiver vinculado a outra persona, nenhum novo link será criado e os links existentes permanecerão como estão.
Se CREATE_NEW_LINK for especificado e o perfil fornecido já estiver vinculado a outro jogador, ou se o jogador já estiver vinculado a outra persona, os links mais antigos serão removidos para que o novo link seja criado.

ConflictingLinksResolutionPolicy

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

Enums

Enums
`KEEP_EXISTING_LINKS`	Se já houver vínculos entre um jogador e um personagem que resultem na violação dos `RecallTokensCardinalityConstraint` especificados caso um novo link tenha sido criado, mantenha aqueles já existentes. Por exemplo, se Persona1-Player1 já estiver vinculado no escopo de application1 e tentar criar um novo link Persona1-Player2 no escopo de application1 com a restrição `MANY_PERSONAS_TO_ONE_PLAYER`, o link antigo 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 não vai ser resolvida. Para resolver conflitos, a política {@link `CREATE_NEW_LINK` precisa ser usada para reescrever links e resolver conflitos.
`CREATE_NEW_LINK`	Se já existir um vínculo entre um jogador e um personagem, o que resultaria na violação dos `RecallTokensCardinalityConstraint` especificados caso um novo link fosse criado, substitua os links existentes por um novo. Por exemplo, se Persona1-Player1 já estiver vinculado no escopo de application1 e tentar criar um novo link Persona1-Player2 no escopo de application1 com a restrição `MANY_PERSONAS_TO_ONE_PLAYER`, 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 um personagem que resultem na violação dos RecallTokensCardinalityConstraint especificados caso um novo link tenha sido criado, mantenha aqueles já existentes.

Por exemplo, se Persona1-Player1 já estiver vinculado no escopo de application1 e tentar criar um novo link Persona1-Player2 no escopo de application1 com a restrição MANY_PERSONAS_TO_ONE_PLAYER, o link antigo 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 não vai ser resolvida. Para resolver conflitos, a política {@link CREATE_NEW_LINK precisa ser usada para reescrever links e resolver conflitos.

CREATE_NEW_LINK

Se já existir um vínculo entre um jogador e um personagem, o que resultaria na violação dos RecallTokensCardinalityConstraint especificados caso um novo link fosse criado, substitua os links existentes por um novo.

Estado

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

Enums
`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, se já existir, um novo link violaria o `RecallTokensCardinalityConstraint` especificado.