Scores: get

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Şu anda kimliği doğrulanmış kullanıcının skorlarını skorlayın ve isterseniz skor tablolarında daha üst sıralarda yer alın. leaderboardId, belirli bir zaman aralığındaki tüm skor tablolarının verilerini almak için ALL olarak ayarlanabilir.
NOT: Aynı istekte "TÜM" skor tablolarını ve "TÜMÜ" zaman aralıklarını isteyemezsiniz. Yalnızca tek bir parametre "Tümü" olarak ayarlanabilir. Hemen deneyin.

İstek

HTTP isteği

GET https://www.googleapis.com/games/v1/players/playerId/leaderboards/leaderboardId/scores/timeSpan

Parametreler

Parametre adı Değer Açıklama
Yol parametreleri
leaderboardId string Skor tablosunun kimliği. Bu uygulamaya ait tüm skor tablolarının verilerini almak için "ALL" olarak ayarlanabilir.
playerId string Oyuncu kimliği. Kimliği doğrulanmış oynatıcının kimliği yerine me değeri kullanılabilir.
timeSpan string İstediğiniz skorlar ve sıralamalar için geçen süre.

Kabul edilen değerler şunlardır:
  • "ALL": Tüm zaman aralıkları için en yüksek puanları alın. Bu kullanılırsa maxResults değerleri yoksayılır.
  • "ALL_TIME": Tüm zamanların en yüksek puanını alın.
  • "DAILY": O gün için en yüksek puanları listeleyin.
  • "WEEKLY": O haftaki en popüler puanları listeleyin.
İsteğe bağlı sorgu parametreleri
includeRankType string Döndürülecek sıralama türleri. Parametre atlanırsa herhangi bir sıralama döndürülmez.

Kabul edilen değerler şunlardır:
  • "ALL": Desteklenen tüm sıralamaları al.
  • "FRIENDS": Arkadaş koleksiyonundaki sıralamayı alır.
  • "PUBLIC": Oyuncu, oyun oynama etkinliğini herkese açık olarak paylaşıyorsa herkese açık sıralamaları alın.
  • "SOCIAL": (Eski) Eski G+ sosyal leaderboard'lar sıralaması, her zaman 1.
language string Bu yöntemle döndürülen dizeler için kullanılacak tercih edilen dil.
maxResults integer Yanıtta döndürülecek maksimum skor tablosu sayısı. Yanıtlar için, skor tablolarında görüntülenen gerçek puan sayısı belirtilen maxResults değerinden düşük olabilir. Kabul edilebilir değerler 1 ile 30 arasındadır (bu değerler dahil).
pageToken string Önceki istek tarafından döndürülen jeton.

Yetkilendirme

Bu istek, aşağıdaki kapsamla yetkilendirme gerektiriyor:

Kapsam
https://www.googleapis.com/auth/games

Daha fazla bilgi edinmek için kimlik doğrulama ve yetkilendirme sayfasını inceleyin.

İstek metni

Bu yöntemi içeren bir istek gövdesi sağlamayın.

Yanıt

Başarılı olursa bu yöntem yanıt gövdesinde bir Puan kaynağı döndürür.

Deneyin.

Bu yöntemi canlı verilerde çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.