本頁面由 Cloud Translation API 翻譯而成。

Method: recall.linkPersona

HTTP 要求
要求主體
- JSON 表示法
回應主體
- JSON 表示法
授權範圍
RecallTokensCardinalityConstraint
ConflictingLinksResolutionPolicy
狀態
試試看！

將 PGS 玩家主體 (編碼自提供的召回工作階段 ID 中編碼) 與遊戲內帳戶相關聯

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` 必要欄位。遊戲內帳戶的穩定 ID。請避免在不同遊戲中重複使用相同的人物角色。
`token`	`string` 必要欄位。待建立權杖的值。Play 遊戲不透明且假設為不穩定 (已使用金鑰輪替加密)。
`cardinalityConstraint`	`enum (RecallTokensCardinalityConstraint)` 必要欄位。在遊戲範圍內將人物角色連結至玩家時，應觀察基數限制。
`conflictingLinksResolutionPolicy`	`enum (ConflictingLinksResolutionPolicy)` 必要欄位。將人物角色連結至玩家會導致違反指定基數限制時要套用的解決方案政策。
聯集欄位 `expiration`。選填的權杖到期時間或存留時間。`expiration` 只能是下列其中一項：
`expireTime`	`string (Timestamp format)` 僅限輸入。選填的到期時間。 RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例：`"2014-10-02T15:01:23Z"` 和 `"2014-10-02T15:01:23.045123456Z"`。
`ttl`	`string (Duration format)` 僅限輸入。(選填) 存留時間。持續時間以秒為單位，最多 9 個小數位數，結尾為「`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 遊戲服務玩家的一對一基數。連結作業結束時，玩家只需一個項目，人物角色應保持在應用程式的範圍內。指定這項限制時，是否要建立新連結 (由所選 `ConflictingLinksResolutionPolicy` 決定)：如果指定 `KEEP_EXISTING_LINKS` 且提供的人物角色已連結至其他玩家，或是玩家已連結至不同的人物角色，則系統不會建立新連結，現有的連結則會保持原樣。如果指定 `CREATE_NEW_LINK` 且提供的人物角色已連結至其他玩家，或是玩家已連結至另一個玩家，系統會移除舊連結，改為建立新連結。

ONE_PERSONA_TO_ONE_PLAYER

遊戲內人物角色和 Play 遊戲服務玩家的一對一基數。

連結作業結束時，玩家只需一個項目，人物角色應保持在應用程式的範圍內。

指定這項限制時，是否要建立新連結 (由所選 ConflictingLinksResolutionPolicy 決定)：

如果指定 KEEP_EXISTING_LINKS 且提供的人物角色已連結至其他玩家，或是玩家已連結至不同的人物角色，則系統不會建立新連結，現有的連結則會保持原樣。
如果指定 CREATE_NEW_LINK 且提供的人物角色已連結至其他玩家，或是玩家已連結至另一個玩家，系統會移除舊連結，改為建立新連結。

ConflictingLinksResolutionPolicy

將人物角色連結至玩家會導致違反指定基數限制時要套用的解決方案政策。

列舉

列舉
`KEEP_EXISTING_LINKS`	如果玩家和人物角色之間已有連結，導致在建立新連結後違反指定的`RecallTokensCardinalityConstraint`，請保留現有連結。例如，如果 application1 的範圍內已連結 Persona1-Player1，且嘗試在 application1 的範圍內建立新連結 Persona1-Player2，則系統會保留舊連結，不會新增新連結。請注意，如果現有連結確實違反指定政策 (如果所有 `recall.linkPersona` 呼叫均使用同一個 `RecallTokensCardinalityConstraint`，政策就會發生這種情況)，這項政策會使這些違規問題未解決。為解決衝突，您必須使用{@link `CREATE_NEW_LINK` 政策來重新編寫連結，解決衝突。
`CREATE_NEW_LINK`	如果玩家和人物角色已存在，且在建立新連結後會導致違反指定的`RecallTokensCardinalityConstraint`，請使用新的連結取代現有的連結。例如，如果 application1 的範圍內已連結 Persona1-Player1，且嘗試在 application1 的範圍內建立新連結 Persona1-Player2，則系統將移除舊連結，並新增新連結來取代該連結。

KEEP_EXISTING_LINKS

如果玩家和人物角色之間已有連結，導致在建立新連結後違反指定的RecallTokensCardinalityConstraint，請保留現有連結。

例如，如果 application1 的範圍內已連結 Persona1-Player1，且嘗試在 application1 的範圍內建立新連結 Persona1-Player2，則系統會保留舊連結，不會新增新連結。

請注意，如果現有連結確實違反指定政策 (如果所有 recall.linkPersona 呼叫均使用同一個 RecallTokensCardinalityConstraint，政策就會發生這種情況)，這項政策會使這些違規問題未解決。為解決衝突，您必須使用{@link CREATE_NEW_LINK 政策來重新編寫連結，解決衝突。

CREATE_NEW_LINK

如果玩家和人物角色已存在，且在建立新連結後會導致違反指定的RecallTokensCardinalityConstraint，請使用新的連結取代現有的連結。

例如，如果 application1 的範圍內已連結 Persona1-Player1，且嘗試在 application1 的範圍內建立新連結 Persona1-Player2，則系統將移除舊連結，並新增新連結來取代該連結。

州

人物角色連結嘗試的狀態。

列舉
`LINK_CREATED`	要求中指定的連結已建立。
`PERSONA_OR_PLAYER_ALREADY_LINKED`	要求中指定的連結無法建立，因為已有連結會導致新連結違反指定的`RecallTokensCardinalityConstraint` (如有建立連結)。