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

המספר המקסימלי של ניקוד ב-Leaderboard שניתן להחזיר בתגובה. עבור כל תגובה, המספר של ציוני הלידרבורד שיוחזרו בפועל עשוי להיות נמוך מהערך שצוין ב-maxResults.
resultsAbove

integer

מספר התוצאות המועדף שיוחזר מעל הניקוד של השחקן. ייתכן שיחזירו יותר ניקוד אם השחקן נמצא בחלק התחתון של טבלת הלידרבורד; ייתכן שיוחזר פחות ניקוד אם השחקן ממוקם בראש הדף. הערך הזה חייב להיות שווה לערך maxResults או קטן ממנו.
returnTopIfAbsent

boolean

הערך הוא True אם צריך להחזיר את התוצאות המובילות כאשר השחקן לא נמצא ברשימת המובילים. ברירת המחדל היא True.
pageToken

string

האסימון שהוחזר על ידי הבקשה הקודמת.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התגובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של ListLeaderboardScoresResponse.

היקפי הרשאות

כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:

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

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.