REST Resource: scores
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: GetLeaderboardScoresResponse
JSON 표현 |
{
"kind": string,
"nextPageToken": string,
"player": {
object (Player )
},
"items": [
{
object (LeaderboardScore )
}
]
} |
필드 |
kind |
string
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#playerLeaderboardScoreListResponse 입니다.
|
nextPageToken |
string
결과의 다음 페이지에 대한 페이지 나누기 토큰입니다.
|
player |
object (Player )
이 점수의 소유자에 대한 플레이어 리소스입니다.
|
items[] |
object (LeaderboardScore )
리더보드 점수
|
LeaderboardScore
필드 |
kind |
string
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#playerLeaderboardScore 입니다.
|
leaderboard_id |
string
이 점수가 포함된 리더보드의 ID입니다.
|
scoreValue |
string (int64 format)
이 점수의 숫자 값입니다.
|
scoreString |
string
이 점수의 형식이 지정된 값입니다.
|
publicRank |
object (LeaderboardScoreRank )
이 리더보드에서 점수의 공개 순위입니다. 사용자가 점수를 공개적으로 공유하지 않는 경우 이 객체는 표시되지 않습니다.
|
socialRank |
object (LeaderboardScoreRank )
이 리더보드에서 점수의 소셜 순위입니다.
|
friendsRank |
object (LeaderboardScoreRank )
이 리더보드의 친구 컬렉션에서 점수의 순위입니다.
|
timeSpan |
enum (ScoreTimeSpan )
이 점수의 기간입니다.
|
writeTimestamp |
string (int64 format)
이 점수가 기록된 타임스탬프입니다(UTC 기준 에포크 이후 밀리초).
|
scoreTag |
string
점수에 대한 추가 정보입니다. 값은 RFC 3986 섹션 2.3에 정의된 대로 URI 안전 문자를 64자(영문 기준) 이하여야 합니다.
|
LeaderboardScoreRank
JSON 표현 |
{
"kind": string,
"rank": string,
"formattedRank": string,
"numScores": string,
"formattedNumScores": string
} |
필드 |
kind |
string
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#leaderboardScoreRank 입니다.
|
rank |
string (int64 format)
리더보드 순위입니다.
|
formattedRank |
string
리더보드 순위(문자열)입니다.
|
numScores |
string (int64 format)
리더보드의 점수 수입니다.
|
formattedNumScores |
string
리더보드의 점수 수를 문자열로 나타냅니다.
|
ScoreTimeSpan
Enum |
ALL_TIME |
점수는 역대 점수입니다. |
WEEKLY |
점수는 주간 점수입니다. |
DAILY |
점수는 일일 점수입니다. |
메서드 |
|
현재 인증된 플레이어의 리더보드에서 최고점수와 원하는 경우 순위를 가져옵니다. |
|
리더보드에 점수를 표시합니다(상단부터). |
|
리더보드에 플레이어의 점수와 그 주변의 점수를 표시합니다. |
|
지정된 리더보드에 점수를 제출합니다. |
|
리더보드에 여러 점수를 제출합니다. |
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 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,["# REST Resource: scores\n\n- [Resource: GetLeaderboardScoresResponse](#GetLeaderboardScoresResponse)\n - [JSON representation](#GetLeaderboardScoresResponse.SCHEMA_REPRESENTATION)\n- [LeaderboardScore](#LeaderboardScore)\n - [JSON representation](#LeaderboardScore.SCHEMA_REPRESENTATION)\n- [LeaderboardScoreRank](#LeaderboardScoreRank)\n - [JSON representation](#LeaderboardScoreRank.SCHEMA_REPRESENTATION)\n- [ScoreTimeSpan](#ScoreTimeSpan)\n- [Methods](#METHODS_SUMMARY)\n\nResource: GetLeaderboardScoresResponse\n--------------------------------------\n\nA list of player leaderboard scores.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"nextPageToken\": string, \"player\": { object (/games/services/web/api/rest/v1/players#Player) }, \"items\": [ { object (/games/services/web/api/rest/v1/scores#LeaderboardScore) } ] } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLeaderboardScoreListResponse`. |\n| `nextPageToken` | `string` The pagination token for the next page of results. |\n| `player` | `object (`[Player](/games/services/web/api/rest/v1/players#Player)`)` The Player resources for the owner of this score. |\n| `items[]` | `object (`[LeaderboardScore](/games/services/web/api/rest/v1/scores#LeaderboardScore)`)` The leaderboard scores. |\n\nLeaderboardScore\n----------------\n\nA player leaderboard score object.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"leaderboard_id\": string, \"scoreValue\": string, \"scoreString\": string, \"publicRank\": { object (/games/services/web/api/rest/v1/scores#LeaderboardScoreRank) }, \"socialRank\": { object (/games/services/web/api/rest/v1/scores#LeaderboardScoreRank) }, \"friendsRank\": { object (/games/services/web/api/rest/v1/scores#LeaderboardScoreRank) }, \"timeSpan\": enum (/games/services/web/api/rest/v1/scores#ScoreTimeSpan), \"writeTimestamp\": string, \"scoreTag\": string } ``` |\n\n| Fields ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLeaderboardScore`. |\n| `leaderboard_id` | `string` The ID of the leaderboard this score is in. |\n| `scoreValue` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The numerical value of this score. |\n| `scoreString` | `string` The formatted value of this score. |\n| `publicRank` | `object (`[LeaderboardScoreRank](/games/services/web/api/rest/v1/scores#LeaderboardScoreRank)`)` The public rank of the score in this leaderboard. This object will not be present if the user is not sharing their scores publicly. |\n| `socialRank` | `object (`[LeaderboardScoreRank](/games/services/web/api/rest/v1/scores#LeaderboardScoreRank)`)` The social rank of the score in this leaderboard. |\n| `friendsRank` | `object (`[LeaderboardScoreRank](/games/services/web/api/rest/v1/scores#LeaderboardScoreRank)`)` The rank of the score in the friends collection for this leaderboard. |\n| `timeSpan` | `enum (`[ScoreTimeSpan](/games/services/web/api/rest/v1/scores#ScoreTimeSpan)`)` The time span of this score. |\n| `writeTimestamp` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The timestamp at which this score was recorded, in milliseconds since the epoch in UTC. |\n| `scoreTag` | `string` Additional information about the score. Values must contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986. |\n\nLeaderboardScoreRank\n--------------------\n\nA score rank in a leaderboard.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"rank\": string, \"formattedRank\": string, \"numScores\": string, \"formattedNumScores\": string } ``` |\n\n| Fields ||\n|----------------------|------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardScoreRank`. |\n| `rank` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The rank in the leaderboard. |\n| `formattedRank` | `string` The rank in the leaderboard as a string. |\n| `numScores` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The number of scores in the leaderboard. |\n| `formattedNumScores` | `string` The number of scores in the leaderboard as a string. |\n\nScoreTimeSpan\n-------------\n\nDefines possible time spans for a score.\n\n| Enums ||\n|------------|---------------------------------|\n| `ALL_TIME` | The score is an all-time score. |\n| `WEEKLY` | The score is a weekly score. |\n| `DAILY` | The score is a daily score. |\n\n| Methods ------- ||\n|-----------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|\n| ### [get](/games/services/web/api/rest/v1/scores/get) | Get high scores, and optionally ranks, in leaderboards for the currently authenticated player. |\n| ### [list](/games/services/web/api/rest/v1/scores/list) | Lists the scores in a leaderboard, starting from the top. |\n| ### [listWindow](/games/services/web/api/rest/v1/scores/listWindow) | Lists the scores in a leaderboard around (and including) a player's score. |\n| ### [submit](/games/services/web/api/rest/v1/scores/submit) | Submits a score to the specified leaderboard. |\n| ### [submitMultiple](/games/services/web/api/rest/v1/scores/submitMultiple) | Submits multiple scores to leaderboards. |"]]