Method: achievements.list

वर्तमान में प्रमाणित किए गए खिलाड़ी के लिए आपके ऐप्लिकेशन की सभी उपलब्धियों की प्रगति सूचीबद्ध करता है.

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

GET https://games.googleapis.com/games/v1/players/{playerId}/achievements

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

पैरामीटर
playerId

string

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

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

पैरामीटर
language

string

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

integer

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

string

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

enum (State)

सर्वर को बताता है कि सिर्फ़ तय की गई स्थिति वाली उपलब्धियां ही दिखाएं. अगर यह पैरामीटर तय नहीं किया गया है, तो सभी उपलब्धियां दिखाई जाती हैं.

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

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

जवाब का मुख्य भाग

उपलब्धि ऑब्जेक्ट की सूची.

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

जेएसओएन के काेड में दिखाना 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (PlayerAchievement)
    }
  ]
}
फ़ील्ड
kind

string

यह अलग-अलग तरीके से यह बताता है कि यह संसाधन किस तरह का है. वैल्यू हमेशा तय स्ट्रिंग games#playerAchievementListResponse होती है.
nextPageToken

string

नतीजों के अगले पेज से जुड़ा टोकन.
items[]

object (PlayerAchievement)

उपलब्धियां.

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

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

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

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

स्थिति

Enums
ALL सभी उपलब्धियों की सूची बनाएं. यह डिफ़ॉल्ट रूप से होता है.
HIDDEN सिर्फ़ छिपी हुई उपलब्धियों की सूची बनाएं.
REVEALED सिर्फ़ दिखाई गई उपलब्धियों की सूची बनाएं.
UNLOCKED सिर्फ़ अनलॉक की गई उपलब्धियों की सूची बनाएं.

PlayerAchievement

उपलब्धि का ऑब्जेक्ट.

जेएसओएन के काेड में दिखाना 
{
  "kind": string,
  "id": string,
  "currentSteps": integer,
  "formattedCurrentStepsString": string,
  "achievementState": enum (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
फ़ील्ड
kind

string

यह अलग-अलग तरीके से यह बताता है कि यह संसाधन किस तरह का है. वैल्यू हमेशा तय स्ट्रिंग games#playerAchievement होती है.
id

string

उपलब्धि का आईडी.
currentSteps

integer

किसी इंक्रीमेंटल (बढ़ने वाली) उपलब्धि के लिए मौजूदा चरण.
formattedCurrentStepsString

string

स्ट्रिंग के रूप में इंक्रीमेंटल (बढ़ने वाली) उपलब्धि के मौजूदा चरण.
achievementState

enum (State)

उपलब्धि की स्थिति.
lastUpdatedTimestamp

string (int64 format)

इस उपलब्धि की स्थिति में पिछली बार किए गए बदलाव का टाइमस्टैंप.
experiencePoints

string (int64 format)

उपलब्धि के लिए हासिल किए गए अनुभव के पॉइंट. यह फ़ील्ड उन उपलब्धियों के लिए मौजूद नहीं है जिन्हें अभी तक अनलॉक नहीं किया गया है. साथ ही, ऐसी उपलब्धियों के लिए यह फ़ील्ड मौजूद नहीं है जिन्हें टेस्टर ने अनलॉक कर दिया है, लेकिन वह पब्लिश नहीं हुई है.

स्थिति

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

Enums
HIDDEN उपलब्धि छिपी हुई है.
REVEALED उपलब्धि के बारे में पता चलता है.
UNLOCKED उपलब्धि अनलॉक की गई है.