- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Stan
- PlayerAchievement
- Stan
- Wypróbuj
Wyświetla postęp wszystkich osiągnięć Twojej aplikacji dla obecnie uwierzytelnionego gracza.
Żądanie HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/achievements
Parametry ścieżki
Parametry | |
---|---|
playerId |
Identyfikator gracza. Zamiast identyfikatora uwierzytelnionego gracza może zostać użyta wartość |
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 osiągnięć do zwrócenia w odpowiedzi, używanych na potrzeby stronicowania. W przypadku każdej odpowiedzi rzeczywista liczba zwróconych zasobów osiągnięć może być mniejsza od określonej wartości |
pageToken |
Token zwrócony przez poprzednie żądanie. |
state |
Powoduje, że serwer zwraca tylko osiągnięcia w określonym stanie. Jeśli ten parametr nie jest określony, zwracane są wszystkie osiągnięcia. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Lista obiektów osiągnięć.
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[] |
Osiągnięcia. |
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.
Stan
Wartości w polu enum | |
---|---|
ALL |
Wymień wszystkie osiągnięcia. Jest to ustawienie domyślne. |
HIDDEN |
Wymień tylko ukryte osiągnięcia. |
REVEALED |
Sporządź listę tylko odkrytych osiągnięć. |
UNLOCKED |
Wyświetl tylko odblokowane osiągnięcia. |
PlayerAchievement
Obiekt osiągnięcia.
Zapis JSON |
---|
{
"kind": string,
"id": string,
"currentSteps": integer,
"formattedCurrentStepsString": string,
"achievementState": enum ( |
Pola | |
---|---|
kind |
Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków |
id |
Identyfikator osiągnięcia. |
currentSteps |
Bieżące kroki osiągnięcia stopniowego osiągnięcia. |
formattedCurrentStepsString |
Bieżące kroki osiągnięcia przyrostowego w postaci ciągu znaków. |
achievementState |
Stan osiągnięcia. |
lastUpdatedTimestamp |
Sygnatura czasowa ostatniej modyfikacji stanu osiągnięcia. |
experiencePoints |
Punkty doświadczenia zdobyte za osiągnięcie. Pole brakuje w przypadku osiągnięć, które nie zostały jeszcze odblokowane, oraz 0 w przypadku osiągnięć, które zostały odblokowane przez testerów, ale nie zostały opublikowane. |
Stan
Definiuje możliwe stany osiągnięcia.
Wartości w polu enum | |
---|---|
HIDDEN |
Osiągnięcie jest ukryte. |
REVEALED |
Osiągnięcie jest widoczne. |
UNLOCKED |
Osiągnięcie zostało odblokowane. |