Method: metagame.listCategoriesByPlayer

Lista de dados de reprodução agregados por categoria para o jogador correspondente a playerId.

Solicitação HTTP

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

Parâmetros de caminho

Parâmetros
playerId

string

Um ID do jogador. Um valor de me pode ser usado no lugar do ID do jogador autenticado.

collection

enum (Collection)

A coleção de categorias para as quais os dados serão retornados.

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 de categoria a serem retornados na resposta, usado para paginação. Para qualquer resposta, o número real de recursos de categoria 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

Resposta de uma lista de categorias de metajogo 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 (MetagameCategory)
    }
  ]
}
Campos
kind

string

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

nextPageToken

string

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

items[]

object (MetagameCategory)

A lista de categorias com dados de uso.

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

Define as categorias para os dados que serão retornados.

Enumerações
ALL Extrair dados de todas as categorias. Esse é o padrão.

MetagameCategory

Dados relacionados a categorias de jogos individuais.

Representação JSON
{
  "kind": string,
  "category": string,
  "experiencePoints": string
}
Campos
kind

string

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

category

string

O nome da categoria.

experiencePoints

string (int64 format)

Pontos de experiência ganhos nesta categoria.