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	玩家上次玩遊戲的時間，以毫秒為單位自 Epoch 紀元時間 (世界標準時間) 起算。
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 紀元 (世界標準時間) 開始計算。
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	隱藏這個播放器的時間。