Method: achievementDefinitions.list

Uygulamanızla ilgili 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

Yanıtta döndürülecek ve sayfalama için kullanılan maksimum başarı kaynağı sayısı. Yanıtlar için döndürülen başarı kaynaklarının gerçek 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 bir 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 games#achievementDefinitionsListResponse sabit 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'a Genel Bakış başlıklı makaleye bakı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 games#achievementDefinition sabit 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ım sayısı.
revealedIconUrl

string

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

boolean

Döndürülen simge resminin varsayılan bir resim mi yoksa oyun tarafından mı sağlandığı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 yoksa oyun tarafından sağlanmış mı olduğunu 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ı kilitlendi veya kilidi açıldı.
INCREMENTAL Başarılar adım adım ilerler.

InitialAchievementState

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

Sıralamalar
HIDDEN Başarı gizlendi.
REVEALED Başarı görünür.
UNLOCKED Başarının kilidi açıldı.