Method: scores.submitMultiple
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
HTTP 요청
POST https://games.googleapis.com/games/v1/leaderboards/scores
쿼리 매개변수
매개변수 |
language |
string
이 메서드에서 반환된 문자열에 사용할 기본 언어입니다.
|
요청 본문
요청 본문에는 PlayerScoreSubmissionList
의 인스턴스가 포함됩니다.
응답 본문
점수 제출 상태 목록입니다.
성공하면 응답 본문에 다음과 같은 구조의 데이터가 포함됩니다.
필드 |
kind |
string
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#playerScoreListResponse 입니다.
|
submittedScores[] |
object (SubmitLeaderboardScoreResponse )
점수 제출 상태입니다.
|
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
자세한 내용은 OAuth 2.0 개요를 참고하세요.
PlayerScoreSubmissionList
필드 |
kind |
string
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#playerScoreSubmissionList 입니다.
|
scores[] |
object (ScoreSubmission )
점수 제출
|
ScoreSubmission
JSON 표현 |
{
"kind": string,
"leaderboardId": string,
"score": string,
"scoreTag": string,
"signature": string
} |
필드 |
kind |
string
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#scoreSubmission 입니다.
|
leaderboardId |
string
이 점수가 제출되는 순위표입니다.
|
score |
string (int64 format)
새 점수가 제출됩니다.
|
scoreTag |
string
이 점수에 관한 추가 정보입니다. 값은 RFC 3986 섹션 2.3에 정의된 대로 URI 안전 문자를 64자(영문 기준) 이하여야 합니다.
|
signature |
string
서명 값에는 RFC 3986 섹션 2.3에 정의된 URI 안전 문자가 포함됩니다.
|
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 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. |"]]