应用：列出隐藏玩家

需要授权

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

请求

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 嵌套对象 玩家信息。
items[].player.kind string 唯一标识此资源的类型。值始终是固定字符串 gamesManagement#player。
items[].player.playerId string 玩家 ID。
items[].player.displayName string 要显示的玩家姓名。
items[].player.avatarImageUrl string 代表玩家的图片的基础 URL。
items[].player.lastPlayedWith 嵌套对象 此玩家上次与当前经过身份验证的玩家玩多人游戏的时间详情。针对 PLAYED_WITH 玩家集合成员填充此字段。
items[].player.lastPlayedWith.timeMillis long 玩家上次玩游戏的时间（自纪元以来的毫秒数，采用 UTC 时间）。
items[].player.lastPlayedWith.autoMatched boolean 如果该玩家与当前通过身份验证的用户自动匹配，则为 True。
items[].player.name object 玩家姓名的各个组成部分的对象表示形式。对于某些玩家，这些字段可能不存在。
items[].player.name.familyName string 此玩家的姓氏。在某些地区，这称为 last name。
items[].player.name.givenName string 此玩家的名字。在某些地区，这称为 first name。
items[].player.experienceInfo 嵌套对象 一个对象，表示玩家的 Play 游戏经验信息。
items[].player.experienceInfo.currentExperiencePoints long 玩家当前的经验值数量。
items[].player.experienceInfo.lastLevelUpTimestampMillis long 玩家升级时的时间戳，自 Unix 纪元以来的毫秒数（采用 UTC 时间）。
items[].player.experienceInfo.currentLevel 嵌套对象 玩家当前等级。
items[].player.experienceInfo.currentLevel.level integer 用户的等级。
items[].player.experienceInfo.currentLevel.minExperiencePoints long 此等级所需的最低经验值。
items[].player.experienceInfo.currentLevel.maxExperiencePoints long 此等级所需的最高经验值。
items[].player.experienceInfo.nextLevel 嵌套对象 玩家的下一等级。如果当前等级是最高等级，则此字段应与当前等级相同。
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 此玩家被隐藏的时间。