Se usó la API de Cloud Translation para traducir esta página.

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 la principal del reproductor de los PGS codificada 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

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`. }

{
  "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. Cadena opaca generada por el servidor que codifica toda la información necesaria para identificar el reproductor de los PGS / el usuario y la aplicación de Google.
`persona`	`string` Obligatorio. Es el identificador estable de la cuenta en el juego. No reutilices la misma persona en diferentes juegos.
`token`	`string` Obligatorio. Valor del token que se creará. Opaco para Play Juegos y se supone que no es estable (encriptado con rotación de claves).
`cardinalityConstraint`	`enum (RecallTokensCardinalityConstraint)` Obligatorio. Restricción de cardinalidad para 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 debe aplicar cuando la vinculación de un arquetipo con un jugador daría como resultado un incumplimiento de la restricción de cardinalidad especificada
Campo de unión `expiration`. Hora de vencimiento del token o tiempo de actividad (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 una 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. Una duración en segundos con hasta nueve dígitos decimales, que terminan en “`s`”. Ejemplo: `"3.5s"`.

Cuerpo de la respuesta

El 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

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

state

enum (State)

Solo salida. Estado de un intento de vinculación de personas.

Alcances 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 para observar cuando se vincula una persona con un jugador dentro del alcance de un juego.

Enumeraciones

Enumeraciones
`ONE_PERSONA_TO_ONE_PLAYER`	Cardinalidad 1:1 entre los arquetipos 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 la persona debe permanecer dentro del alcance de la aplicación. Si se crea o no un vínculo nuevo cuando se especifica esta restricción, lo determina el `ConflictingLinksResolutionPolicy` elegido: Si se especifica `KEEP_EXISTING_LINKS` y el arquetipo proporcionado ya está vinculado a otro jugador, o si el jugador ya está vinculado a un arquetipo diferente, no se creará un vínculo nuevo y los vínculos existentes permanecerán tal como están. Si se especifica `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 y se reemplazarán por el nuevo vínculo que se creará.

ONE_PERSONA_TO_ONE_PLAYER

Cardinalidad 1:1 entre los arquetipos 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 la persona debe permanecer dentro del alcance de la aplicación.

Si se crea o no un vínculo nuevo cuando se especifica esta restricción, lo determina el ConflictingLinksResolutionPolicy elegido:

Si se especifica KEEP_EXISTING_LINKS y el arquetipo proporcionado ya está vinculado a otro jugador, o si el jugador ya está vinculado a un arquetipo diferente, no se creará un vínculo nuevo y los vínculos existentes permanecerán tal como están.
Si se especifica 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 y se reemplazarán por el nuevo vínculo que se creará.

ConflictingLinksResolutionPolicy

Política de resolución que se debe aplicar cuando la vinculación de un arquetipo con un jugador daría como resultado un incumplimiento de la restricción de cardinalidad especificada

Enumeraciones

Enumeraciones
`KEEP_EXISTING_LINKS`	Si ya existen vínculos entre un jugador y un arquetipo, lo que daría como resultado un incumplimiento de la `RecallTokensCardinalityConstraint` especificada si se crea el nuevo vínculo, 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 dentro del alcance de application1, el vínculo anterior permanecerá y no se agregará ningún vínculo 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 dejará sin resolver estos incumplimientos. Para resolver conflictos, se debe usar la política {@link `CREATE_NEW_LINK` con el objetivo de reescribir los vínculos que resuelven conflictos.
`CREATE_NEW_LINK`	Si ya existe un vínculo entre un jugador y un arquetipo, lo que daría como resultado un incumplimiento del `RecallTokensCardinalityConstraint` especificado si se creó el vínculo nuevo, 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, se quitará el vínculo anterior y se agregará el nuevo para reemplazarlo.

KEEP_EXISTING_LINKS

Si ya existen vínculos entre un jugador y un arquetipo, lo que daría como resultado un incumplimiento de la RecallTokensCardinalityConstraint especificada si se crea el nuevo vínculo, 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 dentro del alcance de application1, el vínculo anterior permanecerá y no se agregará ningún vínculo 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 dejará sin resolver estos incumplimientos. Para resolver conflictos, se debe usar la política {@link CREATE_NEW_LINK con el objetivo de reescribir los vínculos que resuelven conflictos.

CREATE_NEW_LINK

Si ya existe un vínculo entre un jugador y un arquetipo, lo que daría como resultado un incumplimiento del RecallTokensCardinalityConstraint especificado si se creó el vínculo nuevo, 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, se quitará el vínculo anterior y se agregará el nuevo para reemplazarlo.

Estado

Estado de un intento de vinculación de personas.

Enumeraciones
`LINK_CREATED`	Se creó la vinculación especificada en la solicitud.
`PERSONA_OR_PLAYER_ALREADY_LINKED`	No se creó el vínculo especificado en la solicitud porque los vínculos existentes harían que el nuevo incumpliría la `RecallTokensCardinalityConstraint` especificada si se crea.