REST Resource: scores

מקור: GetLeaderboardScoresResponse

רשימת תוצאות של שחקנים בלוחות הישגי השחקנים המובילים.

ייצוג 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)

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

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

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

numScores

string (int64 format)

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

formattedNumScores

string

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

ScoreTimeSpan

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

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

שיטות

get

לקבל תוצאות גבוהות, ואם רוצים, לקבל דירוג בלידרבורד של השחקן המאומת.

list

מציין את הניקוד בלוח הישגי השחקנים המובילים.

listWindow

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

submit

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

submitMultiple

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