Method: monetization.subscriptions.basePlans.offers.batchUpdate

لتعديل مجموعة من عروض الاشتراك

عيِّن حقل "وقت الاستجابة" في الطلبات المتداخلة على 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 عنصر يجب تعديل عروض الاشتراك المختلفة في جميع الطلبات.

نص الاستجابة

رسالة رد لـ offers.batchUpdate.

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

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

object (SubscriptionOffer)

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

نطاقات التفويض

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

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

UpdateSubscriptionOfferRequest

اطلب رسالة لـ offers.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)

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