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 في جميع الطلبات.
productId

string

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

string

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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

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

object (GetOneTimeProductOfferRequest)

الحقل مطلوب. قائمة بطلبات استرداد البيانات باستخدام GET تضم ما يصل إلى 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

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