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)

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