Method: scores.get

Ş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

string

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

string

Skor tablosunun kimliği. Bu uygulamaya ait tüm skor tablolarıyla ilgili verileri almak için "TÜMÜ" olarak ayarlanabilir.
timeSpan

enum (ScoreTimeSpan)

İstediğiniz puanlar ve sıralamalar için zaman aralığı.

Sorgu parametreleri

Parametreler
language

string

Bu yöntemin döndürdüğü dizeler için kullanılması tercih edilen dil.
includeRankType

enum (IncludeRankType)

Döndürülecek sıralama türleri. Parametre atlanırsa hiçbir sıralama döndürülmez.
maxResults

integer

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 maxResults değerinden az olabilir.
pageToken

string

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