يسرد جميع العروض ضمن اشتراك معيّن.
طلب HTTP
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
packageName |
مطلوب. التطبيق الرئيسي (اسم الحزمة) الذي يجب قراءة الاشتراكات له |
productId |
مطلوب. الاشتراك الرئيسي (ID) الذي يجب قراءة العروض الترويجية له يمكن تحديدها على أنّها "-" لقراءة كل العروض ضمن التطبيق. |
basePlanId |
مطلوب. الخطة الأساسية (رقم التعريف) التي يجب قراءة العروض الترويجية لها يمكن تحديدها على أنّها "-" لقراءة جميع العروض ضمن الاشتراك أو التطبيق. يجب تحديدها على النحو "-" إذا تم تحديد productId على "-". |
معامِلات طلب البحث
المعلمات | |
---|---|
pageSize |
الحد الأقصى لعدد الاشتراكات المطلوب عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. وفي حال عدم تحديده، سيتم عرض 50 اشتراكًا كحدّ أقصى. الحد الأقصى للقيمة هو 1000؛ سيتم فرض القيم الأكبر من 1000 على 1000. |
pageToken |
رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق " عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة ردّ لـ Offer.list.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"subscriptionOffers": [
{
object ( |
الحقول | |
---|---|
subscriptionOffers[] |
يشير إلى عروض الاشتراك من الاشتراك المحدّد. |
nextPageToken |
رمز مميز يمكن إرساله على شكل |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher