Method: achievementDefinitions.list
संग्रह की मदद से व्यवस्थित रहें
अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
इसमें आपके ऐप्लिकेशन की उपलब्धि की सभी परिभाषाएं दी गई हैं.
एचटीटीपी अनुरोध
GET https://games.googleapis.com/games/v1/achievements
क्वेरी पैरामीटर
पैरामीटर |
language |
string
इस तरीके से दिखाई जाने वाली स्ट्रिंग के लिए इस्तेमाल की जाने वाली पसंदीदा भाषा.
|
maxResults |
integer
जवाब में दिए जाने वाले उपलब्धि संसाधनों की ज़्यादा से ज़्यादा संख्या, जिसका इस्तेमाल पेजिंग के लिए किया जाता है. किसी भी जवाब के लिए, दिए गए उपलब्धि संसाधनों की असली संख्या, maxResults से कम हो सकती है.
|
pageToken |
string
पिछले अनुरोध पर मिला टोकन.
|
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
उपलब्धि को तय करने वाले ऑब्जेक्ट की सूची.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
{
"kind": string,
"nextPageToken": string,
"items": [
{
object (AchievementDefinition )
}
]
} |
फ़ील्ड |
kind |
string
इस संसाधन के टाइप की अलग-अलग पहचान करता है. यह वैल्यू हमेशा तय की गई स्ट्रिंग games#achievementDefinitionsListResponse होती है.
|
nextPageToken |
string
नतीजों के अगले पेज के साथ काम करने वाला टोकन.
|
items[] |
object (AchievementDefinition )
उपलब्धि की परिभाषाएं.
|
अनुमति के दायरे
इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
AchievementDefinition
उपलब्धि की परिभाषा का ऑब्जेक्ट.
JSON के काेड में दिखाना |
{
"kind": string,
"id": string,
"name": string,
"description": string,
"achievementType": enum (AchievementType ),
"totalSteps": integer,
"formattedTotalSteps": string,
"revealedIconUrl": string,
"isRevealedIconUrlDefault": boolean,
"unlockedIconUrl": string,
"isUnlockedIconUrlDefault": boolean,
"initialState": enum (InitialAchievementState ),
"experiencePoints": string
} |
फ़ील्ड |
kind |
string
इस संसाधन के टाइप की अलग-अलग पहचान करता है. यह वैल्यू हमेशा तय की गई स्ट्रिंग games#achievementDefinition होती है.
|
id |
string
उपलब्धि का आईडी.
|
name |
string
उपलब्धि का नाम.
|
description |
string
उपलब्धि का ब्यौरा.
|
achievementType |
enum (AchievementType )
उपलब्धि का टाइप.
|
totalSteps |
integer
इंक्रीमेंटल (बढ़ने वाली) उपलब्धि के कुल चरण.
|
formattedTotalSteps |
string
स्ट्रिंग के तौर पर इंक्रीमेंटल (बढ़ने वाली) उपलब्धि के कुल चरण.
|
revealedIconUrl |
string
उपलब्धि के बारे में बताने वाले आइकॉन की इमेज का यूआरएल.
|
isRevealedIconUrlDefault |
boolean
इससे पता चलता है कि दिखाई जा रही इमेज, डिफ़ॉल्ट इमेज है या गेम ने इसे उपलब्ध कराया है.
|
unlockedIconUrl |
string
अनलॉक किए गए उपलब्धि आइकॉन के लिए, इमेज का यूआरएल.
|
isUnlockedIconUrlDefault |
boolean
इससे पता चलता है कि अनलॉक किए गए आइकॉन की इमेज, डिफ़ॉल्ट इमेज है या किसी गेम के लिए उपलब्ध कराई गई है.
|
initialState |
enum (InitialAchievementState )
उपलब्धि की शुरुआती स्थिति.
|
experiencePoints |
string (int64 format)
अनुभव के पॉइंट जो इस उपलब्धि को अनलॉक करने पर मिलेंगे.
|
AchievementType
उपलब्धि के संभावित प्रकार.
Enums |
STANDARD |
उपलब्धि को लॉक किया गया है या अनलॉक किया गया है. |
INCREMENTAL |
उपलब्धि लगातार बढ़ती जा रही है. |
InitialAchievementState
उपलब्धि की शुरुआती संभावित स्थितियां.
Enums |
HIDDEN |
उपलब्धि छिपी हुई है. |
REVEALED |
उपलब्धि के बारे में बताया जाता है. |
UNLOCKED |
उपलब्धि अनलॉक है. |
इस पेज पर मौजूद कॉन्टेंट और कोड सैंपल कॉन्टेंट के लाइसेंस में बताए गए लाइसेंस के हिसाब से हैं. Java और OpenJDK, Oracle और/या इससे जुड़ी हुई कंपनियों के ट्रेडमार्क या रजिस्टर किए हुए ट्रेडमार्क हैं.
आखिरी बार 2025-07-27 (UTC) को अपडेट किया गया.
[[["समझने में आसान है","easyToUnderstand","thumb-up"],["मेरी समस्या हल हो गई","solvedMyProblem","thumb-up"],["अन्य","otherUp","thumb-up"]],[["वह जानकारी मौजूद नहीं है जो मुझे चाहिए","missingTheInformationINeed","thumb-down"],["बहुत मुश्किल है / बहुत सारे चरण हैं","tooComplicatedTooManySteps","thumb-down"],["पुराना","outOfDate","thumb-down"],["अनुवाद से जुड़ी समस्या","translationIssue","thumb-down"],["सैंपल / कोड से जुड़ी समस्या","samplesCodeIssue","thumb-down"],["अन्य","otherDown","thumb-down"]],["आखिरी बार 2025-07-27 (UTC) को अपडेट किया गया."],[],[],null,["# Method: achievementDefinitions.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListAchievementDefinitionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [AchievementDefinition](#AchievementDefinition)\n - [JSON representation](#AchievementDefinition.SCHEMA_REPRESENTATION)\n- [AchievementType](#AchievementType)\n- [InitialAchievementState](#InitialAchievementState)\n- [Try it!](#try-it)\n\nLists all the achievement definitions for your application.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/achievements`\n\n### Query parameters\n\n| Parameters ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n| `maxResults` | `integer` The maximum number of achievement resources to return in the response, used for paging. For any response, the actual number of achievement resources 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\nA list of achievement definition objects.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"nextPageToken\": string, \"items\": [ { object (/games/services/web/api/rest/v1/achievementDefinitions/list#AchievementDefinition) } ] } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#achievementDefinitionsListResponse`. |\n| `nextPageToken` | `string` Token corresponding to the next page of results. |\n| `items[]` | `object (`[AchievementDefinition](/games/services/web/api/rest/v1/achievementDefinitions/list#AchievementDefinition)`)` The achievement definitions. |\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\nAchievementDefinition\n---------------------\n\nAn achievement definition object.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"id\": string, \"name\": string, \"description\": string, \"achievementType\": enum (/games/services/web/api/rest/v1/achievementDefinitions/list#AchievementType), \"totalSteps\": integer, \"formattedTotalSteps\": string, \"revealedIconUrl\": string, \"isRevealedIconUrlDefault\": boolean, \"unlockedIconUrl\": string, \"isUnlockedIconUrlDefault\": boolean, \"initialState\": enum (/games/services/web/api/rest/v1/achievementDefinitions/list#InitialAchievementState), \"experiencePoints\": string } ``` |\n\n| Fields ||\n|----------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#achievementDefinition`. |\n| `id` | `string` The ID of the achievement. |\n| `name` | `string` The name of the achievement. |\n| `description` | `string` The description of the achievement. |\n| `achievementType` | `enum (`[AchievementType](/games/services/web/api/rest/v1/achievementDefinitions/list#AchievementType)`)` The type of the achievement. |\n| `totalSteps` | `integer` The total steps for an incremental achievement. |\n| `formattedTotalSteps` | `string` The total steps for an incremental achievement as a string. |\n| `revealedIconUrl` | `string` The image URL for the revealed achievement icon. |\n| `isRevealedIconUrlDefault` | `boolean` Indicates whether the revealed icon image being returned is a default image, or is provided by the game. |\n| `unlockedIconUrl` | `string` The image URL for the unlocked achievement icon. |\n| `isUnlockedIconUrlDefault` | `boolean` Indicates whether the unlocked icon image being returned is a default image, or is game-provided. |\n| `initialState` | `enum (`[InitialAchievementState](/games/services/web/api/rest/v1/achievementDefinitions/list#InitialAchievementState)`)` The initial state of the achievement. |\n| `experiencePoints` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Experience points which will be earned when unlocking this achievement. |\n\nAchievementType\n---------------\n\nPossible achievement types.\n\n| Enums ||\n|---------------|-------------------------------------------|\n| `STANDARD` | Achievement is either locked or unlocked. |\n| `INCREMENTAL` | Achievement is incremental. |\n\nInitialAchievementState\n-----------------------\n\nPossible initial states of an achievement.\n\n| Enums ||\n|------------|--------------------------|\n| `HIDDEN` | Achievement is hidden. |\n| `REVEALED` | Achievement is revealed. |\n| `UNLOCKED` | Achievement is unlocked. |"]]