REST Resource: scores

المرجع: Get LeaderboardScoresResponse

قائمة بنتائج اللاعبين في الصدارة.

تمثيل 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

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