Applications: listHidden

需要授权

获取在给定应用中隐藏的玩家列表。此方法仅适用于您的开发者控制台的用户帐号。

请求

HTTP 请求

GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden

参数

参数名称	值	说明
路径参数
applicationId	string	Google Play 管理中心的应用 ID。
可选的查询参数
maxResults	integer	响应中可返回的玩家资源数量上限，用于分页。对于任何响应，返回的实际玩家资源数量都可能少于指定的 maxResults。可接受的值包括 1 到 15（闭区间）。
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	玩家的游戏活动因玩家的游戏活动而获得奖励。
items[].hiddenTimeMillis	long	此播放器被隐藏的时间。