此页面由 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`（）返回调用应用的元游戏配置数据。
`listCategoriesByPlayer`	`GET /games/v1/players/{playerId}/categories/{collection}`（）列出与 `playerId` 对应的播放器按类别汇总的播放数据。

方法
`get`	`GET /games/v1/players/{playerId}`（）检索具有指定 ID 的 Player 资源。
`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`（）返回此应用中当前经过身份验证的用户的互动和支出统计信息。