- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- ScoreTimeSpan
- IncludeRankType
- Deneyin.
Şu anda kimliği doğrulanmış durumda olan oyuncu için skor tablolarında rekorlar ve isteğe bağlı olarak sıralamalar alın. Belirli bir zaman diliminde leaderboardId
, belirli bir zaman dilimindeki tüm skor tablolarıyla ilgili verileri almak için ALL
olarak ayarlanabilir. "NOT: Aynı istekte "TÜM" skor tablolarını ve "TÜM" timeSpan'leri isteyemezsiniz; yalnızca bir parametre "ALL" olarak ayarlanabilir.
HTTP isteği
GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Yol parametreleri
Parametreler | |
---|---|
playerId |
Oyuncu kimliği. Kimliği doğrulanmış oynatıcı kimliği yerine |
leaderboardId |
Skor tablosunun kimliği. Bu uygulamaya ait tüm skor tablolarıyla ilgili verileri almak için "TÜMÜ" olarak ayarlanabilir. |
timeSpan |
İstediğiniz puanlar ve sıralamalar için zaman aralığı. |
Sorgu parametreleri
Parametreler | |
---|---|
language |
Bu yöntemin döndürdüğü dizeler için kullanılması tercih edilen dil. |
includeRankType |
Döndürülecek sıralama türleri. Parametre atlanırsa hiçbir sıralama döndürülmez. |
maxResults |
Yanıtta döndürülecek maksimum skor tablosu skoru. Yanıtlar için döndürülen skor tablosu skorlarının gerçek sayısı belirtilen |
pageToken |
Önceki istek tarafından döndürülen jeton. |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt metni
Başarılıysa yanıt metni, GetLeaderboardScoresResponse
öğesinin bir örneğini içerir.
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.
ScoreTimeSpan
Puan için olası zaman aralıklarını tanımlar.
Sıralamalar | |
---|---|
ALL |
Tüm zaman aralıkları için rekor kırın. Bu kullanılırsa maxResults değerleri yoksayılır. |
ALL_TIME |
Tüm zamanların rekorunu kırın. |
WEEKLY |
Geçerli gün için en yüksek puanları listeleyin. |
DAILY |
Geçerli haftanın en yüksek puanlarını listeleyin. |
IncludeRankType
Sıralama türü için olası değerler.
Sıralamalar | |
---|---|
ALL |
Desteklenen tüm sıralamaları al. HTTP'de bu parametre değeri ALL olarak da belirtilebilir. |
PUBLIC |
Oyuncu oyun etkinliğini herkese açık olarak paylaşıyorsa herkese açık sıralamaları alma. |
SOCIAL |
(Eski) Sosyal sıralamayı alın. |
FRIENDS |
Arkadaşlar koleksiyonundaki sıralamayı alın. |