רשימת התוצאות בלידרבורד מסביב (כולל) הניקוד של השחקן.
בקשת HTTP
GET https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/window/{collection}
פרמטרים של נתיב
| פרמטרים | |
|---|---|
leaderboardId |
מזהה הלידרבורד. |
collection |
אוסף הציונים שביקשת. |
פרמטרים של שאילתה
| פרמטרים | |
|---|---|
language |
השפה המועדפת לשימוש במחרוזות שמוחזרות בשיטה הזו. |
timeSpan |
חובה. טווח הזמן עבור הציונים והדירוגים שביקשת. |
maxResults |
המספר המקסימלי של ניקוד ב-Leaderboard שניתן להחזיר בתגובה. עבור כל תגובה, המספר של ציוני הלידרבורד שיוחזרו בפועל עשוי להיות נמוך מהערך שצוין ב- |
resultsAbove |
מספר התוצאות המועדף שיוחזר מעל הניקוד של השחקן. ייתכן שיחזירו יותר ניקוד אם השחקן נמצא בחלק התחתון של טבלת הלידרבורד; ייתכן שיוחזר פחות ניקוד אם השחקן ממוקם בראש הדף. הערך הזה חייב להיות שווה לערך maxResults או קטן ממנו. |
returnTopIfAbsent |
הערך הוא True אם צריך להחזיר את התוצאות המובילות כאשר השחקן לא נמצא ברשימת המובילים. ברירת המחדל היא True. |
pageToken |
האסימון שהוחזר על ידי הבקשה הקודמת. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של ListLeaderboardScoresResponse.
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:
https://www.googleapis.com/auth/gameshttps://www.googleapis.com/auth/games_lite
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.