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

اختيارية: رمز مميز للصفحة تم تلقّيه من طلب ListOneTimeProductsOffers سابق. قدِّم هذه السلسلة لاسترداد الصفحة التالية.

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

نص الطلب

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

نص الاستجابة

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

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

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

object (OneTimeProductOffer)

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

string

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

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

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

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