- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- ScoreTimeSpan
- IncludeRankType
- جرِّبه الآن
الحصول على أعلى النتائج وترتيب اختياري في قوائم الصدارة للاعب الذي تمّت المصادقة عليه حاليًا ويمكن ضبط leaderboardId
على ALL
لفترة زمنية معيّنة، لاسترداد البيانات لجميع لوحات الصدارة في فترة زمنية معيّنة. "ملاحظة: لا يمكنك طلب لوحات الصدارة 'ALL'" و"جميع" الفترات الزمنية في الطلب نفسه، حيث يمكن ضبط مَعلمة واحدة فقط على "ALL".
طلب HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
مَعلمات المسار
المَعلمات | |
---|---|
playerId |
رقم تعريف لاعب. يمكن استخدام قيمة |
leaderboardId |
رقم تعريف لوحة الصدارة. يمكن الضبط على "ALL" لاسترداد البيانات لجميع لوحات الصدارة لهذا التطبيق. |
timeSpan |
الفترة الزمنية للدرجات والترتيبات المطلوبة. |
معلمات طلب البحث
المَعلمات | |
---|---|
language |
اللغة المفضلة للاستخدام للسلاسل التي تعرضها هذه الطريقة. |
includeRankType |
أنواع الترتيب المطلوب عرضها. إذا تم إغفال المعلمة، لن يتم عرض أي ترتيب. |
maxResults |
الحد الأقصى لعدد نتائج لوحة الصدارة المطلوب عرضها في الرد. قد يكون العدد الفعلي لنتائج لوحة الصدارة التي يتم عرضها أقل من العدد المحدد في |
pageToken |
الرمز المميّز الذي عرضه الطلب السابق |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال 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 |
استرجع الترتيب في مجموعة الأصدقاء. |