- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Gromadzenie danych
- MetagameCategory
- Wypróbuj
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 |
Identyfikator gracza. Zamiast identyfikatora uwierzytelnionego gracza może zostać użyta wartość |
collection |
Zbiór kategorii, dla których będą zwracane dane. |
Parametry zapytania
Parametry | |
---|---|
language |
Preferowany język używany w przypadku ciągów znaków zwracanych przez tę metodę. |
maxResults |
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ść |
pageToken |
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 ( |
Pola | |
---|---|
kind |
Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków |
nextPageToken |
Token odpowiadający następnej stronie wyników. |
items[] |
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 |
Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków |
category |
Nazwa kategorii. |
experiencePoints |
Punkty doświadczenia zdobyte w tej kategorii. |