- Żą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ęć w aplikacji dla aktualnie uwierzytelnionego odtwarzacza.
Żądanie HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/achievements
Parametry ścieżki
Parametry | |
---|---|
playerId |
Identyfikator gracza. Zamiast identyfikatora uwierzytelnionego gracza można użyć wartości |
Parametry zapytania
Parametry | |
---|---|
language |
Preferowany język używany w przypadku ciągów tekstowych zwracanych przez tę metodę. |
maxResults |
Maksymalna liczba zasobów osiągnięć, które mają zostać zwrócone w odpowiedzi, używanej na potrzeby stronicowania. W przypadku każdej odpowiedzi rzeczywista liczba zwróconych zasobów osiągnięć może być mniejsza niż podana wartość |
pageToken |
Token zwrócony przez poprzednie żądanie. |
state |
Informuje serwer, że zwraca tylko osiągnięcia w określonym stanie. Jeśli nie określisz tego parametru, zwracane będą 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ść jest zawsze stałym ciągiem znaków |
nextPageToken |
Token odpowiadający następnej stronie wyników. |
items[] |
Osiągnięcia. |
Zakresy autoryzacji
Wymaga jednego z tych zakresów 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 |
Wyświetlanie listy wszystkich osiągnięć. To jest ustawienie domyślne. |
HIDDEN |
Wyświetlanie tylko ukrytych osiągnięć. |
REVEALED |
Pokazuj tylko ujawnione osiągnięcia. |
UNLOCKED |
wyświetlać listę tylko odblokowanych osiągnięć; |
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ść jest zawsze stałym ciągiem znaków |
id |
Identyfikator osiągnięcia. |
currentSteps |
Bieżące kroki do osiągnięcia przyrostowego osiągnięcia. |
formattedCurrentStepsString |
Bieżące kroki do osiągnięcia przyrostowego w postaci ciągu znaków. |
achievementState |
Stan osiągnięcia. |
lastUpdatedTimestamp |
Sygnatura czasowa ostatniej modyfikacji stanu tego osiągnięcia. |
experiencePoints |
Punkty doświadczenia uzyskane za osiągnięcie. Pole jest puste w przypadku osiągnięć, które nie zostały jeszcze odblokowane, oraz wartości 0 przy osiągnięciach odblokowanych przez testerów, ale nieopublikowanych. |
Stan
Definiuje możliwe stany osiągnięcia.
Wartości w polu enum | |
---|---|
HIDDEN |
Osiągnięcie jest ukryte. |
REVEALED |
Osiągnięcie zostaje ujawnione. |
UNLOCKED |
Osiągnięcie jest odblokowane. |