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é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 (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 de los PGS, al usuario de Google y a la aplicación.
persona	string Obligatorio. Es el identificador estable de la cuenta en el juego. No vuelvas a utilizar el mismo arquetipo para diferentes juegos.
token	string 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	enum (RecallTokensCardinalityConstraint) Obligatorio. Restricción de cardinalidad que se debe observar cuando se vincula una persona con un jugador dentro del alcance de un juego.
conflictingLinksResolutionPolicy	enum (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	string (Timestamp format) 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: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
ttl	string (Duration format) Solo entrada. Tiempo de actividad opcional. Es una duración en segundos con hasta nueve dígitos decimales que termina en "s". Ejemplo: "3.5s".

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 (State) }

Campos
state	enum (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 elegida: Si se especifica KEEP_EXISTING_LINKS y el arquetipo proporcionado ya está vinculado a otro jugador, o el jugador ya está vinculado a otro arquetipo, no se creará ningún vínculo nuevo y los vínculos existentes permanecerán tal como están. Si se especifica el valor de CREATE_NEW_LINK y el arquetipo proporcionado ya está vinculado a otro jugador, o si el jugador ya está vinculado a otro arquetipo, se quitarán los vínculos anteriores para crear el nuevo vínculo.

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 RecallTokensCardinalityConstraint especificados en el caso de que se creen los vínculos nuevos, conserva los existentes. 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 MANY_PERSONAS_TO_ONE_PLAYER, permanecerá el vínculo anterior y no se agregará ningún vínculo nuevo. 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 recall.linkPersona usan el mismo RecallTokensCardinalityConstraint), esta política dejará sin resolver estos incumplimientos. Para resolver conflictos, se debe usar la política {@link CREATE_NEW_LINK para reescribir vínculos a fin de resolverlos.
CREATE_NEW_LINK	Si ya existe un vínculo entre un jugador y un arquetipo, lo que generaría una infracción de la RecallTokensCardinalityConstraint especificada en el caso de que se cree el nuevo vínculo, reemplaza los vínculos existentes por el nuevo. 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 MANY_PERSONAS_TO_ONE_PLAYER, se quitará el vínculo anterior y se agregará el nuevo para reemplazarlo.

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.