Method: scores.submit
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Envia uma pontuação para a tabela de classificação especificada.
Solicitação HTTP
POST https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/scores
Parâmetros de caminho
| Parâmetros |
leaderboardId |
string
O ID da tabela de classificação.
|
Parâmetros de consulta
| Parâmetros |
language |
string
O idioma preferencial a ser usado para strings retornadas por esse método.
|
score |
string (int64 format)
Obrigatório. A pontuação que você está enviando. A pontuação enviada será ignorada se for pior do que uma pontuação enviada anteriormente, e o que é pior depende da ordem de classificação da tabela de classificação. O significado do valor da pontuação depende do tipo de formato da tabela de classificação. Para ponto fixo, a pontuação representa o valor bruto. Para o tempo, a pontuação representa o tempo decorrido em milissegundos. Para moedas, a pontuação representa um valor em microunidades.
|
scoreTag |
string
Informações adicionais sobre a pontuação que você está enviando. Os valores não podem conter mais de 64 caracteres seguros para URI, conforme definido na seção 2.3 do RFC 3986.
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Se a solicitação for concluída, o corpo da resposta terá uma instância de SubmitLeaderboardScoreResponse.
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Para mais informações, consulte a Visão geral do OAuth 2.0.
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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],null,["# Method: scores.submit\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nSubmits a score to the specified leaderboard.\n\n### HTTP request\n\n`POST https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/scores`\n\n### Path parameters\n\n| Parameters ||\n|-----------------|-------------------------------------|\n| `leaderboardId` | `string` The ID of the leaderboard. |\n\n### Query parameters\n\n| Parameters ||\n|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n| `score` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The score you're submitting. The submitted score is ignored if it is worse than a previously submitted score, where worse depends on the leaderboard sort order. The meaning of the score value depends on the leaderboard format type. For fixed-point, the score represents the raw value. For time, the score represents elapsed time in milliseconds. For currency, the score represents a value in micro units. |\n| `scoreTag` | `string` Additional information about the score you're submitting. Values must contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [SubmitLeaderboardScoreResponse](/games/services/web/api/rest/v1/SubmitLeaderboardScoreResponse).\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)."]]
