Method: scores.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتم عرض النتائج في لوحة صدارة، بدءًا من الأعلى.
طلب HTTP
GET https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/scores/{collection}
مَعلمات المسار
| المَعلمات |
leaderboardId |
string
رقم تعريف لوحة الصدارة.
|
collection |
enum (ScoreCollection)
مجموعة التقييمات التي تطلبها.
|
معلمات طلب البحث
| المَعلمات |
language |
string
اللغة المفضلة للاستخدام للسلاسل التي تعرضها هذه الطريقة.
|
timeSpan |
enum (ScoreTimeSpan)
مطلوبة. الفترة الزمنية للدرجات والترتيبات المطلوبة.
|
maxResults |
integer
الحد الأقصى لعدد نتائج لوحة الصدارة المطلوب عرضها في الرد. قد يكون العدد الفعلي لنتائج لوحة الصدارة التي يتم عرضها أقل من العدد المحدد في maxResults لأي رد.
|
pageToken |
string
الرمز المميّز الذي عرضه الطلب السابق
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال ListLeaderboardScoresResponse.
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: scores.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists the scores in a leaderboard, starting from the top.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/scores/{collection}`\n\n### Path parameters\n\n| Parameters ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------|\n| `leaderboardId` | `string` The ID of the leaderboard. |\n| `collection` | `enum (`[ScoreCollection](/games/services/web/api/rest/v1/ScoreCollection)`)` The collection of scores you're requesting. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n| `timeSpan` | `enum (`[ScoreTimeSpan](/games/services/web/api/rest/v1/scores#ScoreTimeSpan)`)` Required. The time span for the scores and ranks you're requesting. |\n| `maxResults` | `integer` The maximum number of leaderboard scores to return in the response. For any response, the actual number of leaderboard scores returned may be less than the specified `maxResults`. |\n| `pageToken` | `string` The token returned by the previous request. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ListLeaderboardScoresResponse](/games/services/web/api/rest/v1/ListLeaderboardScoresResponse).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/games`\n- `\n https://www.googleapis.com/auth/games_lite`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
