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)

الطابع الزمني الذي تم عنده تسجيل هذه النتيجة، بالمللي ثانية منذ بداية الحقبة بالتوقيت العالمي المتّفق عليه
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

تحدد الفترات الزمنية المحتملة للنتيجة.

عمليات التعداد
ALL_TIME هذه النتيجة هي النتيجة النهائية.
WEEKLY والنتيجة هي نتيجة أسبوعية.
DAILY وهذه النتيجة هي نتيجة يومية.

الطُرق

get

 احصل على أعلى النتائج والترتيبات الاختيارية في قوائم الصدارة للّاعبين الذي تمت مصادقتهم حاليًا.

list

 يسرد النتائج في قائمة صدارة، بدءًا من أعلاها.

listWindow

 يسرد النتائج في لوحة صدارة حول نتيجة لاعب (وتتضمنها).

submit

 يتيح هذا الخيار إرسال نتيجة إلى قائمة الصدارة المحدّدة.

submitMultiple

 يرسل نتائج متعددة إلى قوائم الصدارة.