Method: scores.get
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Ş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. |
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-27 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-07-27 UTC."],[],[],null,["# Method: scores.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [ScoreTimeSpan](#ScoreTimeSpan)\n- [IncludeRankType](#IncludeRankType)\n- [Try it!](#try-it)\n\nGet high scores, and optionally ranks, in leaderboards for the currently authenticated player. For a specific time span, `leaderboardId` can be set to `ALL` to retrieve data for all leaderboards in a given time span. \\`NOTE: You cannot ask for 'ALL' leaderboards and 'ALL' timeSpans in the same request; only one parameter may be set to 'ALL'.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}`\n\n### Path parameters\n\n| Parameters ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------|\n| `playerId` | `string` A player ID. A value of `me` may be used in place of the authenticated player's ID. |\n| `leaderboardId` | `string` The ID of the leaderboard. Can be set to 'ALL' to retrieve data for all leaderboards for this application. |\n| `timeSpan` | `enum (`[ScoreTimeSpan](/games/services/web/api/rest/v1/scores/get#ScoreTimeSpan)`)` The time span for the scores and ranks you're requesting. |\n\n### Query parameters\n\n| Parameters ||\n|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n| `includeRankType` | `enum (`[IncludeRankType](/games/services/web/api/rest/v1/scores/get#IncludeRankType)`)` The types of ranks to return. If the parameter is omitted, no ranks will be returned. |\n| `maxResults` | `integer` The maximum number of leaderboard scores to return in the response. For any response, the actual number of leaderboard scores returned may be less than the specified `maxResults`. |\n| `pageToken` | `string` The token returned by the previous request. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [GetLeaderboardScoresResponse](/games/services/web/api/rest/v1/scores#GetLeaderboardScoresResponse).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/games`\n- `\n https://www.googleapis.com/auth/games_lite`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nScoreTimeSpan\n-------------\n\nDefines possible time spans for a score.\n\n| Enums ||\n|------------|---------------------------------------------------------------------------------------------|\n| `ALL` | Get the high scores for all time spans. If this is used, maxResults values will be ignored. |\n| `ALL_TIME` | Get the all time high score. |\n| `WEEKLY` | List the top scores for the current day. |\n| `DAILY` | List the top scores for the current week. |\n\nIncludeRankType\n---------------\n\nPossible values for rank type.\n\n| Enums ||\n|-----------|---------------------------------------------------------------------------------------------|\n| `ALL` | Retrieve all supported ranks. In HTTP, this parameter value can also be specified as `ALL`. |\n| `PUBLIC` | Retrieve public ranks, if the player is sharing their gameplay activity publicly. |\n| `SOCIAL` | (Obsolete) Retrieve the social rank. | This item is deprecated! |\n| `FRIENDS` | Retrieve the rank on the friends collection. |"]]
