Method: achievements.list

Kimliği doğrulanmış olan oynatıcı için uygulamanızın tüm başarılarının ilerleme durumunu listeler.

HTTP isteği

GET https://games.googleapis.com/games/v1/players/{playerId}/achievements

Yol parametreleri

Parametreler
playerId

string

Oynatıcı kimliği. me değeri, kimliği doğrulanmış oynatıcının kimliği yerine kullanılabilir.

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.
state

enum (State)

Sunucuya yalnızca belirtilen durumdaki başarıları döndürmesini söyler. Bu parametre belirtilmezse tüm başarılar döndürülür.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Başarı 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 (PlayerAchievement)
    }
  ]
}
Alanlar
kind

string

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

string

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

object (PlayerAchievement)

Başarılar.

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.

Eyalet

Sıralamalar
ALL Tüm başarıları listele. Bu, varsayılan ayardır.
HIDDEN Yalnızca gizli başarıları listele.
REVEALED Yalnızca gösterilen başarıları listele.
UNLOCKED Yalnızca kilidi açılan başarıları listele.

PlayerAchievement

Bir başarı nesnesi.

JSON gösterimi 
{
  "kind": string,
  "id": string,
  "currentSteps": integer,
  "formattedCurrentStepsString": string,
  "achievementState": enum (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
Alanlar
kind

string

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

string

Başarının kimliği.
currentSteps

integer

Artımlı bir başarı için mevcut adımlar.
formattedCurrentStepsString

string

Dize halinde artımlı bir başarı için geçerli adımlar.
achievementState

enum (State)

Başarının durumu.
lastUpdatedTimestamp

string (int64 format)

Bu başarının durumunda yapılan son değişikliğin zaman damgası.
experiencePoints

string (int64 format)

Başarı için kazanılan deneyim puanları. Bu alan, henüz kilidi açılmamış başarılar için eksik, test kullanıcıları tarafından kilidi açılan ancak yayınlanmamış başarılar için 0 değerini alır.

Eyalet

Bir başarının olası durumlarını tanımlar.

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