Method: metagame.listCategoriesByPlayer

Lista 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)

O conjunto de categorias para as quais os dados serão retornados.

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 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

Uma resposta de categorias do metajogo de lista 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)

Lista de categorias com dados de uso.

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

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

Enums
ALL Recuperar dados de todas as categorias. Esse é o padrão.

MetagameCategory

Dados relacionados a categorias individuais de jogos.

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

Nome da categoria.

experiencePoints

string (int64 format)

Pontos de experiência ganhos nesta categoria.