Method: recall.linkPersona

• Solicitud HTTP
• Cuerpo de la solicitud
  • Representación JSON
• Cuerpo de la respuesta
  • Representación JSON
• Permisos de autorización
• RecallTokensCardinalityConstraint
• ConflictingLinksResolutionPolicy
• Estado
• Pruébalo

Asocia el principal de jugador 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 (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. }

Campos
sessionId	string Obligatorio. Es una cadena opaca generada por el servidor que codifica toda la información necesaria para identificar al reproductor o usuario de los PGS y la aplicación de Google.
persona	string Obligatorio. Es el identificador estable de la cuenta en el juego. No vuelvas a usar el mismo arquetipo para diferentes juegos.
token	string Obligatorio. Es el valor del token que se creará. Es opaco para Play Juegos y se supone que no es estable (encriptado con rotación de claves).
cardinalityConstraint	enum (RecallTokensCardinalityConstraint) Obligatorio. Es una restricción de cardinalidad que se debe observar cuando se vincula un arquetipo a un jugador en el alcance de un juego.
conflictingLinksResolutionPolicy	enum (ConflictingLinksResolutionPolicy) Obligatorio. Es la política de resolución que se aplica cuando la vinculación de un arquetipo a un jugador implicaría incumplir la restricción de cardinalidad especificada.
Campo de unión expiration. Es el tiempo de vencimiento o de actividad del token opcional. expiration solo admite los siguientes valores:
expireTime	string (Timestamp format) Solo entrada. Hora de vencimiento opcional. Es una marca de tiempo en formato RFC3339 UTC "Zulú", con una resolución de nanosegundos y hasta nueve dígitos decimales. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
ttl	string (Duration format) Solo entrada. Tiempo de actividad opcional. Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

Cuerpo de la respuesta

Resultado de un intento de vinculación de arquetipo.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{ "state": enum (State) }

Campos
state	enum (State) Solo salida. Estado de un intento de vinculación de arquetipo.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta la descripción general de OAuth 2.0.

RecallTokensCardinalityConstraint

Es una restricción de cardinalidad que se debe observar cuando se vincula un arquetipo a un jugador en el alcance de un juego.

Enums

ONE_PERSONA_TO_ONE_PLAYER

Cardinalidad de 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 debe quedar una entrada para el jugador y el arquetipo en el alcance de la aplicación. El ConflictingLinksResolutionPolicy elegido determina si se crea un vínculo nuevo o no cuando se especifica esta restricción: Si se especifica KEEP_EXISTING_LINKS y el arquetipo proporcionado ya está vinculado a un jugador diferente, o si el jugador ya está vinculado a un arquetipo diferente, no se creará ningún vínculo nuevo y los vínculos existentes permanecerán como están. Si se especifica CREATE_NEW_LINK y el arquetipo proporcionado ya está vinculado a un jugador diferente, o si el jugador ya está vinculado a otro arquetipo, se quitarán los vínculos anteriores y se creará el nuevo.

ConflictingLinksResolutionPolicy

Es la política de resolución que se aplica cuando la vinculación de un arquetipo a un jugador implicaría incumplir la restricción de cardinalidad especificada.

Enums
KEEP_EXISTING_LINKS	Si ya existen vínculos entre un jugador y un arquetipo que incumplieran el RecallTokensCardinalityConstraint especificado si se creara el vínculo nuevo, mantén los vínculos existentes. Por ejemplo, si Persona1-Jugador1 ya está vinculado en el alcance de aplicación1 y se intenta crear un nuevo vínculo Persona1-Jugador2 en el alcance de aplicación1, el vínculo anterior permanecerá y no se agregará uno nuevo. Ten en cuenta que, si los vínculos existentes incumplen la política especificada (lo que podría ocurrir si no todas las llamadas a recall.linkPersona usan el mismo RecallTokensCardinalityConstraint), esta política no resolverá estos incumplimientos. Para resolver los conflictos, se debe usar la {@link política CREATE_NEW_LINK para reescribir los vínculos que resuelven los conflictos.
CREATE_NEW_LINK	Si ya existe un vínculo entre un jugador y un arquetipo que infringiría el RecallTokensCardinalityConstraint especificado si se creara el vínculo nuevo, reemplaza los vínculos existentes por el nuevo. Por ejemplo, si Persona1-Jugador1 ya está vinculado en el alcance de aplicación1 y se intenta crear un nuevo vínculo Persona1-Jugador2 en el alcance de aplicación1, se quitará el vínculo anterior y se agregará el nuevo para reemplazarlo.

State

Estado de un intento de vinculación de arquetipo.

Enums
LINK_CREATED	Se creó el vínculo especificado en la solicitud.
PERSONA_OR_PLAYER_ALREADY_LINKED	No se creó el vínculo especificado en la solicitud porque, si se creara, los vínculos existentes harían que el vínculo nuevo incumpliera el RecallTokensCardinalityConstraint especificado.