Method: scores.submitMultiple
Stay organized with collections
Save and categorize content based on your preferences.
Submits multiple scores to leaderboards.
HTTP request
POST https://games.googleapis.com/games/v1/leaderboards/scores
Query parameters
Parameters |
language |
string
The preferred language to use for strings returned by this method.
|
Request body
The request body contains an instance of PlayerScoreSubmissionList
.
Response body
A list of score submission statuses.
If successful, the response body contains data with the following structure:
Fields |
kind |
string
Uniquely identifies the type of this resource. Value is always the fixed string games#playerScoreListResponse .
|
submittedScores[] |
object (SubmitLeaderboardScoreResponse )
The score submissions statuses.
|
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
For more information, see the OAuth 2.0 Overview.
PlayerScoreSubmissionList
A list of score submission requests.
JSON representation |
{
"kind": string,
"scores": [
{
object (ScoreSubmission )
}
]
} |
Fields |
kind |
string
Uniquely identifies the type of this resource. Value is always the fixed string games#playerScoreSubmissionList .
|
scores[] |
object (ScoreSubmission )
The score submissions.
|
ScoreSubmission
A request to submit a score to leaderboards.
JSON representation |
{
"kind": string,
"leaderboardId": string,
"score": string,
"scoreTag": string,
"signature": string
} |
Fields |
kind |
string
Uniquely identifies the type of this resource. Value is always the fixed string games#scoreSubmission .
|
leaderboardId |
string
The leaderboard this score is being submitted to.
|
score |
string (int64 format)
The new score being submitted.
|
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.
|
signature |
string
Signature Values will contain URI-safe characters as defined by section 2.3 of RFC 3986.
|
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2024-10-28 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-28 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. |"]]