Google Play 游戏服务

Google Play 游戏服务允许开发者通过社交排行榜、成就、游戏状态、使用 Google 登录等功能增强游戏。

服务：games.googleapis.com

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

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

服务端点是一个基本 URL，它指定 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` 返回请求的端点类型的 URL。
`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 的玩家资源。
`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}` 检索与提供的召回会话 ID 中编码的 PGS 玩家关联的所有请求游戏中的召回令牌。
`lastTokenFromAllDeveloperGames`	`GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}` 检索与提供的召回会话 ID 中编码的 PGS 玩家关联的所有开发者游戏中的最后一个召回令牌。
`linkPersona`	`POST /games/v1/recall:linkPersona` 将提供的召回会话 ID 中编码的 PGS 玩家主体与游戏内帐户关联。
`resetPersona`	`POST /games/v1/recall:resetPersona` 删除所有将给定角色与任何玩家（无论是否有个人资料）关联的召回令牌。
`retrieveTokens`	`GET /games/v1/recall/tokens/{sessionId}` 检索与提供的召回会话 ID 中编码的 PGS 玩家关联的所有召回令牌。
`unlinkPersona`	`POST /games/v1/recall:unlinkPersona` 删除将由召回会话标识的 PGS 玩家主体与由“角色”或令牌值标识的游戏内帐户关联的召回令牌。

方法
`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` 返回当前已认证用户在此应用程序中的参与度和支出统计数据。