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 ) جدول امتیازات. |
امتیاز تابلوی امتیازات
یک شی امتیاز در تابلوی امتیازات بازیکن.
| فیلدها |
|---|
kind | string منحصر به فرد نوع این منبع را شناسایی می کند. ارزش همیشه games#playerLeaderboardScore . |
leaderboard_id | string شناسه تابلوی امتیازات این امتیاز در آن است. |
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 اطلاعات تکمیلی در مورد امتیاز مقادیر نباید بیش از 64 نویسه ایمن URI داشته باشند که در بخش 2.3 RFC 3986 تعریف شده است. |
رتبه امتیاز رتبه برتر
رتبه امتیاز در تابلوی امتیازات.
| نمایندگی 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
بازه های زمانی ممکن را برای یک امتیاز تعریف می کند.
| Enums |
|---|
ALL_TIME | امتیاز یک امتیاز تمام دوران است. |
WEEKLY | امتیاز یک نمره هفتگی است. |
DAILY | امتیاز یک نمره روزانه است. |
روش ها |
|---|
| در تابلوهای امتیازات برای بازیکنی که در حال حاضر احراز هویت شده است، نمرات بالا و به صورت اختیاری رتبه دریافت کنید. |
| امتیازات را در تابلوی امتیازات، از بالا شروع می‌کند. |
| نمرات را در تابلوی امتیازات پیرامون (و شامل) امتیاز بازیکن فهرست می کند. |
| امتیازی را به تابلوی امتیازات مشخص شده ارسال می کند. |
| چندین امتیاز را به تابلوی امتیازات ارسال می کند. |
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-29 بهوقت ساعت هماهنگ جهانی."],[],[],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. |"]]
