Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdate

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

طلب HTTP

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

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

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

المعلمات
packageName

string

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

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

string

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

string

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

نص الطلب

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

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

object (UpdateOneTimeProductOfferRequest)

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

نص الاستجابة

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

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

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

object (OneTimeProductOffer)

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

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

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

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

UpdateOneTimeProductOfferRequest

طلب الرسالة لـ UpdateOneTimeProductOffer

تمثيل JSON 
{
  "oneTimeProductOffer": {
    object (OneTimeProductOffer)
  },
  "updateMask": string,
  "regionsVersion": {
    object (RegionsVersion)
  },
  "allowMissing": boolean,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
الحقول
oneTimeProductOffer

object (OneTimeProductOffer)

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

string (FieldMask format)

مطلوب. قائمة الحقول التي سيتم تعديلها

هذه قائمة مفصولة بفواصل تتضمّن الأسماء المؤهَّلة بالكامل للحقول. مثال: "user.displayName,photo"
regionsVersion

object (RegionsVersion)

مطلوب. يشير إلى إصدار المناطق المتاحة المستخدَمة للعرض.
allowMissing

boolean

اختيارية: إذا تم ضبط القيمة على "صحيح" ولم يكن العرض الترويجي الذي يتضمّن packageName وproductId وpurchaseOptionId وofferId المحدّدة متوفّرًا، سيتم إنشاء عرض ترويجي.

في حال إنشاء عرض جديد، سيتم تجاهل updateMask.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

اختيارية: الحدّ الأقصى لوقت الاستجابة المسموح به لنشر هذا التعديل على العرض. يتم ضبط القيمة التلقائية على "حساسة لوقت الاستجابة".