Method: scores.listWindow

نمرات را در تابلوی امتیازات پیرامون (و شامل) امتیاز بازیکن فهرست می کند.

درخواست HTTP

GET https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/window/{collection}

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

مولفه های
leaderboardId

string

شناسه تابلوی امتیازات.

collection

enum ( ScoreCollection )

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

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

مولفه های
language

string

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

timeSpan

enum ( ScoreTimeSpan )

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

maxResults

integer

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

resultsAbove

integer

تعداد امتیازهای ترجیحی برای بازگشت بالاتر از امتیاز بازیکن. اگر بازیکن در انتهای جدول امتیازات باشد، ممکن است امتیازهای بیشتری برگردانده شود. اگر بازیکن در بالا باشد، تعداد کمتری ممکن است برگردانده شود. باید کمتر یا مساوی maxResults باشد.

returnTopIfAbsent

boolean

درست است اگر امتیازهای برتر زمانی که بازیکن در جدول امتیازات نیست برگردانده شود. پیش فرض ها به درست است.

pageToken

string

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

درخواست بدن

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

بدن پاسخگو

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

محدوده مجوز

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

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

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