Method: achievements.list

Şu anda kimliği doğrulanmış durumda olan oynatıcı için uygulamanızın tüm başarılarıyla ilgili ilerleme durumunu listeler.

HTTP isteği

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

Yol parametreleri

Parametreler
playerId

string

Oyuncu kimliği. Kimliği doğrulanmış oynatıcı kimliği yerine me değeri kullanılabilir.

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

enum (State)

Sunucudan yalnızca belirtilen durumdaki başarıları döndürmesini ister. 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 games#playerAchievementListResponse sabit 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'a Genel Bakış başlıklı makaleye bakın.

Eyalet

Sıralamalar
ALL Tüm başarıları listeleyin. Bu varsayılan seçenektir.
HIDDEN Yalnızca gizli başarıları listeleyin.
REVEALED Yalnızca görünen başarıları listeleyin.
UNLOCKED Yalnızca kilidi açılmış başarıları listeleyin.

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 games#playerAchievement sabit dizesidir.
id

string

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

integer

Artımlı 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 durumuyla ilgili 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 eksiktir. Test kullanıcıları tarafından kilidi açılmış ancak yayınlanmamış başarılar için 0 değer girilebilir.

Eyalet

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

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