Scores: reset
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Requer autorização
Redefine as pontuações da tabela de classificação com o ID fornecido para o jogador autenticado. Esse método só é acessível para contas de testador na lista de permissões do seu app.
Solicitar
Solicitação HTTP
POST https://www.googleapis.com/games/v1management/leaderboards/leaderboardId/scores/reset
Parâmetros
| Nome do parâmetro |
Valor |
Descrição |
| Parâmetros de caminho |
leaderboardId |
string |
O ID da tabela de classificação.
|
Autorização
Esta solicitação requer autorização com o seguinte escopo (saiba mais sobre autenticação e autorização).
| Escopo |
|---|
https://www.googleapis.com/auth/games |
Corpo da solicitação
Não forneça um corpo de solicitação com este método.
Resposta
Se for bem-sucedido, este método retorna um corpo de resposta com a seguinte estrutura:
{
"kind": "gamesManagement#playerScoreResetResponse",
"definitionId": string,
"resetScoreTimeSpans": [
string
]
}
| Nome da propriedade |
Valor |
Descrição |
Observações |
kind |
string |
Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa gamesManagement#playerScoreResetResponse. |
|
resetScoreTimeSpans[] |
list |
O período de tempo do placar atualizado.
Os valores possíveis são: - "
ALL_TIME": a pontuação é de todos os tempos. - "
WEEKLY": a pontuação é semanal. - "
DAILY": a pontuação é diária. |
|
definitionId |
string |
O ID de uma tabela de classificação em que o estado do jogador foi atualizado. |
|
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[null,null,["Última atualização 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. | |"]]
