Players: list

Stay organized with collections Save and categorize content based on your preferences.

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


HTTP request



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:


For more information, see the authentication and authorization page.

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#playerListResponse",
  "nextPageToken": string,
  "items": [
    players Resource
Property name Value Description Notes
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.

Try it!

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