Method: metagame.listCategoriesByPlayer

playerId に対応するプレーヤーのカテゴリごとに集計されたプレイデータを一覧表示します。

HTTP リクエスト

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

パスパラメータ

パラメータ
playerId

string

プレーヤー ID。認証されたプレーヤー ID の代わりに me 値を使用できます。
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 の概要をご覧ください。

Collection

データが返されるカテゴリを定義します。

列挙型
ALL すべてのカテゴリのデータを取得します。これがデフォルトです。

MetagameCategory

個々のゲームカテゴリに関連するデータです。

JSON 表現 
{
  "kind": string,
  "category": string,
  "experiencePoints": string
}
フィールド
kind

string

このリソースのタイプを一意に識別します。値は常に固定文字列 games#category です。
category

string

カテゴリ名。
experiencePoints

string (int64 format)

このカテゴリで獲得した経験値。