Method: leaderboards.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يسرد جميع البيانات الوصفية الخاصة بلوحة الصدارة لتطبيقك.
طلب HTTP
GET https://games.googleapis.com/games/v1/leaderboards
معامِلات طلب البحث
| المعلمات |
language |
string
اللغة المفضلة المراد استخدامها للسلاسل التي يتم عرضها بهذه الطريقة.
|
maxResults |
integer
الحد الأقصى لعدد قوائم الصدارة المطلوب عرضها في الردّ. بالنسبة إلى أي استجابة، قد يكون العدد الفعلي لقوائم الصدارة التي تم عرضها أقل من العدد المحدَّد من maxResults.
|
pageToken |
string
الرمز المميّز الذي تم عرضه من خلال الطلب السابق
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
قائمة بكائنات لوحة الصدارة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"kind": string,
"nextPageToken": string,
"items": [
{
object (Leaderboard)
}
]
} |
| الحقول |
kind |
string
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة games#leaderboardListResponse.
|
nextPageToken |
string
الرمز المميّز المقابل لصفحة النتائج التالية.
|
items[] |
object (Leaderboard)
قوائم الصدارة
|
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات 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: leaderboards.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListLeaderboardsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all the leaderboard metadata for your application.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/leaderboards`\n\n### Query parameters\n\n| Parameters ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n| `maxResults` | `integer` The maximum number of leaderboards to return in the response. For any response, the actual number of leaderboards 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\nA list of leaderboard objects.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"nextPageToken\": string, \"items\": [ { object (/games/services/web/api/rest/v1/leaderboards#Leaderboard) } ] } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardListResponse`. |\n| `nextPageToken` | `string` Token corresponding to the next page of results. |\n| `items[]` | `object (`[Leaderboard](/games/services/web/api/rest/v1/leaderboards#Leaderboard)`)` The leaderboards. |\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)."]]
