- درخواست HTTP
- پارامترهای مسیر
- پارامترهای پرس و جو
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- آن را امتحان کنید!
نمرات را در تابلوی امتیازات پیرامون (و شامل) امتیاز بازیکن فهرست می کند.
درخواست HTTP
GET https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/window/{collection}
پارامترهای مسیر
مولفه های | |
---|---|
leaderboardId | شناسه تابلوی امتیازات. |
collection | مجموعه امتیازاتی که درخواست می کنید. |
پارامترهای پرس و جو
مولفه های | |
---|---|
language | زبان ترجیحی برای استفاده برای رشته های برگردانده شده توسط این روش. |
timeSpan | ضروری. بازه زمانی امتیازات و رتبه هایی که درخواست می کنید. |
maxResults | حداکثر تعداد امتیازهای تابلوی امتیازات برای بازگشت در پاسخ. برای هر پاسخی، تعداد واقعی امتیازهای تابلوی امتیازات برگردانده شده ممکن است کمتر از |
resultsAbove | تعداد امتیازهای ترجیحی برای بازگشت بالاتر از امتیاز بازیکن. اگر بازیکن در انتهای جدول امتیازات باشد، ممکن است امتیازهای بیشتری برگردانده شود. اگر بازیکن در بالا باشد، تعداد کمتری ممکن است برگردانده شود. باید کمتر یا مساوی maxResults باشد. |
returnTopIfAbsent | درست است اگر امتیازهای برتر زمانی که بازیکن در جدول امتیازات نیست برگردانده شود. پیش فرض ها به درست است. |
pageToken | توکن با درخواست قبلی بازگردانده شد. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از ListLeaderboardScoresResponse
است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/games
-
https://www.googleapis.com/auth/games_lite
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.