Method: achievements.list

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

string

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

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 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 maxResults.
pageToken

string

Token zwrócony przez poprzednie żądanie.
state

enum (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 (PlayerAchievement)
    }
  ]
}
Pola
kind

string

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

string

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

object (PlayerAchievement)

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 (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
Pola
kind

string

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

string

Identyfikator osiągnięcia.
currentSteps

integer

Bieżące kroki osiągnięcia stopniowego osiągnięcia.
formattedCurrentStepsString

string

Bieżące kroki osiągnięcia przyrostowego w postaci ciągu znaków.
achievementState

enum (State)

Stan osiągnięcia.
lastUpdatedTimestamp

string (int64 format)

Sygnatura czasowa ostatniej modyfikacji stanu osiągnięcia.
experiencePoints

string (int64 format)

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.