Method: achievements.reveal
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Legt den Status des Erfolgs mit der angegebenen ID für den derzeit authentifizierten Spieler auf REVEALED fest.
HTTP-Anfrage
POST https://games.googleapis.com/games/v1/achievements/{achievementId}/reveal
Pfadparameter
| Parameter |
achievementId |
string
Die ID des von dieser Methode verwendeten Erfolgs.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwort auf Enthüllung eines Erfolgs
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| Felder |
kind |
string
Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#achievementRevealResponse.
|
currentState |
enum (RevealAchievementState)
Der aktuelle Status des Erfolgs, für den eine Offenlegung versucht wurde. Der Wert könnte UNLOCKED lauten, wenn der Erfolg bereits freigeschaltet wurde.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
RevealAchievementState
Mögliche Statuswerte für Erfolge
| Enums |
REVEALED |
Der Erfolg wurde aufgedeckt. |
UNLOCKED |
Erfolg wurde freigeschaltet. |
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-07-27 (UTC)."],[],[],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. |"]]
