- Requête HTTP
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- RecallTokensCardinalityConstraint
- ConflictingLinksResolutionPolicy
- État
- Essayer
Associez 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 lecteur PGS, l'utilisateur Google et l'application. |
persona |
Obligatoire. Identifiant stable du compte de jeu. Évitez d'utiliser le même persona pour différents jeux. |
token |
Obligatoire. Valeur du jeton à créer. Opaque à Play Jeux et considéré comme instable (chiffré avec rotation des clés). |
cardinalityConstraint |
Obligatoire. Contrainte de cardinalité à observer lors de l'association d'un persona à 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 (Time To Live) facultatif du jeton. expiration ne peut être qu'un des éléments suivants : |
|
expireTime |
Uniquement en entrée. Délai d'expiration facultatif. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. 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
Le résultat d’une tentative d’association d’un 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 de 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 lors de l'association d'un persona à un joueur dans le cadre d'un jeu.
Enums | |
---|---|
ONE_PERSONA_TO_ONE_PLAYER |
Cardinalité 1:1 entre les personas de jeu et les joueurs des services de jeux Play. À la fin de l'opération d'association, il ne doit rester qu'une seule entrée pour le joueur et le persona dans le champ d'application de l'application. La création ou non d'une association lorsque cette contrainte est spécifiée est déterminé 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 le non-respect des Par exemple, si "Persona1-Player1" est déjà associé dans le champ d'application de "application1" et qu'un nouveau lien "Persona1-Player2" tente d'être créé dans le champ d'application de "application1", l'ancien lien est conservé et aucun nouveau lien n'est ajouté. Notez que si les liens déjà existants enfreignent 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 persona, ce qui entraînerait le non-respect des Par exemple, si "Persona1-Player1" est déjà associé dans le champ d'application de "application1" et qu'un nouveau lien "Persona1-Player2" tente d'être créé dans le champ d'application de "application1", l'ancien lien sera supprimé et le nouveau lien sera ajouté pour le remplacer. |
État
État d'une tentative d'association de persona.
Enums | |
---|---|
LINK_CREATED |
L'association spécifiée dans la demande a été créée. |
PERSONA_OR_PLAYER_ALREADY_LINKED |
L'association spécifiée dans la demande n'a pas été créée, car toute association existante entraînerait que le nouveau lien ne respecte pas les RecallTokensCardinalityConstraint spécifiés s'il est créé. |