Method: metagame.listCategoriesByPlayer

List play data aggregated per category for the player corresponding to playerId.

HTTP request

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

Path parameters

Parameters
playerId

string

A player ID. A value of me may be used in place of the authenticated player's ID.
collection

enum (Collection)

The collection of categories for which data will be returned.

Query parameters

Parameters
language

string

The preferred language to use for strings returned by this method.
maxResults

integer

The maximum number of category resources to return in the response, used for paging. For any response, the actual number of category resources returned may be less than the specified maxResults.
pageToken

string

The token returned by the previous request.

Request body

The request body must be empty.

Response body

A third party list metagame categories response.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (MetagameCategory)
    }
  ]
}
Fields
kind

string

Uniquely identifies the type of this resource. Value is always the fixed string games#categoryListResponse.
nextPageToken

string

Token corresponding to the next page of results.
items[]

object (MetagameCategory)

The list of categories with usage data.

Authorization scopes

Requires one of the following OAuth scopes:

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

For more information, see the OAuth 2.0 Overview.

Collection

Defines categories for which data will be returned.

Enums
ALL Retrieve data for all categories. This is the default.

MetagameCategory

Data related to individual game categories.

JSON representation 
{
  "kind": string,
  "category": string,
  "experiencePoints": string
}
Fields
kind

string

Uniquely identifies the type of this resource. Value is always the fixed string games#category.
category

string

The category name.
experiencePoints

string (int64 format)

Experience points earned in this category.