Method: scores.listWindow

• طلب HTTP
• مَعلمات المسار
• معامِلات طلب البحث
• نص الطلب
• نص الاستجابة
• نطاقات التفويض
• جرِّبه الآن

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

طلب HTTP

GET https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/window/{collection}

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

المَعلمات
leaderboardId	string رقم تعريف لوحة الصدارة.
collection	enum (ScoreCollection) مجموعة التقييمات التي تطلبها.

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

المَعلمات
language	string اللغة المفضلة للاستخدام للسلاسل التي تعرضها هذه الطريقة.
timeSpan	enum (ScoreTimeSpan) مطلوبة. الفترة الزمنية للدرجات والترتيبات المطلوبة.
maxResults	integer الحد الأقصى لعدد نتائج لوحة الصدارة المطلوب عرضها في الرد. قد يكون العدد الفعلي لنتائج لوحة الصدارة التي يتم عرضها أقل من العدد المحدد في maxResults لأي رد.
resultsAbove	integer العدد المفضل من النتائج المطلوب إرجاعه أعلى من نتيجة اللاعب. قد يتم عرض المزيد من النتائج إذا كان اللاعب في أسفل لوحة الصدارة، وقد يتم عرض عدد أقل من النتائج إذا كان اللاعب في القمة. يجب أن تكون القيمة أقل من أو تساوي maxResults.
returnTopIfAbsent	boolean صحيح إذا كان يجب عرض أعلى النتائج عندما لا يكون اللاعب في قائمة الصدارة. وتكون الإعدادات التلقائية على "صحيح".
pageToken	string الرمز المميّز الذي عرضه الطلب السابق

نص الطلب

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

نص الاستجابة

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

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

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

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

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