Cette page a été traduite par l'API Cloud Translation.

Method: recall.linkPersona

Requête HTTP
Corps de la requête
- Représentation JSON
Corps de la réponse
- Représentation JSON
Champs d'application des autorisations
RecallTokensCardinalityConstraint
ConflictingLinksResolutionPolicy
État
Essayer

Associer le compte principal de joueur PGS encodé dans l'ID de session de rappel fourni à un compte de jeu

Requête HTTP

POST https://games.googleapis.com/games/v1/recall:linkPersona

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON

Représentation 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`. }

{
  "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.
}

Champs
`sessionId`	`string` Obligatoire. Chaîne opaque générée par le serveur qui encode toutes les informations nécessaires pour identifier le joueur PGS, l'utilisateur et l'application Google.
`persona`	`string` Obligatoire. Identifiant stable du compte de jeu. Merci de ne pas réutiliser le même personnage pour d'autres jeux.
`token`	`string` Obligatoire. Valeur du jeton à créer. Opaque pour Play Jeux et considérée comme instable (chiffrée avec la rotation des clés).
`cardinalityConstraint`	`enum (RecallTokensCardinalityConstraint)` Obligatoire. Contrainte de cardinalité à observer lorsque vous associez un personnage à un joueur dans le cadre d'un jeu.
`conflictingLinksResolutionPolicy`	`enum (ConflictingLinksResolutionPolicy)` Obligatoire. Règle de résolution à appliquer lorsque l'association d'un persona à un joueur entraîne le non-respect de la contrainte de cardinalité spécifiée.
Champ d'union `expiration`. Délai d'expiration ou valeur TTL du jeton (facultatif). `expiration` ne peut être qu'un des éléments suivants :
`expireTime`	`string (Timestamp format)` Uniquement en entrée. Délai d'expiration facultatif. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: `"2014-10-02T15:01:23Z"` et `"2014-10-02T15:01:23.045123456Z"`.
`ttl`	`string (Duration format)` Uniquement en entrée. Valeur TTL facultative. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "`s`". Exemple: `"3.5s"`.

Corps de la réponse

Résultat d'une tentative d'association de persona.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{ "state": enum (`State`) }

Champs

Champs
`state`	`enum (State)` Uniquement en sortie. État d'une tentative d'association d'un persona.

state

enum (State)

Uniquement en sortie. État d'une tentative d'association d'un persona.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

https://www.googleapis.com/auth/androidpublisher

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

RecallTokensCardinalityConstraint

Contrainte de cardinalité à observer lorsque vous associez un personnage à un joueur dans le cadre d'un jeu.

Enums

Enums
`ONE_PERSONA_TO_ONE_PLAYER`	Une cardinalité individuelle entre les personnages de jeu et les joueurs des services de jeux Play À la fin de l'opération d'association, une seule entrée pour le lecteur doit rester dans le champ d'application de l'application. La création d'une association ou non lorsque cette contrainte est spécifiée est déterminée par l'élément `ConflictingLinksResolutionPolicy` choisi: Si `KEEP_EXISTING_LINKS` est spécifié et que le persona fourni est déjà associé à un autre joueur, ou si le joueur est déjà lié à un autre personnage, aucun nouveau lien ne sera créé et le ou les liens existants resteront tels quels. Si `CREATE_NEW_LINK` est spécifié et que le persona fourni est déjà lié à un autre joueur, ou si le joueur est déjà lié à un autre personnage, le ou les anciens liens seront supprimés au profit du nouveau lien en cours de création.

ONE_PERSONA_TO_ONE_PLAYER

Une cardinalité individuelle entre les personnages de jeu et les joueurs des services de jeux Play

À la fin de l'opération d'association, une seule entrée pour le lecteur doit rester dans le champ d'application de l'application.

La création d'une association ou non lorsque cette contrainte est spécifiée est déterminée par l'élément ConflictingLinksResolutionPolicy choisi:

Si KEEP_EXISTING_LINKS est spécifié et que le persona fourni est déjà associé à un autre joueur, ou si le joueur est déjà lié à un autre personnage, aucun nouveau lien ne sera créé et le ou les liens existants resteront tels quels.
Si CREATE_NEW_LINK est spécifié et que le persona fourni est déjà lié à un autre joueur, ou si le joueur est déjà lié à un autre personnage, le ou les anciens liens seront supprimés au profit du nouveau lien en cours de création.

ConflictingLinksResolutionPolicy

Règle de résolution à appliquer lorsque l'association d'un persona à un joueur entraîne le non-respect de la contrainte de cardinalité spécifiée.

Enums

Enums
`KEEP_EXISTING_LINKS`	Si un ou plusieurs liens existent déjà entre un joueur et un personnage, ce qui entraînerait une violation du `RecallTokensCardinalityConstraint` spécifié en cas de création d'un lien, conservez ceux qui existent déjà. Par exemple, si Persona1-Player1 est déjà associé dans le champ d'application d'application1 et qu'un nouveau lien Persona1-Player2 est tenté d'être créé dans le champ d'application d'application1 avec une contrainte `MANY_PERSONAS_TO_ONE_PLAYER`, l'ancien lien restera et aucun nouveau lien ne sera ajouté. Notez que si les liens existants ne respectent pas la règle spécifiée (ce qui peut se produire si tous les appels `recall.linkPersona` n'utilisent pas le même `RecallTokensCardinalityConstraint`), cette règle ne résout pas le problème. Pour résoudre les conflits, utilisez la règle {@link `CREATE_NEW_LINK` pour réécrire les liens en vue de leur résolution.
`CREATE_NEW_LINK`	S'il existe déjà un lien entre un joueur et un personnage, ce qui entraînerait une violation du `RecallTokensCardinalityConstraint` spécifié en cas de création d'un lien, remplacez le ou les liens déjà existants par le nouveau. Par exemple, si Persona1-Player1 est déjà lié dans le champ d'application de application1 et qu'un nouveau lien Persona1-Player2 est tenté d'être créé dans le champ d'application d'application1 avec une contrainte `MANY_PERSONAS_TO_ONE_PLAYER`, l'ancien lien est supprimé et le nouveau est ajouté pour le remplacer.

KEEP_EXISTING_LINKS

Si un ou plusieurs liens existent déjà entre un joueur et un personnage, ce qui entraînerait une violation du RecallTokensCardinalityConstraint spécifié en cas de création d'un lien, conservez ceux qui existent déjà.

Par exemple, si Persona1-Player1 est déjà associé dans le champ d'application d'application1 et qu'un nouveau lien Persona1-Player2 est tenté d'être créé dans le champ d'application d'application1 avec une contrainte MANY_PERSONAS_TO_ONE_PLAYER, l'ancien lien restera et aucun nouveau lien ne sera ajouté.

Notez que si les liens existants ne respectent pas la règle spécifiée (ce qui peut se produire si tous les appels recall.linkPersona n'utilisent pas le même RecallTokensCardinalityConstraint), cette règle ne résout pas le problème. Pour résoudre les conflits, utilisez la règle {@link CREATE_NEW_LINK pour réécrire les liens en vue de leur résolution.

CREATE_NEW_LINK

S'il existe déjà un lien entre un joueur et un personnage, ce qui entraînerait une violation du RecallTokensCardinalityConstraint spécifié en cas de création d'un lien, remplacez le ou les liens déjà existants par le nouveau.

Par exemple, si Persona1-Player1 est déjà lié dans le champ d'application de application1 et qu'un nouveau lien Persona1-Player2 est tenté d'être créé dans le champ d'application d'application1 avec une contrainte MANY_PERSONAS_TO_ONE_PLAYER, l'ancien lien est supprimé et le nouveau est ajouté pour le remplacer.

État

État d'une tentative d'association d'un persona.

Enums
`LINK_CREATED`	L'association spécifiée dans la demande a été créée.
`PERSONA_OR_PLAYER_ALREADY_LINKED`	Le lien spécifié dans la demande n'a pas été créé, car des liens existants entraîneraient le non-respect des `RecallTokensCardinalityConstraint` spécifiés s'ils étaient créés.