Scores: reset
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Autorisierung erforderlich
Setzt die Punktzahlen für die Bestenliste mit der angegebenen ID für den aktuell authentifizierten Spieler zurück. Diese Methode ist nur für Testerkonten auf der Zulassungsliste für Ihre Anwendung verfügbar.
Anfrage
HTTP-Anfrage
POST https://www.googleapis.com/games/v1management/leaderboards/leaderboardId/scores/reset
Parameter
| Parametername |
Wert |
Beschreibung |
| Pfadparameter |
leaderboardId |
string |
ID der Bestenliste.
|
Autorisierung
Für diese Anfrage ist eine Autorisierung in folgendem Bereich erforderlich. Weitere Informationen zur Authentifizierung und Autorisierung
| Umfang |
|---|
https://www.googleapis.com/auth/games |
Anfragetext
Mit dieser Methode keinen Anfragetext bereitstellen.
Antwort
Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:
{
"kind": "gamesManagement#playerScoreResetResponse",
"definitionId": string,
"resetScoreTimeSpans": [
string
]
}
| Name der Eigenschaft |
Wert |
Beschreibung |
Hinweise |
kind |
string |
Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String gamesManagement#playerScoreResetResponse. |
|
resetScoreTimeSpans[] |
list |
Die Zeiträume der aktualisierten Bewertung.
Mögliche Werte sind: - „
ALL_TIME“ - Die Punktzahl ist eine Gesamtpunktzahl. - „
WEEKLY“ - Die Punktzahl ist eine wöchentliche Punktzahl. - „
DAILY“ - Der Index ist ein Tageswert. |
|
definitionId |
string |
ID einer Bestenliste, für die der Spielerstatus aktualisiert wurde |
|
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).
[null,null,["Zuletzt aktualisiert: 2025-07-27 (UTC)."],[],[],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. | |"]]
