此页面由 Cloud Translation API 翻译。

Google Play Game Services

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

服务：games.googleapis.com

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

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

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

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

方法
`list`	`GET /games/v1/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` 更新当前已通过身份验证的玩家的多个成就。

方法
`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。

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

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

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

方法
`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}` 获取当前已通过身份验证的用户的玩家集合。

方法
`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 令牌。

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

方法
`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` 将多个得分提交到排行榜。

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

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