Achievements: reset
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
需要授權
針對目前已驗證的玩家,使用指定 ID 重設成就。只有已加入許可清單的測試人員帳戶才能使用這個方法。
要求
HTTP 要求
POST https://www.googleapis.com/games/v1management/achievements/achievementId/reset
參數
參數名稱 |
值 |
說明 |
路徑參數 |
achievementId |
string |
這個方法使用的成就 ID。
|
授權
此要求需要獲得下列範圍的授權 (進一步瞭解驗證和授權)。
範圍 |
https://www.googleapis.com/auth/games |
要求主體
請勿使用這個方法提供請求主體。
回應
如果成功的話,這個方法會傳回回應內文,其結構如下:
{
"kind": "gamesManagement#achievementResetResponse",
"definitionId": string,
"updateOccurred": boolean,
"currentState": string
}
屬性名稱 |
值 |
說明 |
附註 |
kind |
string |
專門用於識別這項資源的類型。值一律為固定字串 gamesManagement#achievementResetResponse 。 |
|
definitionId |
string |
已更新玩家狀態的成就 ID。 |
|
updateOccurred |
boolean |
用於表示要求的更新是否已確實完成的標記。 |
|
currentState |
string |
關卡目前的狀態。這與成就的初始狀態相同。 可能的值包括:- 「
HIDDEN 」- 已隱藏成就。 - 「
REVEALED 」- 顯示成就。 - 「
UNLOCKED 」- 解鎖成就。
|
|
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間:2025-07-27 (世界標準時間)。
[null,null,["上次更新時間:2025-07-27 (世界標準時間)。"],[],[],null,["# Achievements: reset\n\n**Requires [authorization](#auth)**\n\nResets the achievement with the given ID for the currently authenticated player. This method is only accessible to whitelisted tester accounts for your application.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/games/v1management/achievements/achievementId/reset\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|-----------------|----------|------------------------------------------------|\n| **Path parameters** |||\n| `achievementId` | `string` | The ID of the achievement used by this method. |\n\n### Authorization\n\nThis request requires authorization with the following scope ([read more about authentication and authorization](/accounts/docs/OAuth2)).\n\n| Scope |\n|-----------------------------------------|\n| `https://www.googleapis.com/auth/games` |\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"kind\": \"gamesManagement#achievementResetResponse\",\n \"definitionId\": string,\n \"updateOccurred\": boolean,\n \"currentState\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|------------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | Uniquely identifies the type of this resource. Value is always the fixed string `gamesManagement#achievementResetResponse`. | |\n| `definitionId` | `string` | The ID of an achievement for which player state has been updated. | |\n| `updateOccurred` | `boolean` | Flag to indicate if the requested update actually occurred. | |\n| `currentState` | `string` | The current state of the achievement. This is the same as the initial state of the achievement. Possible values are: - \"`HIDDEN`\"- Achievement is hidden. - \"`REVEALED`\" - Achievement is revealed. - \"`UNLOCKED`\" - Achievement is unlocked. | |"]]