- Requête HTTP
- Corps de la requête
- Corps de la réponse
- 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 |
---|
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum ( |
Champs | |
---|---|
sessionId |
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 |
Obligatoire. Identifiant stable du compte de jeu. Merci de ne pas réutiliser le même personnage pour d'autres jeux. |
token |
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 |
Obligatoire. Contrainte de cardinalité à observer lorsque vous associez un personnage à un joueur dans le cadre d'un jeu. |
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 |
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: |
ttl |
Uniquement en entrée. Valeur TTL facultative. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
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 ( |
Champs | |
---|---|
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 | |
---|---|
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
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 | |
---|---|
KEEP_EXISTING_LINKS |
Si un ou plusieurs liens existent déjà entre un joueur et un personnage, ce qui entraînerait une violation du 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 Notez que si les liens existants ne respectent pas la règle spécifiée (ce qui peut se produire si tous les appels |
CREATE_NEW_LINK |
S'il existe déjà un lien entre un joueur et un personnage, ce qui entraînerait une violation du 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 |
É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. |