Method: metagame.listCategoriesByPlayer

列出與 playerId 對應的玩家依類別匯總的播放資料。

HTTP 要求

GET https://games.googleapis.com/games/v1/players/{playerId}/categories/{collection}

路徑參數

參數
playerId

string

玩家 ID。me 的值可用來取代已驗證玩家的 ID。
collection

enum (Collection)

系統會傳回所傳回資料的類別集合。

查詢參數

參數
language

string

此方法傳回的字串偏好語言。
maxResults

integer

回應中要傳回的類別資源數量上限，用於分頁。在任何回應中，實際傳回的類別資源數量可能會少於指定的 maxResults。
pageToken

string

上一個要求傳回的權杖。

要求主體

要求主體必須為空白。

回應主體

第三方中繼遊戲類別回應。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (MetagameCategory)
    }
  ]
}
欄位
kind

string

專門識別這個資源的類型。值一律為固定字串 games#categoryListResponse。
nextPageToken

string

與下一頁結果相對應的權杖。
items[]

object (MetagameCategory)

含有使用資料的類別清單。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

詳情請參閱 OAuth 2.0 總覽。

集合

定義要傳回哪些類別的資料。

列舉
ALL 擷取所有類別的資料。此為預設值。

MetagameCategory

個別遊戲類別的資料。

JSON 表示法 
{
  "kind": string,
  "category": string,
  "experiencePoints": string
}
欄位
kind

string

專門識別這個資源的類型。值一律為固定字串 games#category。
category

string

類別名稱。
experiencePoints

string (int64 format)

獲得這個類別的總經驗值。