Metagame: listCategoriesByPlayer

Requires authorization

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


HTTP request



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
consistencyToken long The last-seen mutation timestamp.
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.


This request requires authorization with the following scope (read more about authentication and authorization).


Request body

Do not supply a request body with this method.


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 Notes
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.