Method: players.list

Receba a coleção de jogadores do usuário autenticado.

Solicitação HTTP

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

Parâmetros de caminho

Parâmetros
collection

enum (Collection)

Coleção de jogadores sendo recuperada

Parâmetros de consulta

Parâmetros
language

string

O idioma preferencial a ser usado para strings retornadas por esse método.
maxResults

integer

O número máximo de recursos do player a serem retornados na resposta, usado para paginação. Em qualquer resposta, o número real de recursos do jogador retornados pode ser menor que o maxResults especificado.
pageToken

string

O token retornado pela solicitação anterior.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Uma resposta de lista de jogadores de terceiros.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (Player)
    }
  ]
}
Campos
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#playerListResponse.
nextPageToken

string

Token correspondente à próxima página de resultados.
items[]

object (Player)

Os jogadores.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

Para mais informações, consulte a Visão geral do OAuth 2.0.

Coleção

Enumerações
CONNECTED

Extraia uma lista de jogadores que também estão jogando esse jogo em ordem cronológica inversa.
VISIBLE

Extrai uma lista de jogadores no gráfico social do usuário que estão visíveis para este jogo.
FRIENDS_ALL Recuperar uma lista de jogadores que são amigos do usuário em ordem alfabética.