REST Resource: scores

משאב: GetLeaderboardsResponse

רשימת ניקוד של שחקנים בלוחות הלידרבורד.

ייצוג JSON
{
  "kind": string,
  "nextPageToken": string,
  "player": {
    object (Player)
  },
  "items": [
    {
      object (LeaderboardScore)
    }
  ]
}
שדות
kind

string

מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה games#playerLeaderboardScoreListResponse.

nextPageToken

string

אסימון העימוד עבור דף התוצאות הבא.

player

object (Player)

המשאבים של הנגן עבור הבעלים של הניקוד הזה.

items[]

object (LeaderboardScore)

הניקוד בלידרבורד.

LeaderboardScore

אובייקט ניקוד של שחקן בלידרבורד.

ייצוג JSON
{
  "kind": string,
  "leaderboard_id": string,
  "scoreValue": string,
  "scoreString": string,
  "publicRank": {
    object (LeaderboardScoreRank)
  },
  "socialRank": {
    object (LeaderboardScoreRank)
  },
  "friendsRank": {
    object (LeaderboardScoreRank)
  },
  "timeSpan": enum (ScoreTimeSpan),
  "writeTimestamp": string,
  "scoreTag": string
}
שדות
kind

string

מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה games#playerLeaderboardScore.

leaderboard_id

string

מזהה הלידרבורד שבו נמצא הניקוד הזה.

scoreValue

string (int64 format)

הערך המספרי של הציון הזה.

scoreString

string

הערך בפורמט של הציון הזה.

publicRank

object (LeaderboardScoreRank)

הדירוג הציבורי של הניקוד בלידרבורד הזה. האובייקט הזה לא יוצג אם המשתמש לא משתף את הציונים שלו באופן ציבורי.

socialRank

object (LeaderboardScoreRank)

הדירוג ברשתות החברתיות של הניקוד בלידרבורד הזה.

friendsRank

object (LeaderboardScoreRank)

דירוג הניקוד באוסף החברים של ה-Leaderboard הזה.

timeSpan

enum (ScoreTimeSpan)

משך הזמן של הניקוד הזה.

writeTimestamp

string (int64 format)

חותמת הזמן שבה הציון הזה נרשם, באלפיות השנייה מאז תחילת התקופה לפי שעון UTC.

scoreTag

string

מידע נוסף על הציון הערכים לא יכולים להכיל יותר מ-64 תווים בטוחים ל-URI, כפי שהוגדר בסעיף 2.3 של RFC 3986.

LeaderboardScoreRank

דירוג של ניקוד בלידרבורד.

ייצוג JSON
{
  "kind": string,
  "rank": string,
  "formattedRank": string,
  "numScores": string,
  "formattedNumScores": string
}
שדות
kind

string

מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה games#leaderboardScoreRank.

rank

string (int64 format)

הדירוג בלידרבורד.

formattedRank

string

הדירוג ב-Leaderboard כמחרוזת.

numScores

string (int64 format)

מספר התוצאות בלידרבורד.

formattedNumScores

string

מספר הניקוד בלידרבורד כמחרוזת.

ScoreTimeSpan

הגדרת טווחי הזמן האפשריים לניקוד.

טיפוסים בני מנייה (enums)
ALL_TIME התוצאה היא תוצאה ללא הגבלה.
WEEKLY הציון הוא ניקוד שבועי.
DAILY הציון הוא ניקוד יומי.

שיטות

get

קבל ניקוד גבוה, ובאופן אופציונלי דרגות, בלוחות לידרבורד עבור השחקן המאומת הנוכחי.

list

מציין את הניקוד בלידרבורד, מהקצה העליון.

listWindow

רשימת התוצאות בלידרבורד מסביב (כולל) הניקוד של השחקן.

submit

שליחת ניקוד ל-Leaderboard שצוין.

submitMultiple

שליחת מספר ניקוד ללידרבורד.