Method: monetization.onetimeproducts.purchaseOptions.offers.list

تعرض هذه الطريقة جميع العروض الترويجية ضمن تطبيق أو منتج أو خيار شراء معيّن.

طلب HTTP

GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers

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

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

المعلمات
packageName

string

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

string

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

string

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

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

المعلمات
pageSize

integer

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

string

اختيارية: رمز مميّز للصفحة، يتم تلقّيه من طلب offers.list سابق. يجب تقديم هذه القيمة لاسترداد الصفحة التالية.

عند تقسيم الصفحات، يجب أن تتطابق قيم productId وpackageName وpurchaseOptionId المقدَّمة إلى ListOneTimeProductOffersRequest مع الطلب الذي قدّم رمز الصفحة المميّز.

نص الطلب

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

نص الاستجابة

رسالة الردّ على offers.list

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

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

object (OneTimeProductOffer)

عروض المنتجات التي يتم تحصيل سعرها مرة واحدة من الطلب المحدّد.
nextPageToken

string

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

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

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

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