Method: scores.get

الحصول على أعلى النتائج وترتيب اختياري في قوائم الصدارة للاعب الذي تمّت المصادقة عليه حاليًا ويمكن ضبط leaderboardId على ALL لفترة زمنية معيّنة، لاسترداد البيانات لجميع لوحات الصدارة في فترة زمنية معيّنة. "ملاحظة: لا يمكنك طلب لوحات الصدارة 'ALL'" و"جميع" الفترات الزمنية في الطلب نفسه، حيث يمكن ضبط مَعلمة واحدة فقط على "ALL".

طلب HTTP

GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}

مَعلمات المسار

المَعلمات
playerId

string

رقم تعريف لاعب. يمكن استخدام قيمة me بدلاً من معرّف المشغّل الذي تمت مصادقته.
leaderboardId

string

رقم تعريف لوحة الصدارة. يمكن الضبط على "ALL" لاسترداد البيانات لجميع لوحات الصدارة لهذا التطبيق.
timeSpan

enum (ScoreTimeSpan)

الفترة الزمنية للدرجات والترتيبات المطلوبة.

معلمات طلب البحث

المَعلمات
language

string

اللغة المفضلة للاستخدام للسلاسل التي تعرضها هذه الطريقة.
includeRankType

enum (IncludeRankType)

أنواع الترتيب المطلوب عرضها. إذا تم إغفال المعلمة، لن يتم عرض أي ترتيب.
maxResults

integer

الحد الأقصى لعدد نتائج لوحة الصدارة المطلوب عرضها في الرد. قد يكون العدد الفعلي لنتائج لوحة الصدارة التي يتم عرضها أقل من العدد المحدد في maxResults لأي رد.
pageToken

string

الرمز المميّز الذي عرضه الطلب السابق

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال GetLeaderboardScoresResponse.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

ScoreTimeSpan

تحدد هذه السمة الفترات الزمنية الممكنة للنتيجة.

عمليات التعداد
ALL احصل على أعلى النتائج لجميع الفترات الزمنية. وفي حال استخدام هذه السمة، سيتم تجاهل قيم maxResults.
ALL_TIME احصل على أعلى نتيجة في جميع الأوقات.
WEEKLY أدرج أعلى النتائج لليوم الحالي.
DAILY أدرج أعلى النتائج للأسبوع الحالي.

IncludeRankType

القيم المحتملة لنوع الترتيب.

عمليات التعداد
ALL استرداد جميع الرتبة المدعومة. في HTTP، يمكن أيضًا تحديد قيمة المَعلمة هذه على أنّها ALL.
PUBLIC استرداد الترتيبات العامة، إذا كان اللاعب يشارك نشاط أسلوب اللعب بشكل علني
SOCIAL

(قديم) استرجع الترتيب الاجتماعي.
FRIENDS استرجع الترتيب في مجموعة الأصدقاء.