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

Associe o principal jogador do PGS codificado no ID da sessão de recuperação 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 / o usuário e o aplicativo do Google.
`persona`	`string` Obrigatório. Identificador estável da conta no jogo. Evite reutilizar o mesmo perfil em 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 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 resultaria em violação da restrição de cardinalidade especificada.
Campo de união `expiration`. Prazo de validade ou time to live (TTL) do token opcional. `expiration` pode ser apenas de um dos tipos a seguir:
`expireTime`	`string (Timestamp format)` Somente 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)` Somente 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 vínculo de persona.

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.

Enums

Enums
`ONE_PERSONA_TO_ONE_PLAYER`	Cardinalidade individual entre personas 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 devem permanecer no escopo do aplicativo. A criação ou não de um novo vínculo 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 se o jogador já estiver vinculado a outro perfil, nenhum link novo será criado, e os links já 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 outro perfil, os links antigos serão removidos para favorecer a criação do novo link.

ONE_PERSONA_TO_ONE_PLAYER

Cardinalidade individual entre personas 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 devem permanecer no escopo do aplicativo.

A criação ou não de um novo vínculo 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 se o jogador já estiver vinculado a outro perfil, nenhum link novo será criado, e os links já 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 outro perfil, os links antigos serão removidos para favorecer a criação do novo link.

ConflictingLinksResolutionPolicy

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

Enums

Enums
`KEEP_EXISTING_LINKS`	Se já existirem vínculos entre um jogador e um perfil, o que resultaria na violação do `RecallTokensCardinalityConstraint` especificado caso a nova vinculação fosse criada, mantenha os links atuais. Por exemplo, se Persona1-Player1 já estiver vinculado no escopo de application1 e um novo link Persona1-Player2 for criado no escopo de application1, o link antigo vai permanecer e nenhum link novo vai ser adicionado. Se os links já existentes violarem a política especificada (o que pode ocorrer se nem todas as chamadas de `recall.linkPersona` usarem a mesma `RecallTokensCardinalityConstraint`), essa política não vai ser resolvida. Para resolver conflitos, a política {@link `CREATE_NEW_LINK` precisa ser usada para reescrever os links que resolvem os conflitos.
`CREATE_NEW_LINK`	Se um link existente entre um jogador e uma persona já existir, o que resultaria na violação do `RecallTokensCardinalityConstraint` especificado se o novo link fosse criado, substitua os links existentes pelo novo. Por exemplo, se Persona1-Player1 já estiver vinculado no escopo de application1 e um novo link Persona1-Player2 for criado no escopo de application1, o link antigo será removido e o novo será adicionado para substituí-lo.

KEEP_EXISTING_LINKS

Se já existirem vínculos entre um jogador e um perfil, o que resultaria na violação do RecallTokensCardinalityConstraint especificado caso a nova vinculação fosse criada, mantenha os links atuais.

Por exemplo, se Persona1-Player1 já estiver vinculado no escopo de application1 e um novo link Persona1-Player2 for criado no escopo de application1, o link antigo vai permanecer e nenhum link novo vai ser adicionado.

Se os links já existentes violarem a política especificada (o que pode ocorrer se nem todas as chamadas de recall.linkPersona usarem a mesma RecallTokensCardinalityConstraint), essa política não vai ser resolvida. Para resolver conflitos, a política {@link CREATE_NEW_LINK precisa ser usada para reescrever os links que resolvem os conflitos.

CREATE_NEW_LINK

Se um link existente entre um jogador e uma persona já existir, o que resultaria na violação do RecallTokensCardinalityConstraint especificado se o novo link fosse criado, substitua os links existentes pelo novo.

Por exemplo, se Persona1-Player1 já estiver vinculado no escopo de application1 e um novo link Persona1-Player2 for criado no escopo de application1, o link antigo será removido e o novo será adicionado para substituí-lo.

Estado

Estado de uma tentativa de vinculação de 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 criado, o novo link violaria o `RecallTokensCardinalityConstraint` especificado.