Method: recall.retrieveTokens

检索与提供的 Recall 会话 ID 中编码的 PGS 玩家主账号关联的所有 Recall 令牌。只有拥有有效的 PGS 玩家资料的用户才能使用此 API。

HTTP 请求

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

路径参数

参数
sessionId

string

必需。不透明的服务器生成的字符串，可对标识 PGS 玩家 / Google 用户和应用的所有必要信息进行编码。

请求正文

请求正文必须为空。

响应正文

对 Recall.retrieveTokens RPC 的响应

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "tokens": [
    {
      object (RecallToken)
    }
  ]
}
字段
tokens[]

object (RecallToken)

必需。与所请求的 PGS 玩家主账号关联的找回令牌

授权范围

需要以下 OAuth 作用域：

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

有关详情，请参阅 OAuth 2.0 概览。

RecallToken

从 Recall.retrieveTokens RPC 返回的 Recall 令牌数据

JSON 表示法 
{
  "token": string,
  "multiPlayerPersona": boolean,
  "expireTime": string
}
字段
token

string

必需。Recall 令牌的值，因为它由客户端通过 Recall.linkPersona RPC 提供
multiPlayerPersona

boolean

必需。令牌标识的角色是否已与多个 PGS 玩家相关联
expireTime

string (Timestamp format)

可选。令牌的可选到期时间

时间戳，采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。