Method: scores.get

पुष्टि किए गए मौजूदा खिलाड़ी के लिए लीडरबोर्ड में सबसे ज़्यादा स्कोर और वैकल्पिक रैंक पाएं. किसी खास समयावधि के लिए, leaderboardId को ALL पर सेट किया जा सकता है, ताकि दी गई समयावधि में सभी लीडरबोर्ड का डेटा वापस लाया जा सके. `ध्यान दें: एक ही अनुरोध में, 'सभी' लीडरबोर्ड और 'सभी' टाइमस्पैन का अनुरोध नहीं किया जा सकता; 'सभी' पर सिर्फ़ एक पैरामीटर सेट किया जा सकता है.

एचटीटीपी अनुरोध

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

पाथ के पैरामीटर

पैरामीटर
playerId

string

प्लेयर आईडी. पुष्टि किए गए खिलाड़ी के आईडी की जगह, me की वैल्यू का इस्तेमाल किया जा सकता है.
leaderboardId

string

लीडरबोर्ड का आईडी. इस ऐप्लिकेशन के सभी लीडरबोर्ड का डेटा पाने के लिए, इसे 'सभी' पर सेट किया जा सकता है.
timeSpan

enum (ScoreTimeSpan)

आपके द्वारा अनुरोध किए जा रहे स्कोर और रैंक के लिए समयावधि.

क्वेरी पैरामीटर

पैरामीटर
language

string

इस तरीके से दिखाई गई स्ट्रिंग के लिए, इस्तेमाल की जाने वाली पसंदीदा भाषा.
includeRankType

enum (IncludeRankType)

कितनी तरह की रैंक दी जानी है. अगर पैरामीटर को छोड़ दिया जाता है, तो कोई रैंक नहीं दिखेगी.
maxResults

integer

जवाब में लौटाए जाने वाले लीडरबोर्ड स्कोर की ज़्यादा से ज़्यादा संख्या. किसी भी जवाब के लिए, दिखाए गए लीडरबोर्ड स्कोर की असल संख्या, बताई गई maxResults से कम हो सकती है.
pageToken

string

पिछले अनुरोध पर टोकन मिला.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य हिस्सा

कामयाब रहने पर, जवाब के मुख्य हिस्से में GetLeaderboardScoresResponse का एक इंस्टेंस शामिल किया जाता है.

अनुमति देने के दायरे

इनमें से कोई एक OAuth स्कोप ज़रूरी है:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

ScoreTimeSpan

स्कोर के लिए संभावित समयावधि के बारे में बताता है.

Enums
ALL किसी भी समयावधि के लिए सबसे ज़्यादा स्कोर पाएं. अगर इसका इस्तेमाल किया जाता है, तो maxresults वैल्यू को अनदेखा कर दिया जाएगा.
ALL_TIME अब तक का सबसे ज़्यादा स्कोर पाएं.
WEEKLY आज के दिन के लिए, सबसे ज़्यादा स्कोर की सूची बनाएं.
DAILY मौजूदा हफ़्ते के सबसे ज़्यादा स्कोर की सूची बनाएं.

IncludeRankType

रैंक टाइप के लिए संभावित वैल्यू.

Enums
ALL सभी समर्थित रैंक वापस पाएं. एचटीटीपी में, इस पैरामीटर वैल्यू को ALL के तौर पर भी बताया जा सकता है.
PUBLIC अगर खिलाड़ी अपनी गेमप्ले गतिविधि को सार्वजनिक रूप से शेयर कर रहा है, तो सार्वजनिक रैंक वापस पाएं.
SOCIAL

(पुराना) सामाजिक रैंक फिर से पाएं.
FRIENDS दोस्तों के संग्रह से दोबारा रैंक पाएं.