Metagame: listCategoriesByPlayer

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

Request

HTTP request

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

Parameters

Parameter name	Value	Description
Path parameters
`collection`	`string`	The collection of categories for which data will be returned. Acceptable values are: "`all`": Retrieve data for all categories. This is the default.
`playerId`	`string`	A player ID. A value of `me` may be used in place of the authenticated player's ID.
Optional query 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`. Acceptable values are `1` to `100`, inclusive.
`pageToken`	`string`	The token returned by the previous request.

Authorization

This request requires authorization with the following scope:

Scope
`https://www.googleapis.com/auth/games`

For more information, see the authentication and authorization page.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response body with the following structure:

{
  "kind": "games#categoryListResponse",
  "nextPageToken": string,
  "items": [
    {
      "kind": "games#category",
      "category": string,
      "experiencePoints": long
    }
  ]
}

Property name	Value	Description
`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[]`	`list`	The list of categories with usage data.
`items[].kind`	`string`	Uniquely identifies the type of this resource. Value is always the fixed string `games#category`.
`items[].category`	`string`	The category name.
`items[].experiencePoints`	`long`	Experience points earned in this category.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.