- Solicitud HTTP
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- RecallTokensCardinalityConstraint
- ConflictingLinksResolutionPolicy
- Estado
- Pruébala
Asocia el principal del reproductor de los PGS codificado en el ID de sesión de recuperación proporcionado con una cuenta en el juego
Solicitud HTTP
POST https://games.googleapis.com/games/v1/recall:linkPersona
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum ( |
Campos | |
---|---|
sessionId |
Obligatorio. Es una cadena opaca generada por el servidor que codifica toda la información necesaria para identificar al reproductor de los PGS, al usuario de Google y a la aplicación. |
persona |
Obligatorio. Es el identificador estable de la cuenta en el juego. No vuelvas a utilizar el mismo arquetipo para diferentes juegos. |
token |
Obligatorio. Valor del token que se creará. Opaca a Play Juegos y se supone que no es estable (encriptada con rotación de claves). |
cardinalityConstraint |
Obligatorio. Restricción de cardinalidad que se debe observar cuando se vincula una persona con un jugador dentro del alcance de un juego. |
conflictingLinksResolutionPolicy |
Obligatorio. Política de resolución que se aplica cuando la vinculación de un arquetipo con un jugador provocaría una infracción de la restricción de cardinalidad especificada. |
Campo de unión expiration . Tiempo de actividad o tiempo de vencimiento del token opcional. Las direcciones (expiration ) solo pueden ser una de las siguientes opciones: |
|
expireTime |
Solo entrada. Hora de vencimiento opcional. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
ttl |
Solo entrada. Tiempo de actividad opcional. Es una duración en segundos con hasta nueve dígitos decimales que termina en " |
Cuerpo de la respuesta
Resultado de un intento de vinculación de personas.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"state": enum ( |
Campos | |
---|---|
state |
Solo salida. Estado de un intento de vinculación de personas |
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/androidpublisher
Para obtener más información, consulta la Descripción general de OAuth 2.0.
RecallTokensCardinalityConstraint
Restricción de cardinalidad que se debe observar cuando se vincula una persona con un jugador dentro del alcance de un juego.
Enumeradores | |
---|---|
ONE_PERSONA_TO_ONE_PLAYER |
Cardinalidad 1:1 entre los arquetipos del juego y los jugadores de los Servicios de juego de Play Al final de la operación de vinculación, solo una entrada para el jugador y el arquetipo debe permanecer dentro del alcance de la aplicación. Indica si se crea o no un vínculo nuevo cuando se especifica esta restricción con la
|
ConflictingLinksResolutionPolicy
Política de resolución que se aplica cuando la vinculación de un arquetipo con un jugador provocaría una infracción de la restricción de cardinalidad especificada.
Enumeradores | |
---|---|
KEEP_EXISTING_LINKS |
Si ya existen vínculos entre un jugador y un arquetipo, lo que implicaría una infracción de los Por ejemplo, si Persona1-Player1 ya está vinculado en el alcance de application1 y se intenta crear un nuevo vínculo Persona1-Player2 en el alcance de application1 con la restricción Ten en cuenta que si los vínculos existentes infringen la política especificada (lo que podría ocurrir si no todas las llamadas a |
CREATE_NEW_LINK |
Si ya existe un vínculo entre un jugador y un arquetipo, lo que generaría una infracción de la Por ejemplo, si Persona1-Player1 ya está vinculado en el alcance de application1 y se intenta crear un nuevo vínculo Persona1-Player2 en el alcance de application1 con la restricción |
Estado
Estado de un intento de vinculación de personas
Enumeradores | |
---|---|
LINK_CREATED |
Se creó el vínculo especificado en la solicitud. |
PERSONA_OR_PLAYER_ALREADY_LINKED |
El vínculo especificado en la solicitud no se creó debido a que, si se crea un vínculo existente, el vínculo nuevo infringiría el RecallTokensCardinalityConstraint especificado. |