Method: achievementDefinitions.list

Zawiera listę wszystkich definicji osiągnięć danej aplikacji.

Żądanie HTTP

GET https://games.googleapis.com/games/v1/achievements

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.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista obiektów definicji osiągnięć.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (AchievementDefinition)
    }
  ]
}
Pola
kind

string

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

string

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

object (AchievementDefinition)

Definicje osiągnięć.

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.

AchievementDefinition

Obiekt definicji osiągnięcia.

Zapis JSON 
{
  "kind": string,
  "id": string,
  "name": string,
  "description": string,
  "achievementType": enum (AchievementType),
  "totalSteps": integer,
  "formattedTotalSteps": string,
  "revealedIconUrl": string,
  "isRevealedIconUrlDefault": boolean,
  "unlockedIconUrl": string,
  "isUnlockedIconUrlDefault": boolean,
  "initialState": enum (InitialAchievementState),
  "experiencePoints": string
}
Pola
kind

string

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

string

Identyfikator osiągnięcia.
name

string

Nazwa osiągnięcia.
description

string

Opis osiągnięcia.
achievementType

enum (AchievementType)

Typ osiągnięcia.
totalSteps

integer

Łączna liczba kroków do osiągnięcia przyrostowego osiągnięcia.
formattedTotalSteps

string

Łączna liczba kroków do osiągnięcia przyrostowego w postaci ciągu znaków.
revealedIconUrl

string

Adres URL obrazu ikony odkrytego osiągnięcia.
isRevealedIconUrlDefault

boolean

Wskazuje, czy zwracany obraz nowej ikony jest obrazem domyślnym czy pochodzi od gry.
unlockedIconUrl

string

URL obrazu ikony odblokowanego osiągnięcia.
isUnlockedIconUrlDefault

boolean

Wskazuje, czy zwracany obraz odblokowanej ikony jest obrazem domyślnym czy pochodzi z gry.
initialState

enum (InitialAchievementState)

Początkowy stan osiągnięcia.
experiencePoints

string (int64 format)

Punkty doświadczenia, które otrzymasz po odblokowaniu tego osiągnięcia.

AchievementType

Możliwe typy osiągnięć.

Wartości w polu enum
STANDARD Osiągnięcie jest zablokowane lub odblokowane.
INCREMENTAL Osiągnięcia są stopniowe.

InitialAchievementState

Możliwe początkowe 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.