Method: achievementDefinitions.list

Zawiera wszystkie definicje osiągnięć w przypadku Twojej 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 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.

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ścią jest zawsze stały ciąg 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 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.

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ścią jest zawsze stały ciąg 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.
formattedTotalSteps

string

Łączna liczba kroków 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 ikony jest obrazem domyślnym, czy został dostarczony przez grę.
unlockedIconUrl

string

Adres URL obrazu ikony odblokowanego osiągnięcia.
isUnlockedIconUrlDefault

boolean

Wskazuje, czy zwracana ikona odblokowana jest obrazem domyślnym, czy została dostarczona przez grę.
initialState

enum (InitialAchievementState)

Początkowy stan osiągnięcia.
experiencePoints

string (int64 format)

Punkty doświadczenia, które otrzymasz za odblokowanie 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ą przyrostowe.

InitialAchievementState

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