Method: monetization.onetimeproducts.purchaseOptions.offers.batchGet

تقرأ هذه السمة عرضًا واحدًا أو أكثر من عروض المنتجات التي يتم تحصيل سعرها مرة واحدة.

طلب HTTP

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

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

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

المعلمات
packageName

string

مطلوب. التطبيق الرئيسي (اسم الحزمة) للعروض الترويجية المعدَّلة

يجب أن تكون القيمة مساوية لقيمة الحقل packageName في جميع موارد OneTimeProductOffer المعدَّلة.

productId

string

مطلوب. معرّف المنتج الرئيسي الذي يتم تحصيل سعره مرة واحدة، إذا كانت جميع العروض المعدَّلة تنتمي إلى المنتج نفسه إذا كان هذا الطلب يشمل عدة منتجات تُدفع لمرة واحدة، اضبط هذا الحقل على "-".

purchaseOptionId

string

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

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON
{
  "requests": [
    {
      object (GetOneTimeProductOfferRequest)
    }
  ]
}
الحقول
requests[]

object (GetOneTimeProductOfferRequest)

مطلوب. قائمة بطلبات الحصول على ما يصل إلى 100 عنصر يجب أن تستردّ جميع الطلبات عروضًا مختلفة.

نص الاستجابة

رسالة الردّ لنقطة النهاية offers.batchGet

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

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

object (OneTimeProductOffer)

قائمة عروض المنتجات التي يتم تحصيل سعرها مرة واحدة، بالترتيب نفسه الوارد في الطلب

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

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

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

GetOneTimeProductOfferRequest

طلب الرسالة GetOneTimeProductOffers

تمثيل JSON
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string
}
الحقول
packageName

string

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

productId

string

مطلوب. المنتج الرئيسي الذي يتم تحصيل سعره مرة واحدة (المعرّف) للعرض الذي سيتم الحصول عليه

purchaseOptionId

string

مطلوب. تمثّل هذه السمة خيار الشراء الرئيسي (المعرّف) للعرض الترويجي الذي سيتم الحصول عليه.

offerId

string

مطلوب. المعرّف الفريد للعرض الترويجي الذي سيتم الحصول عليه.