Applications: listHidden

需要授權

取得在特定應用程式中隱藏的玩家清單。這種方法僅適用於 Play 管理中心的使用者帳戶。

要求

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 紀元 (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 隱藏這位播放器的時間。