借助 Google Play 游戏服务,开发者可以通过社交排行榜、成就、游戏状态、使用 Google 账号登录等功能来提升游戏体验。
- REST 资源:AchievementDefinitions
- REST 资源:成就
- REST 资源:应用
- REST 资源:events
- REST 资源:排行榜
- REST 资源:metagame
- REST 资源:player
- REST 资源:recall
- REST 资源:修订版本
- REST 资源:得分
- REST 资源:快照
- REST 资源:stats
服务:games.googleapis.com
要调用此服务,我们建议您使用 Google 提供的客户端库。如果您的应用程序需要使用自己的库来调用此服务,请在发出 API 请求时使用以下信息。
发现文档
发现文档是用于说明和使用 REST API 的机器可读规范。它用于构建客户端库、IDE 插件以及与 Google API 交互的其他工具。一项服务可能会提供多个发现文档。此服务提供了以下发现文档:
服务端点
服务端点是指定 API 服务的网络地址的基本网址。一项服务可能有多个服务端点。此服务具有以下服务端点,下面的所有 URI 都与此服务端点相关:
https://games.googleapis.com
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 资源: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
方法 | |
---|---|
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 返回此应用中当前经过身份验证的用户的互动度和支出统计信息。 |