Method: metagame.listCategoriesByPlayer

Wyświetl dane zbiorcze dotyczące odtwarzania według kategorii dla gracza odpowiadającego grze playerId.

Żądanie HTTP

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

Parametry ścieżki

Parametry
playerId

string

Identyfikator gracza. Zamiast identyfikatora uwierzytelnionego gracza może zostać użyta wartość me.
collection

enum (Collection)

Zbiór kategorii, dla których będą zwracane dane.

Parametry zapytania

Parametry
language

string

Preferowany język używany w przypadku ciągów znaków zwracanych przez tę metodę.
maxResults

integer

Maksymalna liczba zasobów kategorii, które mają zostać zwrócone w odpowiedzi, używanych na potrzeby stronicowania. W przypadku każdej odpowiedzi rzeczywista liczba zwróconych zasobów kategorii może być mniejsza niż określona wartość maxResults.
pageToken

string

Token zwrócony przez poprzednie żądanie.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź z zewnętrznej listy metagier z listą kategorii.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (MetagameCategory)
    }
  ]
}
Pola
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków games#categoryListResponse.
nextPageToken

string

Token odpowiadający następnej stronie wyników.
items[]

object (MetagameCategory)

Lista kategorii z danymi o korzystaniu.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

Kolekcja

Określa kategorie, dla których będą zwracane dane.

Wartości w polu enum
ALL Pobierz dane ze wszystkich kategorii. Jest to ustawienie domyślne.

MetagameCategory

Dane związane z poszczególnymi kategoriami gier.

Zapis JSON 
{
  "kind": string,
  "category": string,
  "experiencePoints": string
}
Pola
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków games#category.
category

string

Nazwa kategorii.
experiencePoints

string (int64 format)

Punkty doświadczenia zdobyte w tej kategorii.