Method: monetization.subscriptions.basePlans.offers.list

يسرد كل العروض المتوفّرة ضمن اشتراك معيّن.

طلب HTTP

GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

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

المَعلمات
packageName

string

مطلوبة. التطبيق الرئيسي (اسم الحزمة) الذي يجب قراءة الاشتراكات له.
productId

string

مطلوبة. الاشتراك الرئيسي (رقم التعريف) الذي يجب قراءة العروض الخاصة به يمكن تحديد العلامة "-" لقراءة جميع العروض ضمن أحد التطبيقات.
basePlanId

string

مطلوبة. الخطة الأساسية (رقم التعريف) التي يجب قراءة العروض الخاصة بها يمكن أن يتم تحديدها على النحو "-" لقراءة جميع العروض ضمن اشتراك أو تطبيق. ويجب تحديدها كـ "-" إذا تم تحديد معرّف المنتج على النحو التالي "-".

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

المَعلمات
pageSize

integer

الحد الأقصى لعدد الاشتراكات المطلوب عرضها. وقد تعرِض الخدمة قيمة أقل من هذه القيمة. في حال عدم تحديد هذا الحقل، سيتم عرض 50 اشتراكًا كحدّ أقصى. الحد الأقصى للقيمة هو 1000، وسيتم فرض القيمة التي تزيد عن 1000 لتصبح 1000.
pageToken

string

رمز مميّز للصفحة تم تلقّيه من مكالمة سابقة لـ ListSubscriptionsOffers. قم بإدخاله لاسترداد الصفحة التالية.

عند تقسيم النتائج على عدّة صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى offers.list مع الطلب الذي قدَّم الرمز المميّز للصفحة.

نص الطلب

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

نص الاستجابة

رسالة رد لـ offers.list.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "subscriptionOffers": [
    {
      object (SubscriptionOffer)
    }
  ],
  "nextPageToken": string
}
الحقول
subscriptionOffers[]

object (SubscriptionOffer)

عروض الاشتراك المتوفّرة من خلال الاشتراك المحدَّد
nextPageToken

string

رمز مميز يمكن إرساله كـ pageToken لاسترداد الصفحة التالية إذا تم حذف هذا الحقل، لن تظهر أي صفحات لاحقة.

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

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/androidpublisher