將提供的召回工作階段 ID 中編碼的 PGS 玩家主體與遊戲內帳戶建立關聯
HTTP 要求
POST https://games.googleapis.com/games/v1/recall:linkPersona
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum ( |
欄位 | |
---|---|
sessionId |
必要欄位。這個由伺服器產生的不透明字串,會將所有必要資訊編碼,以利識別 PGS 播放器 / Google 使用者和應用程式。 |
persona |
必要欄位。遊戲內帳戶的穩定 ID。請勿在不同遊戲中重複使用相同的人物角色。 |
token |
必要欄位。要建立權杖的值。無法與 Play 遊戲同步,且假設為不穩定 (以金鑰輪替方式加密)。 |
cardinalityConstraint |
必要欄位。將人物角色連結至遊戲範圍內的玩家時,要觀察的基數限制。 |
conflictingLinksResolutionPolicy |
必要欄位。將人物角色連結至玩家時會違反指定的基數限制時,要套用的解決政策。 |
聯集欄位 expiration 。選用的權杖到期時間或存留時間。expiration 只能是下列其中一項: |
|
expireTime |
僅限輸入。(選填) 到期時間。 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
ttl |
僅限輸入。選用存留時間。 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
回應主體
人物角色連結嘗試結果。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"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 |
如果玩家和人物角色之間已有連結,因而導致違反指定的 舉例來說,假設 Persona1-Player1 已在 application1 的範圍中連結,而嘗試在 application1 的範圍內建立新的連結 Persona1-Player2,系統會保留舊連結,不會加入新連結。 請注意,如果現有連結違反指定的政策 (當並非所有 |
CREATE_NEW_LINK |
如果玩家和人物角色之間已存在,因而導致違反指定的 舉例來說,假設 Persona1-Player1 已在 application1 的範圍中建立連結,而且嘗試在應用程式 1 範圍中以 |
狀態
人物角色連結嘗試的狀態。
列舉 | |
---|---|
LINK_CREATED |
已建立要求中指定的連結。 |
PERSONA_OR_PLAYER_ALREADY_LINKED |
要求中指定的連結尚未建立,因為已存在現有的連結會導致新連結違反指定的 RecallTokensCardinalityConstraint (如已建立)。 |