Method: achievementDefinitions.list

Uygulamanız için tüm başarı tanımlarını listeler.

HTTP isteği

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

Sorgu parametreleri

Parametreler
language

string

Bu yöntemin döndürdüğü dizeler için kullanılması tercih edilen dil.

maxResults

integer

Sayfalara ayırma için kullanılan, yanıtta döndürülecek maksimum başarı kaynağı sayısı. Tüm yanıtlar için döndürülen başarı kaynaklarının sayısı, belirtilen maxResults değerinden az olabilir.

pageToken

string

Önceki istek tarafından döndürülen jeton.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Başarı tanımı nesnelerinin listesi.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (AchievementDefinition)
    }
  ]
}
Alanlar
kind

string

Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit games#achievementDefinitionsListResponse dizesidir.

nextPageToken

string

Sonraki sonuç sayfasına karşılık gelen jeton.

items[]

object (AchievementDefinition)

Başarı tanımları.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

AchievementDefinition

Bir başarı tanımı nesnesi.

JSON gösterimi
{
  "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
}
Alanlar
kind

string

Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit games#achievementDefinition dizesidir.

id

string

Başarının kimliği.

name

string

Başarının adı.

description

string

Başarının açıklaması.

achievementType

enum (AchievementType)

Başarının türü.

totalSteps

integer

Artımlı bir başarı için toplam adım sayısı.

formattedTotalSteps

string

Dize halinde artımlı bir başarı için toplam adımlar.

revealedIconUrl

string

Gösterilen başarı simgesinin resim URL'si.

isRevealedIconUrlDefault

boolean

Döndürülen simge resminin varsayılan bir resim mi olduğunu yoksa oyun tarafından sağlanıp sağlanmadığını belirtir.

unlockedIconUrl

string

Kilidi açılmış başarı simgesinin resim URL'si.

isUnlockedIconUrlDefault

boolean

Döndürülen kilidi açılmış simge resminin varsayılan bir resim mi olduğunu yoksa oyun tarafından mı sağlandığını belirtir.

initialState

enum (InitialAchievementState)

Başarının başlangıç durumu.

experiencePoints

string (int64 format)

Bu başarının kilidini açtığınızda kazanılacak deneyim puanları.

AchievementType

Olası başarı türleri.

Sıralamalar
STANDARD Başarı kilitli veya kilidi açık.
INCREMENTAL Başarı adım adım ilerler.

InitialAchievementState

Bir başarının olası ilk durumları.

Sıralamalar
HIDDEN Başarı gizlendi.
REVEALED Başarı açıklandı.
UNLOCKED Başarının kilidi açıldı.