Google Play Games Services API

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 资源：leaderboards

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

REST 资源：metagame

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

REST 资源：playerGameEvents

方法
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
记录特定玩家的一批玩家游戏事件。

REST 资源：players

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

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
返回当前已通过身份验证的用户的相应应用中的互动和支出统计信息。