Events: listByPlayer

Returns a list showing the current progress on events in this application for the currently authenticated user. Try it now.

Request

HTTP request

GET https://www.googleapis.com/games/v1/events

Parameters

Parameter name	Value	Description
Optional query parameters
`language`	`string`	The preferred language to use for strings returned by this method.
`maxResults`	`integer`	The maximum number of events to return in the response, used for paging. For any response, the actual number of events to return 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#playerEventListResponse",
  "nextPageToken": string,
  "items": [
    {
      "kind": "games#playerEvent",
      "definitionId": string,
      "playerId": string,
      "numEvents": long,
      "formattedNumEvents": string
    }
  ]
}

Property name	Value	Description
`kind`	`string`	Uniquely identifies the type of this resource. Value is always the fixed string `games#playerEventListResponse`.
`nextPageToken`	`string`	The pagination token for the next page of results.
`items[]`	`list`	The player events.
`items[].kind`	`string`	Uniquely identifies the type of this resource. Value is always the fixed string `games#playerEvent`.
`items[].definitionId`	`string`	The ID of the event definition.
`items[].playerId`	`string`	The ID of the player.
`items[].numEvents`	`long`	The current number of times this event has occurred.
`items[].formattedNumEvents`	`string`	The current number of times this event has occurred, as a string. The formatting of this string depends on the configuration of your event in the Play Games Developer Console.

Try it!

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