此页面由 Cloud Translation API 翻译。

Method: recall.linkPersona

HTTP 请求
请求正文
- JSON 表示法
响应正文
- JSON 表示法
授权范围
RecallTokensCardinalityConstraint
ConflictingLinksResolutionPolicy
状态
试试看！

将提供的 Recall 会话 ID 中编码的 PGS 玩家主账号与游戏内账号相关联

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` 必需。要创建的令牌的值。对 Play 游戏不透明，并被假定为非稳定（通过密钥轮替加密）。
`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`	游戏内角色与 Play 游戏服务玩家之间的 1:1 基数。在关联操作结束时，玩家仅有一个条目，而角色应保留在应用的范围内。在指定此限制条件时，是否创建新链接由所选的 `ConflictingLinksResolutionPolicy` 决定：如果指定了 `KEEP_EXISTING_LINKS` 且所提供的角色已与其他玩家关联，或者该玩家已与其他角色关联，系统不会创建任何新关联，而现有关联将保持不变。如果指定了 `CREATE_NEW_LINK` 且所提供的角色已与其他玩家关联，或者该玩家已与其他角色关联，系统将移除旧链接，取而代之的是创建新链接。

ONE_PERSONA_TO_ONE_PLAYER

游戏内角色与 Play 游戏服务玩家之间的 1:1 基数。

在关联操作结束时，玩家仅有一个条目，而角色应保留在应用的范围内。

在指定此限制条件时，是否创建新链接由所选的 ConflictingLinksResolutionPolicy 决定：

如果指定了 KEEP_EXISTING_LINKS 且所提供的角色已与其他玩家关联，或者该玩家已与其他角色关联，系统不会创建任何新关联，而现有关联将保持不变。
如果指定了 CREATE_NEW_LINK 且所提供的角色已与其他玩家关联，或者该玩家已与其他角色关联，系统将移除旧链接，取而代之的是创建新链接。

ConflictingLinksResolutionPolicy

当角色与玩家关联会导致违反指定基数限制条件时，系统会应用的解决方案政策。

枚举

枚举
`KEEP_EXISTING_LINKS`	如果玩家与角色之间存在关联，因为创建新关联会导致违反指定的`RecallTokensCardinalityConstraint`，请保留现有关联。例如，如果 Persona1-Player1 已在 application1 的范围内建立关联，而系统尝试在 application1 的范围内创建新关联 Persona1-Player2，并应用 `MANY_PERSONAS_TO_ONE_PLAYER` 限制，则旧关联将会保留，并且不会添加新链接。请注意，如果现有链接确实违反了指定的政策（如果并非所有 `recall.linkPersona` 调用都使用相同的 `RecallTokensCardinalityConstraint`，就可能会发生这种情况），此政策不会解决这些违规问题；为了解决冲突，您需要使用 {@link `CREATE_NEW_LINK` 政策来重写解决冲突的链接。
`CREATE_NEW_LINK`	如果玩家与角色之间存在现有关联，这会导致在创建新关联时违反指定的`RecallTokensCardinalityConstraint`，请使用新关联替换现有关联。例如，如果 Persona1-Player1 已在 application1 的范围内建立关联，而系统尝试在 application1 的范围内创建新关联 Persona1-Player2，并应用 `MANY_PERSONAS_TO_ONE_PLAYER` 限制，则系统会移除旧链接并添加新链接来代替它。

KEEP_EXISTING_LINKS

如果玩家与角色之间存在关联，因为创建新关联会导致违反指定的RecallTokensCardinalityConstraint，请保留现有关联。

例如，如果 Persona1-Player1 已在 application1 的范围内建立关联，而系统尝试在 application1 的范围内创建新关联 Persona1-Player2，并应用 MANY_PERSONAS_TO_ONE_PLAYER 限制，则旧关联将会保留，并且不会添加新链接。

请注意，如果现有链接确实违反了指定的政策（如果并非所有 recall.linkPersona 调用都使用相同的 RecallTokensCardinalityConstraint，就可能会发生这种情况），此政策不会解决这些违规问题；为了解决冲突，您需要使用 {@link CREATE_NEW_LINK 政策来重写解决冲突的链接。

CREATE_NEW_LINK

如果玩家与角色之间存在现有关联，这会导致在创建新关联时违反指定的RecallTokensCardinalityConstraint，请使用新关联替换现有关联。

例如，如果 Persona1-Player1 已在 application1 的范围内建立关联，而系统尝试在 application1 的范围内创建新关联 Persona1-Player2，并应用 MANY_PERSONAS_TO_ONE_PLAYER 限制，则系统会移除旧链接并添加新链接来代替它。

状态

角色关联尝试的状态。

枚举
`LINK_CREATED`	请求中指定的链接已创建。
`PERSONA_OR_PLAYER_ALREADY_LINKED`	该请求中指定的链接未创建，因为现有链接如果创建，会导致新链接违反指定的 `RecallTokensCardinalityConstraint`。