Method: players.list

Mostra o conjunto de players 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 recuperada

Parâmetros de consulta

Parâmetros
language

string

O idioma preferido a ser usado para strings retornadas por este 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 do 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 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 de 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

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

VISIBLE

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

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