Google Play 游戏服务

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

服务：games.googleapis.com

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

Discovery 文档

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

服务端点

服务终点是指定 API 服务网络地址的基本 URL。一个服务可能有多个服务终点。此服务有以下服务终点，以下所有 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
返回所请求端点类型的 URL。
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 资源：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}
检索与所提供召回会话 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 玩家主体和由“角色”或令牌值标识的游戏内账户链接起来的召回令牌。

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
返回当前通过身份验证的用户在此应用中的参与度和支出统计信息。