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 の概要をご覧ください。

コレクション

データを返すカテゴリを定義します。

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

MetagameCategory

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

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

string

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

category

string

カテゴリ名。

experiencePoints

string (int64 format)

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