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)

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

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

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

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

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

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

JSON के काेड में दिखाना 
{
  "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

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

JSON के काेड में दिखाना 
{
  "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 उपलब्धि अनलॉक है.