Method: recall.retrieveTokens

在提供的喚回工作階段 ID 中，擷取與 PGS 播放器主體相關聯的所有喚回符記。只有具備有效 Play 遊戲服務設定檔的使用者才能使用這個 API。

HTTP 要求

GET https://games.googleapis.com/games/v1/recall/tokens/{sessionId}

路徑參數

參數
sessionId

string

必要欄位。這個由伺服器產生的不透明字串，會將所有必要資訊編碼，以利識別 PGS 播放器 / Google 使用者和應用程式。

要求主體

要求主體必須為空白。

回應主體

喚回度.retrieveTokens RPC 的回應

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "tokens": [
    {
      object (RecallToken)
    }
  ]
}
欄位
tokens[]

object (RecallToken)

必要欄位。與要求的 PGS 播放器主體相關聯的召回權杖

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

RecallToken

召回喚回符記 (RPC) 傳回的權杖資料

JSON 表示法 
{
  "token": string,
  "multiPlayerPersona": boolean,
  "expireTime": string
}
欄位
token

string

必要欄位。喚回符記的值，因為用戶端透過 remember.linkPersona RPC 提供
multiPlayerPersona

boolean

必要欄位。符記識別的人物角色是否連結至多個 Play 遊戲服務玩家
expireTime

string (Timestamp format)

選用設定。權杖的到期時間 (選填)

RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。