- Solicitação HTTP
- Corpo da solicitação
- Corpo da resposta
- 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 |
---|
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum ( |
Campos | |
---|---|
sessionId |
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 |
Obrigatório. Identificador estável da conta no jogo. Não reutilize o mesmo perfil para jogos diferentes. |
token |
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 |
Obrigatório. Restrição de cardinalidade a ser observada ao vincular um perfil a um jogador no escopo de um jogo. |
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 |
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: |
ttl |
Apenas entrada. Time to live opcional. Duração em segundos com até nove dígitos fracionários, terminando em " |
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 ( |
Campos | |
---|---|
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 | |
---|---|
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
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 | |
---|---|
KEEP_EXISTING_LINKS |
Se já houver vínculos entre um jogador e um personagem que resultem na violação dos 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 Se os links já existentes violarem a política especificada, o que pode ocorrer se nem todas as chamadas |
CREATE_NEW_LINK |
Se já existir um vínculo entre um jogador e um personagem, o que resultaria na violação dos 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 |
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. |