Method: recall.linkPersona

• Richiesta HTTP
• Corpo della richiesta
  • Rappresentazione JSON
• Corpo della risposta
  • Rappresentazione JSON
• 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 (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 PGS, l'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 si presume che sia non stabile (criptata con rotazione della chiave).
cardinalityConstraint	enum (RecallTokensCardinalityConstraint) Obbligatorio. Vincolo di cardinalità da osservare quando colleghi un utente tipo a un giocatore nell'ambito di un gioco.
conflictingLinksResolutionPolicy	enum (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	string (Timestamp format) Solo input. Data di scadenza facoltativa. Un timestamp in formato "Zulu" UTC RFC3339, 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 facoltativa. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

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

Campi
state	enum (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 scelto: Se KEEP_EXISTING_LINKS è specificato e l'utente tipo fornito è già collegato a un altro player o il player è già collegato a un utente tipo diverso, non verrà creato nessun nuovo link e i link esistenti rimarranno invariati. Se CREATE_NEW_LINK è specificato e l'utente tipo fornito è già collegato a un altro player o il player è già collegato a un altro utente tipo, i link precedenti verranno rimossi a favore della creazione del nuovo link.

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 RecallTokensCardinalityConstraint specificati nel caso in cui fosse stato creato un nuovo link, mantieni quelli già esistenti. 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 MANY_PERSONAS_TO_ONE_PLAYER, il vecchio link rimarrà e non ne verrà aggiunto un nuovo. Tieni presente che se i link già esistenti violano le norme specificate (cosa che potrebbe verificarsi se non tutte le chiamate recall.linkPersona utilizzano lo stesso RecallTokensCardinalityConstraint), questa norma lascerà queste violazioni irrisolte; per risolvere i conflitti, è necessario utilizzare la norma sui {@link CREATE_NEW_LINK per riscrivere i link per risolvere i conflitti.
CREATE_NEW_LINK	Se esiste già un collegamento tra un player e un utente tipo e questo comporterebbe la violazione dei RecallTokensCardinalityConstraint specificati nel caso in cui venisse creato un nuovo link, sostituisci i link già esistenti con il nuovo link. 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 MANY_PERSONAS_TO_ONE_PLAYER, il vecchio link verrà rimosso e il nuovo link verrà aggiunto per sostituirlo.

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.