Method: achievements.reveal
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
وضعیت دستاورد با شناسه داده شده را برای پخش کننده تأیید شده فعلی روی REVEALED تنظیم می کند.
درخواست HTTP
POST https://games.googleapis.com/games/v1/achievements/{achievementId}/reveal
پارامترهای مسیر
| پارامترها |
|---|
achievementId | string شناسه دستاورد مورد استفاده در این روش. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
یک دستاورد آشکار پاسخ
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| فیلدها |
|---|
kind | string منحصر به فرد نوع این منبع را شناسایی می کند. ارزش همیشه games#achievementRevealResponse . |
currentState | enum ( RevealAchievementState ) وضعیت فعلی دستاوردی که برای افشای آن تلاش شده است. اگر قفل دستاورد قبلاً باز شده باشد، ممکن است UNLOCKED آن باز شود. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/games -
https://www.googleapis.com/auth/games_lite
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
RevealAchievementState
| Enums |
|---|
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.reveal\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.RevealAchievementResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [RevealAchievementState](#RevealAchievementState)\n- [Try it!](#try-it)\n\nSets the state of the achievement with the given ID to `REVEALED` for the currently authenticated player.\n\n### HTTP request\n\n`POST https://games.googleapis.com/games/v1/achievements/{achievementId}/reveal`\n\n### Path parameters\n\n| Parameters ||\n|-----------------|---------------------------------------------------------|\n| `achievementId` | `string` The ID of the achievement used by this method. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nAn achievement reveal response\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"currentState\": enum (/games/services/web/api/rest/v1/achievements/reveal#RevealAchievementState) } ``` |\n\n| Fields ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#achievementRevealResponse`. |\n| `currentState` | `enum (`[RevealAchievementState](/games/services/web/api/rest/v1/achievements/reveal#RevealAchievementState)`)` The current state of the achievement for which a reveal was attempted. This might be `UNLOCKED` if the achievement was already unlocked. |\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\nRevealAchievementState\n----------------------\n\nPossible reveal achievement states.\n\n| Enums ||\n|------------|--------------------------|\n| `REVEALED` | Achievement is revealed. |\n| `UNLOCKED` | Achievement is unlocked. |"]]
