Method: applications.deviceTierConfigs.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض الإعدادات التي تم إنشاؤها لفئات الأجهزة، مرتبة حسب وقت الإنشاء تنازليًا.
طلب HTTP
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/deviceTierConfigs
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
packageName |
string
اسم حزمة التطبيق
|
معامِلات طلب البحث
| المعلمات |
pageSize |
integer
الحد الأقصى لعدد إعدادات فئة الجهاز المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. وفي حال عدم تحديده، سيتم عرض 10 إعدادات على الأكثر لفئة الأجهزة. الحد الأقصى لقيمة هذا الحقل هو 100؛ سيتم فرض القيم الأكبر من 100 على 100. سيتم ترتيب إعدادات فئة الجهاز تنازليًا حسب وقت الإنشاء.
|
pageToken |
string
رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "deviceTierConfigs.list". يمكنك توفير هذا الحقل لاسترداد الصفحة التالية.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
تعرض الردود الإعدادات الحالية لفئات الأجهزة.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"deviceTierConfigs": [
{
object (DeviceTierConfig)
}
],
"nextPageToken": string
} |
| الحقول |
deviceTierConfigs[] |
object (DeviceTierConfig)
إعدادات فئات الأجهزة التي أنشأها المطوّر
|
nextPageToken |
string
رمز مميز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال إسقاط هذا الحقل، لن تظهر أي صفحات لاحقة.
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eReturns a list of device tier configs for a specified Android app, ordered by descending creation time.\u003c/p\u003e\n"],["\u003cp\u003eAllows for pagination to retrieve large lists of device tier configs.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eRequest body should be empty, and the response includes a list of device tier configs and a token for pagination.\u003c/p\u003e\n"]]],["This API retrieves a list of device tier configurations for a specified Android app. It uses a `GET` request to a URL with the app's package name as a path parameter. Optional query parameters `pageSize` (up to 100) and `pageToken` facilitate pagination. The request body is empty. The response, ordered by creation time, is a JSON object containing an array of `deviceTierConfigs` and a `nextPageToken` for further pages. It needs `androidpublisher` authorization scope.\n"],null,["# Method: applications.deviceTierConfigs.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 - [JSON representation](#body.ListDeviceTierConfigsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns created device tier configs, ordered by descending creation time.\n\n### HTTP request\n\n`GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/deviceTierConfigs`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|-----------------------------------|\n| `packageName` | `string` Package name of the app. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of device tier configs to return. The service may return fewer than this value. If unspecified, at most 10 device tier configs will be returned. The maximum value for this field is 100; values above 100 will be coerced to 100. Device tier configs will be ordered by descending creation time. |\n| `pageToken` | `string` A page token, received from a previous `deviceTierConfigs.list` call. Provide this to retrieve the subsequent page. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse listing existing device tier configs.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"deviceTierConfigs\": [ { object (/android-publisher/api-ref/rest/v3/applications.deviceTierConfigs#DeviceTierConfig) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `deviceTierConfigs[]` | `object (`[DeviceTierConfig](/android-publisher/api-ref/rest/v3/applications.deviceTierConfigs#DeviceTierConfig)`)` Device tier configs created by the developer. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
