Players: list

Get the collection of players for the currently authenticated user. Try it now.

Request

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

Parameter name	Value	Description
Path parameters
`collection`	`string`	Collection of players being retrieved Acceptable values are: "`connected`": (DEPRECATED) Retrieve a list of players that are also playing this game in reverse chronological order. "`friends_all`": Retrieve a list of players who are friends of the user in alphabetical order. "`playedWith`": (DEPRECATED) Retrieve a list of players you have played a multiplayer game (realtime or turn-based) with recently. "`played_with`": (DEPRECATED) Retrieve a list of players you have played a multiplayer game (realtime or turn-based) with recently. "`visible`": (DEPRECATED: please use FRIENDS_ALL) Retrieve a list of players in the user's social graph that are visible to this game.
Optional query parameters
`language`	`string`	The preferred language to use for strings returned by this method.
`maxResults`	`integer`	The maximum number of player resources to return in the response, used for paging. For any response, the actual number of player resources returned may be less than the specified `maxResults`. Acceptable values are `1` to `50`, inclusive.
`pageToken`	`string`	The token returned by the previous request.

This request requires authorization with the following scope:

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

For more information, see the authentication and authorization page.

Do not supply a request body with this method.

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

{
  "kind": "games#playerListResponse",
  "nextPageToken": string,
  "items": [
    players Resource
  ]
}

Property name	Value	Description
`kind`	`string`	Uniquely identifies the type of this resource. Value is always the fixed string `games#playerListResponse`.
`nextPageToken`	`string`	Token corresponding to the next page of results.
`items[]`	`list`	The players.

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