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

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

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

المعلمات
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