تعرض قائمة النتائج في لوحة صدارة حول نتيجة اللاعب (وتتضمّنها).
طلب HTTP
GET https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/window/{collection}
مَعلمات المسار
المَعلمات | |
---|---|
leaderboardId |
رقم تعريف لوحة الصدارة. |
collection |
مجموعة التقييمات التي تطلبها. |
معلمات طلب البحث
المَعلمات | |
---|---|
language |
اللغة المفضلة للاستخدام للسلاسل التي تعرضها هذه الطريقة. |
timeSpan |
مطلوبة. الفترة الزمنية للدرجات والترتيبات المطلوبة. |
maxResults |
الحد الأقصى لعدد نتائج لوحة الصدارة المطلوب عرضها في الرد. قد يكون العدد الفعلي لنتائج لوحة الصدارة التي يتم عرضها أقل من العدد المحدد في |
resultsAbove |
العدد المفضل من النتائج المطلوب إرجاعه أعلى من نتيجة اللاعب. قد يتم عرض المزيد من النتائج إذا كان اللاعب في أسفل لوحة الصدارة، وقد يتم عرض عدد أقل من النتائج إذا كان اللاعب في القمة. يجب أن تكون القيمة أقل من أو تساوي maxResults. |
returnTopIfAbsent |
صحيح إذا كان يجب عرض أعلى النتائج عندما لا يكون اللاعب في قائمة الصدارة. وتكون الإعدادات التلقائية على "صحيح". |
pageToken |
الرمز المميّز الذي عرضه الطلب السابق |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال ListLeaderboardScoresResponse
.
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.