Method: scores.get

در تابلوهای امتیازات برای بازیکنی که در حال حاضر احراز هویت شده است، نمرات بالا و به صورت اختیاری رتبه دریافت کنید. برای یک بازه زمانی خاص، leaderboardId می توان روی ALL تنظیم کرد تا داده ها را برای همه تابلوهای امتیاز در یک بازه زمانی معین بازیابی کند. توجه: شما نمی توانید در یک درخواست، تابلوهای امتیازات "ALL" و "ALL" TimeSpans را درخواست کنید. فقط یک پارامتر ممکن است روی "ALL" تنظیم شود.

درخواست HTTP

GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}

پارامترهای مسیر

مولفه های
playerId

string

شناسه بازیکن ممکن است به جای شناسه بازیکن تایید شده از مقدار me استفاده شود.

leaderboardId

string

شناسه تابلوی امتیازات. می توان برای بازیابی داده ها برای همه تابلوهای امتیازات این برنامه روی "ALL" تنظیم کرد.

timeSpan

enum ( ScoreTimeSpan )

بازه زمانی امتیازات و رتبه هایی که درخواست می کنید.

پارامترهای پرس و جو

مولفه های
language

string

زبان ترجیحی برای استفاده برای رشته های برگردانده شده توسط این روش.

includeRankType

enum ( IncludeRankType )

انواع رتبه های برگشتی. اگر پارامتر حذف شود، هیچ رتبه ای بر نمی گردد.

maxResults

integer

حداکثر تعداد امتیازهای تابلوی امتیازات برای بازگشت در پاسخ. برای هر پاسخی، تعداد واقعی امتیازهای تابلوی امتیازات برگردانده شده ممکن است کمتر از maxResults مشخص شده باشد.

pageToken

string

توکن با درخواست قبلی بازگردانده شد.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از GetLeaderboardScoresResponse است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

ScoreTimeSpan

بازه های زمانی ممکن را برای یک امتیاز تعریف می کند.

Enums
ALL نمرات بالا را برای تمام بازه های زمانی دریافت کنید. اگر از این استفاده شود، مقادیر maxResults نادیده گرفته می شود.
ALL_TIME نمره بالا تمام زمان را دریافت کنید.
WEEKLY امتیازهای برتر روز جاری را فهرست کنید.
DAILY امتیازهای برتر هفته جاری را فهرست کنید.

IncludeRankType

مقادیر ممکن برای نوع رتبه

Enums
ALL همه رتبه های پشتیبانی شده را بازیابی کنید. در HTTP، این مقدار پارامتر می تواند به عنوان ALL نیز مشخص شود.
PUBLIC در صورتی که بازیکن فعالیت گیم پلی خود را به صورت عمومی به اشتراک می گذارد، رتبه های عمومی را بازیابی کنید.
SOCIAL

(منسوخ شده) رتبه اجتماعی را بازیابی کنید.

FRIENDS رتبه را در مجموعه دوستان بازیابی کنید.