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

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

basePlanId

string

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

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

المعلمات
pageSize

integer

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

pageToken

string

رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "ListSubscriptionsOffers". يمكنك توفير هذا الحقل لاسترداد الصفحة التالية.

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

نص الطلب

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

نص الاستجابة

رسالة ردّ لـ Offer.list.

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

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

object (SubscriptionOffer)

يشير إلى عروض الاشتراك من الاشتراك المحدّد.

nextPageToken

string

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

نطاقات الأذونات

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

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