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