Scores: reset
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
需要授权
重置当前已通过身份验证的玩家在具有指定 ID 的排行榜中的得分。只有已列入应用白名单的测试人员账号才能使用此方法。
请求
HTTP 请求
POST https://www.googleapis.com/games/v1management/leaderboards/leaderboardId/scores/reset
参数
参数名称 |
值 |
说明 |
路径参数 |
leaderboardId |
string |
排行榜的 ID。
|
授权
此请求需要获得以下范围的授权(详细了解身份验证和授权)。
范围 |
https://www.googleapis.com/auth/games |
请求正文
使用此方法时请勿提供请求正文。
响应
如果成功,此方法将返回以下结构的响应正文:
{
"kind": "gamesManagement#playerScoreResetResponse",
"definitionId": string,
"resetScoreTimeSpans": [
string
]
}
属性名称 |
值 |
说明 |
备注 |
kind |
string |
唯一标识此资源的类型。值始终为固定字符串 gamesManagement#playerScoreResetResponse 。 |
|
resetScoreTimeSpans[] |
list |
更新后的得分的跨度。 可能的值包括: - “
ALL_TIME ”- 得分是历史得分。 - “
WEEKLY ”- 得分是每周得分。 - “
DAILY ”- 得分是每日得分。 |
|
definitionId |
string |
玩家状态已更新的排行榜的 ID。 |
|
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-27。
[null,null,["最后更新时间 (UTC):2025-07-27。"],[],[],null,["# Scores: reset\n\n**Requires [authorization](#auth)**\n\nResets scores for the leaderboard 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/leaderboards/leaderboardId/scores/reset\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|-----------------|----------|----------------------------|\n| **Path parameters** |||\n| `leaderboardId` | `string` | The ID of the leaderboard. |\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#playerScoreResetResponse\",\n \"definitionId\": string,\n \"resetScoreTimeSpans\": [\n string\n ]\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#playerScoreResetResponse`. | |\n| `resetScoreTimeSpans[]` | `list` | The time spans of the updated score. Possible values are: - \"`ALL_TIME`\" - The score is an all-time score. - \"`WEEKLY`\" - The score is a weekly score. - \"`DAILY`\" - The score is a daily score. | |\n| `definitionId` | `string` | The ID of an leaderboard for which player state has been updated. | |"]]