Method: recall.linkPersona

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 (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.
}
Campi
sessionId

string

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

string

Obbligatorio. Identificatore stabile dell'account in-game. Evita di riutilizzare lo stesso utente tipo per giochi diversi.
token

string

Obbligatorio. Valore del token da creare. Opaca per Play Giochi e presupposta non stabile (criptata con la rotazione della chiave).
cardinalityConstraint

enum (RecallTokensCardinalityConstraint)

Obbligatorio. Vincolo di cardinalità da osservare quando si collega un utente tipo a un giocatore nell'ambito di un gioco.
Campo unione expiration. Ora di scadenza o durata facoltativa del token. expiration può essere solo uno dei seguenti:
expireTime

string (Timestamp format)

Solo input. Ora di scadenza facoltativa.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
ttl

string (Duration format)

Solo input. Durata (TTL) facoltativa.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

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 (State)
}
Campi
state

enum (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 scelto:

  • Se KEEP_EXISTING_LINKS viene specificato e l'utente tipo fornito è già collegato a un altro giocatore o se il player è già collegato a un utente tipo diverso, non verranno creati nuovi collegamenti e quelli già esistenti rimarranno invariati.

  • Se CREATE_NEW_LINK viene specificato e l'utente tipo fornito è già collegato a un altro giocatore oppure il giocatore è già collegato a un altro utente tipo, i collegamenti precedenti verranno rimossi a favore della creazione del nuovo collegamento.

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

Stato

Stato di un tentativo di collegamento degli utenti tipo.

Enum
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.