Method: achievements.list

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

string

Identyfikator gracza. Zamiast identyfikatora uwierzytelnionego gracza można użyć wartości me.

Parametry zapytania

Parametry
language

string

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

integer

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

string

Token zwrócony przez poprzednie żądanie.
state

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

string

Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem 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 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 (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
Pola
kind

string

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

string

Identyfikator osiągnięcia.
currentSteps

integer

Bieżące kroki do osiągnięcia przyrostowego osiągnięcia.
formattedCurrentStepsString

string

Bieżące kroki do 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 tego osiągnięcia.
experiencePoints

string (int64 format)

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.