Method: scores.submitMultiple
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Envía varias puntuaciones a las tablas de clasificación.
Solicitud HTTP
POST https://games.googleapis.com/games/v1/leaderboards/scores
Parámetros de consulta
Parámetros |
language |
string
Es el idioma preferido para usar en las cadenas que muestra este método.
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de PlayerScoreSubmissionList
.
Cuerpo de la respuesta
Una lista de los estados de envío de puntuaciones.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Campos |
kind |
string
Identifica de forma única el tipo de este recurso. El valor siempre es la cadena fija games#playerScoreListResponse .
|
submittedScores[] |
object (SubmitLeaderboardScoreResponse )
Los estados de los envíos de puntuación
|
Permisos de autorización
Se requiere uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Para obtener más información, consulta la descripción general de OAuth 2.0.
PlayerScoreSubmissionList
Una lista de solicitudes de envío de calificaciones.
Representación JSON |
{
"kind": string,
"scores": [
{
object (ScoreSubmission )
}
]
} |
Campos |
kind |
string
Identifica de forma única el tipo de este recurso. El valor siempre es la cadena fija games#playerScoreSubmissionList .
|
scores[] |
object (ScoreSubmission )
Los envíos de puntuación
|
ScoreSubmission
Una solicitud para enviar una puntuación a las tablas de clasificación.
Representación JSON |
{
"kind": string,
"leaderboardId": string,
"score": string,
"scoreTag": string,
"signature": string
} |
Campos |
kind |
string
Identifica de forma única el tipo de este recurso. El valor siempre es la cadena fija games#scoreSubmission .
|
leaderboardId |
string
La tabla de clasificación a la que se enviará esta puntuación.
|
score |
string (int64 format)
La nueva puntuación que se enviará
|
scoreTag |
string
Información adicional sobre esta puntuación. Los valores no contendrán más de 64 caracteres seguros para URI, como se define en la sección 2.3 de RFC 3986.
|
signature |
string
Los valores de la firma contendrán caracteres seguros para URIs, como se define en la sección 2.3 de la RFC 3986.
|
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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. |"]]