Эта страница переведена с помощью Cloud Translation API.

Method: recall.linkPersona

HTTP-запрос
Тело запроса
- JSON-представление
Тело ответа
- JSON-представление
Области авторизации
RecallTokensCardinalityConstraint
Политика разрешения конфликтов
Состояние
Попробуй это!

Свяжите участника PGS Player, закодированного в предоставленном идентификаторе сеанса отзыва, с внутриигровой учетной записью.

HTTP-запрос

POST https://games.googleapis.com/games/v1/recall:linkPersona

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление

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

Поля
`sessionId`	`string` Необходимый. Непрозрачная строка, сгенерированная сервером, которая кодирует всю необходимую информацию для идентификации проигрывателя PGS/пользователя и приложения Google.
`persona`	`string` Необходимый. Стабильный идентификатор внутриигрового аккаунта. Пожалуйста, воздержитесь от повторного использования одного и того же персонажа в разных играх.
`token`	`string` Необходимый. Значение создаваемого токена. Непрозрачен для игр и считается нестабильным (зашифрован с помощью ротации ключей).
`cardinalityConstraint`	`enum ( RecallTokensCardinalityConstraint )` Необходимый. Ограничение мощности, которое необходимо соблюдать при связывании персонажа с игроком в рамках игры.
`conflictingLinksResolutionPolicy`	`enum ( ConflictingLinksResolutionPolicy )` Необходимый. Политика разрешения, применяемая, когда привязка персонажа к игроку приведет к нарушению указанного ограничения количества элементов.
`expiration` поля объединения . Необязательное время истечения срока действия токена или время жизни. `expiration` может быть только одним из следующих:
`expireTime`	`string ( Timestamp format)` Только ввод. Необязательный срок действия. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: `"2014-10-02T15:01:23Z"` и `"2014-10-02T15:01:23.045123456Z"` .
`ttl`	`string ( Duration format)` Только ввод. Необязательное время жизни. Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « `s` ». Пример: `"3.5s"` .

Тело ответа

Результат попытки установления связи между персонажами.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{ "state": enum (`State`) }

Поля

Поля
`state`	`enum ( State )` Только вывод. Состояние попытки связывания персоны.

state

enum ( State )

Только вывод. Состояние попытки связывания персоны.

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

RecallTokensCardinalityConstraint

Ограничение мощности, которое необходимо соблюдать при связывании персонажа с игроком в рамках игры.

Перечисления

Перечисления
`ONE_PERSONA_TO_ONE_PLAYER`	Кардинальность 1:1 между персонажами в игре и игроками игровых сервисов Play. К концу операции связывания в области приложения должна остаться только одна запись об игроке и персоне. Будет ли создана новая ссылка или нет при указании этого ограничения, определяется выбранным `ConflictingLinksResolutionPolicy` : Если указан `KEEP_EXISTING_LINKS` и предоставленный персонаж уже связан с другим игроком или игрок уже связан с другим персонажем, новая ссылка не будет создана, а уже существующие ссылки останутся такими, какие есть. Если указан `CREATE_NEW_LINK` и предоставленный персонаж уже связан с другим игроком или игрок уже связан с другим персонажем, старые ссылки будут удалены в пользу создаваемой новой ссылки.

ONE_PERSONA_TO_ONE_PLAYER

Кардинальность 1:1 между персонажами в игре и игроками игровых сервисов Play.

К концу операции связывания в области приложения должна остаться только одна запись об игроке и персоне.

Будет ли создана новая ссылка или нет при указании этого ограничения, определяется выбранным ConflictingLinksResolutionPolicy :

Если указан KEEP_EXISTING_LINKS и предоставленный персонаж уже связан с другим игроком или игрок уже связан с другим персонажем, новая ссылка не будет создана, а уже существующие ссылки останутся такими, какие есть.
Если указан CREATE_NEW_LINK и предоставленный персонаж уже связан с другим игроком или игрок уже связан с другим персонажем, старые ссылки будут удалены в пользу создаваемой новой ссылки.

Политика разрешения конфликтов

Политика разрешения, применяемая, когда привязка персонажа к игроку приведет к нарушению указанного ограничения количества элементов.

Перечисления

Перечисления
`KEEP_EXISTING_LINKS`	Если связь(и) между игроком и персонажем уже существует, что может привести к нарушению указанного `RecallTokensCardinalityConstraint` , если бы была создана новая ссылка, сохраните уже существующие ссылки. Например, если Persona1-Player1 уже связана в области приложения1 и будет предпринята попытка создать новую ссылку Persona1-Player2 в области приложения1 с ограничением `MANY_PERSONAS_TO_ONE_PLAYER` , то старая ссылка останется, а новая ссылка не будет добавлена. Обратите внимание: если уже существующие ссылки нарушают указанную политику (что может произойти, если не все вызовы `recall.linkPersona` используют один и тот же `RecallTokensCardinalityConstraint` ), эта политика оставит эти нарушения неразрешенными; Для разрешения конфликтов необходимо использовать политику {@link `CREATE_NEW_LINK` для перезаписи ссылок, разрешающих конфликты.
`CREATE_NEW_LINK`	Если существующая связь между игроком и персонажем уже существует, что приведет к нарушению указанного `RecallTokensCardinalityConstraint` , если была создана новая ссылка, замените уже существующие ссылки новой ссылкой. Например, если Persona1-Player1 уже связана в области приложения1, и в области приложения1 будет предпринята попытка создать новую ссылку Persona1-Player2 с ограничением `MANY_PERSONAS_TO_ONE_PLAYER` , то старая ссылка будет удалена и будет добавлена новая ссылка. чтобы заменить его.

KEEP_EXISTING_LINKS

Если связь(и) между игроком и персонажем уже существует, что может привести к нарушению указанного RecallTokensCardinalityConstraint , если бы была создана новая ссылка, сохраните уже существующие ссылки.

Например, если Persona1-Player1 уже связана в области приложения1 и будет предпринята попытка создать новую ссылку Persona1-Player2 в области приложения1 с ограничением MANY_PERSONAS_TO_ONE_PLAYER , то старая ссылка останется, а новая ссылка не будет добавлена.

Обратите внимание: если уже существующие ссылки нарушают указанную политику (что может произойти, если не все вызовы recall.linkPersona используют один и тот же RecallTokensCardinalityConstraint ), эта политика оставит эти нарушения неразрешенными; Для разрешения конфликтов необходимо использовать политику {@link CREATE_NEW_LINK для перезаписи ссылок, разрешающих конфликты.

CREATE_NEW_LINK

Если существующая связь между игроком и персонажем уже существует, что приведет к нарушению указанного RecallTokensCardinalityConstraint , если была создана новая ссылка, замените уже существующие ссылки новой ссылкой.

Например, если Persona1-Player1 уже связана в области приложения1, и в области приложения1 будет предпринята попытка создать новую ссылку Persona1-Player2 с ограничением MANY_PERSONAS_TO_ONE_PLAYER , то старая ссылка будет удалена и будет добавлена новая ссылка. чтобы заменить его.

Состояние

Состояние попытки связывания персоны.

Перечисления
`LINK_CREATED`	Ссылка, указанная в запросе, создана.
`PERSONA_OR_PLAYER_ALREADY_LINKED`	Ссылка, указанная в запросе, не была создана, поскольку уже существующие ссылки приведут к тому, что новая ссылка нарушит указанный `RecallTokensCardinalityConstraint` , если она будет создана.