Method: monetization.subscriptions.basePlans.offers.batchUpdate

يتيح هذا الخيار تعديل مجموعة من عروض الاشتراك.

يمكنك ضبط حقل TimeTolerance في الطلبات المتداخلة على PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT لتحقيق الحد الأقصى من سرعة معالجة بيانات التحديثات.

طلب HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdate

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

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

المعلمات
packageName

string

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

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

productId

string

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

basePlanId

string

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

نص الطلب

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

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

object (UpdateSubscriptionOfferRequest)

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

نص الاستجابة

رسالة ردّ لـ Offer.batchUpdate.

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

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

object (SubscriptionOffer)

القائمة المعدَّلة لعروض الاشتراك

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

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

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

UpdateSubscriptionOfferRequest

يمكنك طلب تلقّي رسالة بشأن Offer.patch.

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

object (SubscriptionOffer)

مطلوب. عرض الاشتراك الذي سيتم تعديله

updateMask

string (FieldMask format)

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

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

regionsVersion

object (RegionsVersion)

مطلوب. تشير هذه السمة إلى إصدار المناطق المتوفّرة التي يتم استخدامها في SubscriptionOffer.

allowMissing

boolean

اختياريّ. إذا تم ضبط هذه السياسة على "صحيح"، ولم يتم العثور على عرض الاشتراك الذي يتضمّن packageName وproductId وbasePlanId وOfferId، سيتم إنشاء عرض.

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

latencyTolerance

enum (ProductUpdateLatencyTolerance)

اختياريّ. مقدار التفاوت في وقت الاستجابة لنشر تحديث المنتج هذا يتم ضبط الإعدادات التلقائية على الحساسية لوقت الاستجابة.