Method: scores.submitMultiple
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Envia várias pontuações para os placares.
Solicitação HTTP
POST https://games.googleapis.com/games/v1/leaderboards/scores
Parâmetros de consulta
Parâmetros |
language |
string
O idioma preferencial a ser usado para strings retornadas por esse método.
|
Corpo da solicitação
O corpo da solicitação contém uma instância de PlayerScoreSubmissionList
.
Corpo da resposta
Uma lista de status de envio de pontuação.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Campos |
kind |
string
Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#playerScoreListResponse .
|
submittedScores[] |
object (SubmitLeaderboardScoreResponse )
Os status dos envios de pontuação.
|
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.
PlayerScoreSubmissionList
Uma lista de solicitações de envio de pontuação.
Representação JSON |
{
"kind": string,
"scores": [
{
object (ScoreSubmission )
}
]
} |
Campos |
kind |
string
Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#playerScoreSubmissionList .
|
scores[] |
object (ScoreSubmission )
Os envios de pontuação.
|
Pontuação da submissão
Uma solicitação para enviar uma pontuação para os placares.
Representação JSON |
{
"kind": string,
"leaderboardId": string,
"score": string,
"scoreTag": string,
"signature": string
} |
Campos |
kind |
string
Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#scoreSubmission .
|
leaderboardId |
string
A tabela de classificação para a qual a pontuação está sendo enviada.
|
score |
string (int64 format)
A nova pontuação sendo enviada.
|
scoreTag |
string
Outras informações sobre essa pontuação. Os valores não podem ter mais de 64 caracteres seguros para URI, conforme definido na seção 2.3 do RFC 3986.
|
signature |
string
Os valores de assinatura vão conter caracteres seguros para URI, conforme definido na seção 2.3 do RFC 3986.
|
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.submitMultiple\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.SubmitMultipleLeaderboardScoresResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [PlayerScoreSubmissionList](#PlayerScoreSubmissionList)\n - [JSON representation](#PlayerScoreSubmissionList.SCHEMA_REPRESENTATION)\n- [ScoreSubmission](#ScoreSubmission)\n - [JSON representation](#ScoreSubmission.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nSubmits multiple scores to leaderboards.\n\n### HTTP request\n\n`POST https://games.googleapis.com/games/v1/leaderboards/scores`\n\n### Query parameters\n\n| Parameters ||\n|------------|-----------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n\n### Request body\n\nThe request body contains an instance of [PlayerScoreSubmissionList](/games/services/web/api/rest/v1/scores/submitMultiple#PlayerScoreSubmissionList).\n\n### Response body\n\nA list of score submission statuses.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"submittedScores\": [ { object (/games/services/web/api/rest/v1/SubmitLeaderboardScoreResponse) } ] } ``` |\n\n| Fields ||\n|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#playerScoreListResponse`. |\n| `submittedScores[]` | `object (`[SubmitLeaderboardScoreResponse](/games/services/web/api/rest/v1/SubmitLeaderboardScoreResponse)`)` The score submissions statuses. |\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).\n\nPlayerScoreSubmissionList\n-------------------------\n\nA list of score submission requests.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"scores\": [ { object (/games/services/web/api/rest/v1/scores/submitMultiple#ScoreSubmission) } ] } ``` |\n\n| Fields ||\n|------------|------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#playerScoreSubmissionList`. |\n| `scores[]` | `object (`[ScoreSubmission](/games/services/web/api/rest/v1/scores/submitMultiple#ScoreSubmission)`)` The score submissions. |\n\nScoreSubmission\n---------------\n\nA request to submit a score to leaderboards.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"leaderboardId\": string, \"score\": string, \"scoreTag\": string, \"signature\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#scoreSubmission`. |\n| `leaderboardId` | `string` The leaderboard this score is being submitted to. |\n| `score` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The new score being submitted. |\n| `scoreTag` | `string` Additional information about this score. Values will contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986. |\n| `signature` | `string` Signature Values will contain URI-safe characters as defined by section 2.3 of RFC 3986. |"]]