Method: monetization.subscriptions.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتم سرد جميع الاشتراكات ضمن تطبيق معيّن.
طلب HTTP
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
packageName |
string
مطلوب. التطبيق الرئيسي (اسم الحزمة) الذي يجب قراءة الاشتراكات له.
|
مَعلمات طلب البحث
المعلمات |
pageSize |
integer
الحد الأقصى لعدد الاشتراكات المطلوب عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديد عدد، سيتم عرض 50 اشتراكًا بحد أقصى. الحد الأقصى للقيمة هو 1000، وسيتم تحويل القيم التي تزيد عن 1000 إلى 1000.
|
pageToken |
string
رمز مميّز للصفحة، تم تلقّيه من مكالمة subscriptions.list سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة. عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى subscriptions.list مع الطلب الذي قدّم الرمز المميّز للصفحة.
|
showArchived (deprecated) |
boolean
تم إيقاف هذه الميزة نهائيًا: لا تتوفّر ميزة أرشفة الاشتراكات.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة الردّ على subscriptions.list
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
{
"subscriptions": [
{
object (Subscription )
}
],
"nextPageToken": string
} |
الحقول |
subscriptions[] |
object (Subscription )
الاشتراكات من التطبيق المحدّد
|
nextPageToken |
string
رمز مميّز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.
|
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-12-18 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2024-12-18 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Lists all subscriptions under a given app using an HTTP GET request."],["Requires providing the app's package name as a path parameter."],["Allows filtering by page size and using pagination for large result sets."],["Returns a list of subscriptions with details and a token for accessing further pages."],["Needs authorization with the `https://www.googleapis.com/auth/androidpublisher` scope."]]],["This document details how to list subscriptions for a given Android application using the Android Publisher API. It uses a `GET` HTTP request to the specified URL, including a required `packageName` path parameter. Optional query parameters like `pageSize` and `pageToken` enable pagination. The request body must be empty. The response includes a list of subscriptions, represented in JSON, and a `nextPageToken` for subsequent pages. This operation requires the `androidpublisher` OAuth scope.\n"]]