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)

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