- HTTP request
- Query parameters
- Request body
- Response body
- Authorization scopes
- PlayerScoreSubmissionList
- ScoreSubmission
- Try it!
Submits multiple scores to leaderboards.
HTTP request
POST https://games.googleapis.com/games/v1/leaderboards/scores
Query parameters
| Parameters | |
|---|---|
| language | 
 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:
| JSON representation | 
|---|
| {
  "kind": string,
  "submittedScores": [
    {
      object ( | 
| Fields | |
|---|---|
| kind | 
 Uniquely identifies the type of this resource. Value is always the fixed string  | 
| submittedScores[] | 
 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 ( | 
| Fields | |
|---|---|
| kind | 
 Uniquely identifies the type of this resource. Value is always the fixed string  | 
| scores[] | 
 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 | 
 Uniquely identifies the type of this resource. Value is always the fixed string  | 
| leaderboardId | 
 The leaderboard this score is being submitted to. | 
| score | 
 The new score being submitted. | 
| scoreTag | 
 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 | 
 Signature Values will contain URI-safe characters as defined by section 2.3 of RFC 3986. | 
