רשימת התוצאות בלידרבורד מסביב (כולל) הניקוד של השחקן.
בקשת 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/games
https://www.googleapis.com/auth/games_lite
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.