- Solicitação HTTP
- Corpo da solicitação
- Corpo da resposta
- 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 |
---|
{ "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 jogador do PGS / o usuário e o aplicativo do Google. |
persona |
Obrigatório. Identificador estável da conta no jogo. Evite reutilizar o mesmo perfil em jogos diferentes. |
token |
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 |
Obrigatório. Restrição de cardinalidade a ser observada ao vincular uma persona a um jogador no escopo de um jogo. |
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 |
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: |
ttl |
Somente 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 vínculo de persona.
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 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 | |
---|---|
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. O
|
ConflictingLinksResolutionPolicy
Política de resolução a ser aplicada quando a vinculação de uma persona a um jogador resultar em violação da restrição de cardinalidade especificada.
Enums | |
---|---|
KEEP_EXISTING_LINKS |
Se já existirem vínculos entre um jogador e um perfil, o que resultaria na violação do 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 |
CREATE_NEW_LINK |
Se um link existente entre um jogador e uma persona já existir, o que resultaria na violação do 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. |