Google Play Game Services

借助 Google Play 游戏服务，开发者可以通过社交排行榜、成就、游戏状态、使用 Google 账号登录等功能来增强游戏的吸引力。

服务：games.googleapis.com

如要调用此服务，我们建议您使用 Google 提供的客户端库。如果您的应用需要使用您自己的库来调用此服务，则在发出 API 请求时应使用以下信息。

发现文档

发现文档是用于描述和使用 REST API 的机器可读规范。它用于构建客户端库、IDE 插件以及与 Google API 交互的其他工具。一项服务可能会提供多个发现文档。此服务提供了以下发现文档：

服务端点

服务端点是一个基础网址，指定了 API 服务的网络地址。一项服务可能有多个服务端点。此服务具有以下服务端点，下面的所有 URI 都是此服务端点的相对路径：

  • https://games.googleapis.com

REST 资源：accesstokens

方法
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
为附加凭据标识的 PGS 用户生成 Play Grouping API 令牌。
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
为请求中提供的 Recall 会话 ID 标识的 PGS 用户生成 Play Grouping API 令牌。

REST 资源：achievementDefinitions

方法
list GET /games/v1/achievements
列出应用的所有成就定义。

REST 资源：achievements

方法
increment POST /games/v1/achievements/{achievementId}/increment
为当前已通过身份验证的玩家递增具有指定 ID 的成就的步数。
list GET /games/v1/players/{playerId}/achievements
列出当前已通过身份验证的玩家的所有应用成就的进度。
reveal POST /games/v1/achievements/{achievementId}/reveal
为当前已通过身份验证的玩家将具有指定 ID 的成就的状态设置为 REVEALED。
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
为当前已通过身份验证的玩家设置达成成就的步骤。
unlock POST /games/v1/achievements/{achievementId}/unlock
为当前已通过身份验证的玩家解锁此成就。
updateMultiple POST /games/v1/achievements/updateMultiple
更新当前已通过身份验证的玩家的多个成就。

REST 资源：applications

方法
get GET /games/v1/applications/{applicationId}
检索具有指定 ID 的应用的元数据。
getEndPoint POST /games/v1/applications/getEndPoint
返回所请求端点类型的网址。
played POST /games/v1/applications/played
表示当前已通过身份验证的用户正在玩您的应用。
verify GET /games/v1/applications/{applicationId}/verify
验证随此请求提供的身份验证令牌是否适用于具有指定 ID 的应用，并返回为其授予的玩家 ID。

REST 资源：events

方法
listByPlayer GET /games/v1/events
返回一个列表，其中显示当前已通过身份验证的用户在此应用中的事件的当前进度。
listDefinitions GET /games/v1/eventDefinitions
返回此应用中的事件定义列表。
record POST /games/v1/events
记录此应用当前已通过身份验证的用户发生事件的次数的批量更改。

REST 资源：排行榜

方法
get GET /games/v1/leaderboards/{leaderboardId}
检索具有指定 ID 的排行榜的元数据。
list GET /games/v1/leaderboards
列出应用的所有排行榜元数据。

REST 资源：metagame

方法
getMetagameConfig GET /games/v1/metagameConfig
返回调用应用的 metagame 配置数据。
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
列出与 playerId 对应的玩家按类别汇总的播放数据。

REST 资源：players

方法
get GET /games/v1/players/{playerId}
检索具有指定 ID 的玩家资源。
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
获取与调用应用具有相同开发者的所有请求游戏中当前已通过身份验证的玩家的应用玩家 ID。
getScopedPlayerIds GET /games/v1/players/me/scopedIds
检索当前已验证身份的用户的限定玩家标识符。
list GET /games/v1/players/me/players/{collection}
获取当前已通过身份验证的用户的玩家集合。

REST 资源：recall

方法
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
从所有请求的游戏中检索与提供的 Recall 会话 ID 中编码的 PGS 玩家关联的 Recall 令牌。
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
从与提供的 Recall 会话 ID 中编码的 PGS 玩家关联的所有开发者游戏中检索上一个 Recall 令牌。
linkPersona POST /games/v1/recall:linkPersona
将提供的 Recall 会话 ID 中编码的 PGS 玩家正文与游戏内账号相关联
resetPersona POST /games/v1/recall:resetPersona
删除将指定角色与任何玩家（无论是否有玩家资料）相关联的所有 Recall 令牌。
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
检索与提供的 Recall 会话 ID 中编码的 PGS 玩家关联的所有 Recall 令牌。
unlinkPersona POST /games/v1/recall:unlinkPersona
删除用于关联由 Recall 会话标识的 PGS 玩家正文与通过“角色”或令牌值标识的游戏内账号的 Recall 令牌。

REST 资源：revisions

方法
check GET /games/v1/revisions/check
检查游戏客户端是否已过时。

REST 资源：scores

方法
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
获取当前已通过身份验证的玩家在排行榜中的最高得分和排名（可选）。
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
列出排行榜中的分数，从顶部开始。
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
列出排行榜中与玩家得分相近（包括该得分）的得分。
submit POST /games/v1/leaderboards/{leaderboardId}/scores
将得分提交到指定的排行榜。
submitMultiple POST /games/v1/leaderboards/scores
将多个得分提交到排行榜。

REST 资源：snapshots

方法
get GET /games/v1/snapshots/{snapshotId}
检索给定快照 ID 的元数据。
list GET /games/v1/players/{playerId}/snapshots
检索您的应用为与玩家 ID 对应的玩家创建的快照列表。

REST 资源：stats

方法
get GET /games/v1/stats
返回当前已通过身份验证的用户在此应用中的互动和支出统计信息。