应用：listHidden

需要授权

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

请求

HTTP 请求

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

参数

参数名称	值	描述
路径参数
`applicationId`	`字符串`	来自 Google Play Console 的应用 ID。
可选查询参数
`maxResults`	`整数`	响应中返回的玩家资源的最大数量，用于分页。对于任何响应，返回的实际玩家资源数量可能小于指定的 `maxResults`。可接受的值为 `1` 到 `15`（含）。
`pageToken`	`字符串`	先前请求返回的标记。

授权

此请求需要使用以下范围进行授权（详细了解身份验证和授权）。

范围
`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`	`字符串`	唯一标识此资源的类型。值始终是固定字符串 `gamesManagement#hiddenPlayerList`。
`nextPageToken`	`字符串`	下一页结果的分页标记。
`items[]`	`列表`	玩家。
`items[].kind`	`字符串`	唯一标识此资源的类型。值始终是固定字符串 `gamesManagement#hiddenPlayer`。
`items[].player`	`嵌套对象`	玩家信息。
`items[].player.kind`	`字符串`	唯一标识此资源的类型。值始终是固定字符串 `gamesManagement#player`。
`items[].player.playerId`	`字符串`	玩家的 ID。
`items[].player.displayName`	`字符串`	要显示的玩家名称。
`items[].player.avatarImageUrl`	`字符串`	表示玩家的图像的基本 URL。
`items[].player.lastPlayedWith`	`嵌套对象`	有关此玩家上次与当前经过身份验证的玩家一起玩多人游戏的详细信息。已填充 PLAYED_WITH 玩家收藏成员。
`items[].player.lastPlayedWith.timeMillis`	`长整型`	玩家上次玩游戏的UTC时间戳，以毫秒为单位（自纪元以来的时间）。
`items[].player.lastPlayedWith.autoMatched`	`布尔型`	如果玩家与当前经过身份验证的用户自动匹配，则为真。
`items[].player.name`	`对象`	玩家姓名各个组成部分的对象表示形式。对于某些玩家，这些字段可能不存在。
`items[].player.name.familyName`	`字符串`	此玩家的姓氏。在某些地方，这被称为姓氏。
`items[].player.name.givenName`	`字符串`	此玩家的名字。在某些地方，这被称为名字。
`items[].player.experienceInfo`	`嵌套对象`	表示玩家游戏体验信息的对象。
`items[].player.experienceInfo.currentExperiencePoints`	`长整型`	玩家当前的经验点数。
`items[].player.experienceInfo.lastLevelUpTimestampMillis`	`长整型`	玩家升级的时间戳，以毫秒为单位（自 Unix 纪元以来的 UTC 时间）。
`items[].player.experienceInfo.currentLevel`	`嵌套对象`	玩家的当前等级。
`items[].player.experienceInfo.currentLevel.level`	`整数`	用户的等级。
`items[].player.experienceInfo.currentLevel.minExperiencePoints`	`长整型`	此等级的最低经验点数。
`items[].player.experienceInfo.currentLevel.maxExperiencePoints`	`长整型`	此等级的最高经验点数。
`items[].player.experienceInfo.nextLevel`	`嵌套对象`	玩家的下一等级。如果当前等级是最高等级，则应与当前等级相同。
`items[].player.experienceInfo.nextLevel.level`	`整数`	用户的等级。
`items[].player.experienceInfo.nextLevel.minExperiencePoints`	`长整型`	此等级的最低经验点数。
`items[].player.experienceInfo.nextLevel.maxExperiencePoints`	`长整型`	此等级的最高经验点数。
`items[].player.title`	`字符串`	玩家因游戏活动而获得的称号。
`items[].hiddenTimeMillis`	`长整型`	此玩家被隐藏的时间。