Method: players.list

Recebe a coleção de jogadores do usuário autenticado no momento.

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 recuperados

Parâmetros de consulta

Parâmetros
language

string

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

maxResults

integer

O número máximo de recursos do jogador a serem retornados na resposta, usado para paginação. Para 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 da 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 deste 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

Enums
CONNECTED

Recupera uma lista de jogadores que também estão jogando em ordem cronológica inversa.

VISIBLE

Recupera uma lista de jogadores no gráfico social do usuário que estão visíveis ao jogo.

FRIENDS_ALL Recuperar uma lista de jogadores que são amigos do usuário em ordem alfabética.