- Richiesta HTTP
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- RecallTokensCardinalityConstraint
- ConflictingLinksResolutionPolicy
- Stato
- Prova!
Associa l'entità player PGS 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 PGS, l'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 si presume che sia non stabile (criptata con rotazione della chiave). |
cardinalityConstraint |
Obbligatorio. Vincolo di cardinalità da osservare quando colleghi un utente tipo a un giocatore nell'ambito di un gioco. |
conflictingLinksResolutionPolicy |
Obbligatorio. Norme di risoluzione da applicare quando il collegamento di un utente tipo a un player comporterebbe la violazione del vincolo di cardinalità specificato. |
Campo di unione expiration . Data/ora di scadenza o durata facoltativa del token (facoltativo). expiration può essere solo uno dei seguenti: |
|
expireTime |
Solo input. Data di scadenza facoltativa. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
ttl |
Solo input. Durata facoltativa. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
Corpo della risposta
Il risultato di un tentativo di collegamento di utenti 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 del tentativo di collegamento di un utente 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 colleghi 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, solo una voce per il player e l'utente tipo dovrebbe rimanere nell'ambito dell'applicazione. La creazione o meno di un nuovo collegamento quando viene specificato questo vincolo viene determinata dall'elemento
|
ConflictingLinksResolutionPolicy
Norme di risoluzione da applicare quando il collegamento di un utente tipo a un player comporterebbe la violazione del vincolo di cardinalità specificato.
Enum | |
---|---|
KEEP_EXISTING_LINKS |
Se esistono già dei collegamenti tra un player e un utente tipo che comporterebbero la violazione dei Ad esempio, se Persona1-Player1 è già collegato nell'ambito di application1 e si tenta di creare un nuovo link Persona1-Player2 nell'ambito di application1 con il vincolo Tieni presente che se i link già esistenti violano le norme specificate (cosa che potrebbe verificarsi se non tutte le chiamate |
CREATE_NEW_LINK |
Se esiste già un collegamento tra un player e un utente tipo e questo comporterebbe la violazione dei Ad esempio, se Persona1-Player1 è già collegato nell'ambito di application1 e si tenta di creare un nuovo collegamento Persona1-Player2 nell'ambito di application1 con il vincolo |
Stato
Stato del tentativo di collegamento di un utente tipo.
Enum | |
---|---|
LINK_CREATED |
Il collegamento specificato nella richiesta è stato creato. |
PERSONA_OR_PLAYER_ALREADY_LINKED |
Il link specificato nella richiesta non è stato creato perché, se creati, i link già esistenti comporterebbero la violazione del RecallTokensCardinalityConstraint specificato nel nuovo link. |