將所提供召回工作階段 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 遊戲服務玩家的一對一基數。 連結作業結束時,玩家只需一個項目,人物角色應保持在應用程式的範圍內。 指定這項限制時,是否要建立新連結 (由所選
|
ConflictingLinksResolutionPolicy
將人物角色連結至玩家會導致違反指定基數限制時要套用的解決方案政策。
列舉 | |
---|---|
KEEP_EXISTING_LINKS |
如果玩家和人物角色之間已有連結,導致在建立新連結後違反指定的 例如,如果 application1 的範圍內已連結 Persona1-Player1,且嘗試在 application1 的範圍內建立新連結 Persona1-Player2,則系統會保留舊連結,不會新增新連結。 請注意,如果現有連結確實違反指定政策 (如果所有 |
CREATE_NEW_LINK |
如果玩家和人物角色已存在,且在建立新連結後會導致違反指定的 例如,如果 application1 的範圍內已連結 Persona1-Player1,且嘗試在 application1 的範圍內建立新連結 Persona1-Player2,則系統將移除舊連結,並新增新連結來取代該連結。 |
州
人物角色連結嘗試的狀態。
列舉 | |
---|---|
LINK_CREATED |
要求中指定的連結已建立。 |
PERSONA_OR_PLAYER_ALREADY_LINKED |
要求中指定的連結無法建立,因為已有連結會導致新連結違反指定的RecallTokensCardinalityConstraint (如有建立連結)。 |