Method: achievements.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
پیشرفت همه دستاوردهای برنامه شما را برای پخش کننده تأیید شده فعلی فهرست می کند.
درخواست HTTP
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) امتیازات تجربه کسب شده برای دستاورد. این فیلد برای دستاوردهایی که هنوز قفل نشده اند و 0 برای دستاوردهایی که توسط آزمایش کنندگان باز شده اما منتشر نشده اند وجود ندارد. |
ایالت
حالات احتمالی یک دستاورد را تعریف می کند.
| Enums |
|---|
HIDDEN | دستاورد پنهان است. |
REVEALED | دستاورد آشکار می شود. |
UNLOCKED | قفل دستاورد باز شده است. |
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: achievements.list\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 - [JSON representation](#body.ListAchievementsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [State](#State)\n- [PlayerAchievement](#PlayerAchievement)\n - [JSON representation](#PlayerAchievement.SCHEMA_REPRESENTATION)\n- [State](#State_1)\n- [Try it!](#try-it)\n\nLists the progress for all your application's achievements for the currently authenticated player.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/players/{playerId}/achievements`\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\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| `state` | `enum (`[State](/games/services/web/api/rest/v1/achievements/list#State)`)` Tells the server to return only achievements with the specified state. If this parameter isn't specified, all achievements are returned. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of achievement 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/achievements/list#PlayerAchievement) } ] } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#playerAchievementListResponse`. |\n| `nextPageToken` | `string` Token corresponding to the next page of results. |\n| `items[]` | `object (`[PlayerAchievement](/games/services/web/api/rest/v1/achievements/list#PlayerAchievement)`)` The achievements. |\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\nState\n-----\n\n| Enums ||\n|------------|---------------------------------------------|\n| `ALL` | List all achievements. This is the default. |\n| `HIDDEN` | List only hidden achievements. |\n| `REVEALED` | List only revealed achievements. |\n| `UNLOCKED` | List only unlocked achievements. |\n\nPlayerAchievement\n-----------------\n\nAn achievement object.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"id\": string, \"currentSteps\": integer, \"formattedCurrentStepsString\": string, \"achievementState\": enum (/games/services/web/api/rest/v1/achievements/list#State_1), \"lastUpdatedTimestamp\": string, \"experiencePoints\": string } ``` |\n\n| Fields ||\n|-------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#playerAchievement`. |\n| `id` | `string` The ID of the achievement. |\n| `currentSteps` | `integer` The current steps for an incremental achievement. |\n| `formattedCurrentStepsString` | `string` The current steps for an incremental achievement as a string. |\n| `achievementState` | `enum (`[State](/games/services/web/api/rest/v1/achievements/list#State_1)`)` The state of the achievement. |\n| `lastUpdatedTimestamp` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The timestamp of the last modification to this achievement's state. |\n| `experiencePoints` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Experience points earned for the achievement. This field is absent for achievements that have not yet been unlocked and 0 for achievements that have been unlocked by testers but that are unpublished. |\n\nState\n-----\n\nDefines possible states of an achievement.\n\n| Enums ||\n|------------|--------------------------|\n| `HIDDEN` | Achievement is hidden. |\n| `REVEALED` | Achievement is revealed. |\n| `UNLOCKED` | Achievement is unlocked. |"]]
