- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- Durum
- PlayerAchievement
- Durum
- Deneyin.
Ş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 |
Oyuncu kimliği. Kimliği doğrulanmış oynatıcı kimliği yerine |
Sorgu parametreleri
Parametreler | |
---|---|
language |
Bu yöntemin döndürdüğü dizeler için kullanılması tercih edilen dil. |
maxResults |
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 |
pageToken |
Önceki istek tarafından döndürülen jeton. |
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 ( |
Alanlar | |
---|---|
kind |
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman |
nextPageToken |
Sonraki sonuç sayfasına karşılık gelen jeton. |
items[] |
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 ( |
Alanlar | |
---|---|
kind |
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman |
id |
Başarının kimliği. |
currentSteps |
Artımlı başarı için mevcut adımlar. |
formattedCurrentStepsString |
Dize halinde, artımlı bir başarı için geçerli adımlar. |
achievementState |
Başarının durumu. |
lastUpdatedTimestamp |
Bu başarının durumuyla ilgili son değişikliğin zaman damgası. |
experiencePoints |
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ı. |