需要授权
获取在给定应用中隐藏的玩家列表。此方法仅适用于开发者控制台的用户账号。
请求
HTTP 请求
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
参数
参数名称 | 值 | 说明 |
---|---|---|
路径参数 | ||
applicationId |
string |
来自 Google Play 管理中心的应用 ID。 |
可选的查询参数 | ||
maxResults |
integer |
响应中可返回的玩家资源数量上限,用于分页。对于任何响应,返回的实际玩家资源数量可能少于指定的 maxResults 。
可接受的值包括1 到15 (含 0 和 50000)。
|
pageToken |
string |
上一个请求返回的令牌。 |
授权
此请求需要获得下列范围的授权(详细了解身份验证和授权)。
范围 |
---|
https://www.googleapis.com/auth/games |
请求正文
使用此方法时请勿提供请求正文。
响应
如果成功,此方法将返回采用以下结构的响应正文:
{ "kind": "gamesManagement#hiddenPlayerList", "nextPageToken": string, "items": [ { "kind": "gamesManagement#hiddenPlayer", "player": { "kind": "gamesManagement#player", "playerId": string, "displayName": string, "avatarImageUrl": string, "lastPlayedWith": { "timeMillis": long, "autoMatched": boolean }, "name": { "familyName": string, "givenName": string }, "experienceInfo": { "currentExperiencePoints": long, "lastLevelUpTimestampMillis": long, "currentLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long }, "nextLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long } }, "title": string }, "hiddenTimeMillis": long } ] }
属性名称 | 值 | 说明 | 备注 |
---|---|---|---|
kind |
string |
唯一标识此资源类型。值始终是固定字符串 gamesManagement#hiddenPlayerList 。 |
|
nextPageToken |
string |
下一页结果的分页令牌。 | |
items[] |
list |
球员。 | |
items[].kind |
string |
唯一标识此资源类型。值始终是固定字符串 gamesManagement#hiddenPlayer 。 |
|
items[].player |
nested object |
玩家信息。 | |
items[].player.kind |
string |
唯一标识此资源类型。值始终是固定字符串 gamesManagement#player 。 |
|
items[].player.playerId |
string |
播放器的 ID。 | |
items[].player.displayName |
string |
为播放器显示的名称。 | |
items[].player.avatarImageUrl |
string |
表示播放器的图片的基础网址。 | |
items[].player.lastPlayedWith |
nested object |
有关该玩家上次与当前已通过身份验证的玩家一起玩多人游戏的详细信息。为 PLAYED_WITH 玩家集合成员填充。 | |
items[].player.lastPlayedWith.timeMillis |
long |
玩家最后一次玩游戏的时间(以世界协调时间 (UTC) 从公元纪年开始计算的毫秒数表示)。 | |
items[].player.lastPlayedWith.autoMatched |
boolean |
如果玩家与当前经过身份验证的用户自动匹配,则为“true”。 | |
items[].player.name |
object |
播放器名称各个组成部分的对象表示形式。对于某些玩家,这些字段可能不存在。 | |
items[].player.name.familyName |
string |
此播放器的姓氏。在某些地方,这个名字称为姓氏。 | |
items[].player.name.givenName |
string |
此播放器的名字。在某些地方,这个名字叫作名字。 | |
items[].player.experienceInfo |
nested object |
用于表示玩家的 Play 游戏体验信息的对象。 | |
items[].player.experienceInfo.currentExperiencePoints |
long |
玩家当前的经验值。 | |
items[].player.experienceInfo.lastLevelUpTimestampMillis |
long |
玩家升级时的时间戳,以从 Unix 新纪元 UTC 开始计算的毫秒数表示。 | |
items[].player.experienceInfo.currentLevel |
nested object |
玩家的当前等级。 | |
items[].player.experienceInfo.currentLevel.level |
integer |
用户的级别。 | |
items[].player.experienceInfo.currentLevel.minExperiencePoints |
long |
此等级的最低经验值。 | |
items[].player.experienceInfo.currentLevel.maxExperiencePoints |
long |
此关卡的经验值上限。 | |
items[].player.experienceInfo.nextLevel |
nested object |
玩家进入下一关。如果当前级别为最高级别,则此级别应与当前级别相同。 | |
items[].player.experienceInfo.nextLevel.level |
integer |
用户的级别。 | |
items[].player.experienceInfo.nextLevel.minExperiencePoints |
long |
此等级的最低经验值。 | |
items[].player.experienceInfo.nextLevel.maxExperiencePoints |
long |
此关卡的经验值上限。 | |
items[].player.title |
string |
玩家通过游戏活动获得的称号。 |