- Richiesta HTTP
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- RecallTokensCardinalityConstraint
- ConflictingLinksResolutionPolicy
- Stato
- Prova!
Associa l'entità giocatore dei servizi per i giochi di Play e codificata nell'ID sessione di richiamo fornito a un account in-game
Richiesta HTTP
POST https://games.googleapis.com/games/v1/recall:linkPersona
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum ( |
Campi | |
---|---|
sessionId |
Obbligatorio. Stringa opaca generata dal server che codifica tutte le informazioni necessarie per identificare il player dei servizi per i giochi di Play / utente e l'applicazione Google. |
persona |
Obbligatorio. Identificatore stabile dell'account in-game. Evita di riutilizzare lo stesso utente tipo per giochi diversi. |
token |
Obbligatorio. Valore del token da creare. Opaca per Play Giochi e presupposta non stabile (criptata con la rotazione della chiave). |
cardinalityConstraint |
Obbligatorio. Vincolo di cardinalità da osservare quando si collega un utente tipo a un giocatore nell'ambito di un gioco. |
conflictingLinksResolutionPolicy |
Obbligatorio. Criterio di risoluzione da applicare quando il collegamento di un utente tipo a un giocatore comporterebbe la violazione del vincolo di cardinalità specificato. |
Campo unione expiration . Ora di scadenza o durata facoltativa del token. expiration può essere solo uno dei seguenti: |
|
expireTime |
Solo input. Ora di scadenza facoltativa. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
ttl |
Solo input. Durata (TTL) facoltativa. Durata in secondi con un massimo di nove cifre frazionarie e termina con " |
Corpo della risposta
Risultato di un tentativo di collegamento dell'utente tipo.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"state": enum ( |
Campi | |
---|---|
state |
Solo output. Stato di un tentativo di collegamento degli utenti tipo. |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/androidpublisher
Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
RecallTokensCardinalityConstraint
Vincolo di cardinalità da osservare quando si collega un utente tipo a un giocatore nell'ambito di un gioco.
Enum | |
---|---|
ONE_PERSONA_TO_ONE_PLAYER |
Cardinalità 1:1 tra utenti tipo in-game e giocatori dei servizi per i giochi di Play. Al termine dell'operazione di collegamento, dovrebbe rimanere nell'ambito dell'applicazione una sola voce per il player e l'utente tipo. La creazione o meno di un nuovo collegamento quando viene specificato questo vincolo dipende dall'elemento
|
ConflictingLinksResolutionPolicy
Criterio di risoluzione da applicare quando il collegamento di un utente tipo a un giocatore comporterebbe la violazione del vincolo di cardinalità specificato.
Enum | |
---|---|
KEEP_EXISTING_LINKS |
Se esistono già dei collegamenti tra un giocatore e un utente tipo, il che comporterebbe la violazione del valore Ad esempio, se Persona1-Player1 è già collegata nell'ambito dell'applicazione1 e si cerca di creare un nuovo collegamento Persona1-Player2 nell'ambito dell'applicazione1, il collegamento precedente rimarrà e non ne verrà aggiunto di nuovi. Tieni presente che se i link già esistenti violano le norme specificate (il che potrebbe verificarsi se non tutte le chiamate a |
CREATE_NEW_LINK |
Se esiste già un collegamento tra un giocatore e un utente tipo, che potrebbe comportare la violazione del valore Ad esempio, se Persona1-Player1 è già collegata nell'ambito dell'application1 e si cerca di creare un nuovo collegamento Persona1-Player2 nell'ambito dell'application1, il vecchio collegamento verrà rimosso e il nuovo verrà aggiunto per sostituirlo. |
Stato
Stato di un tentativo di collegamento degli utenti tipo.
Enum | |
---|---|
LINK_CREATED |
È stato creato il collegamento specificato nella richiesta. |
PERSONA_OR_PLAYER_ALREADY_LINKED |
Il link specificato nella richiesta non è stato creato perché i link già esistenti potrebbero far sì che il nuovo link violi il RecallTokensCardinalityConstraint specificato. |