Method: monetization.subscriptions.basePlans.offers.batchUpdate

دسته ای از پیشنهادات اشتراک را به روز می کند.

فیلد latencyTolerance را در درخواست‌های تودرتو روی PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT تنظیم کنید تا به حداکثر توان عملیاتی به‌روزرسانی برسید.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
packageName

string

ضروری. برنامه والد (نام بسته) اشتراک به روز شده را ارائه می دهد.

باید برابر با قسمت packageName در همه منابع به روز شده SubscriptionOffer باشد.

productId

string

ضروری. شناسه محصول اشتراک والد، در صورتی که همه پیشنهادات به روز شده متعلق به یک اشتراک باشد. اگر این درخواست شامل چندین اشتراک است، این فیلد را روی "-" تنظیم کنید. باید تنظیم شود.

basePlanId

string

ضروری. طرح پایه اصلی (ID) که پیشنهادات برای آن باید به روز شوند. ممکن است برای به‌روزرسانی پیشنهادات از چندین طرح پایه به‌عنوان «-» مشخص شود.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی 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

اختیاری. اگر روی true تنظیم شود، و پیشنهاد اشتراک با packageName، productId، basePlanId و offerId داده شده وجود نداشته باشد، یک پیشنهاد ایجاد خواهد شد.

اگر پیشنهاد جدیدی ایجاد شود، updateMask نادیده گرفته می شود.

latencyTolerance

enum ( ProductUpdateLatencyTolerance )

اختیاری. تحمل تأخیر برای انتشار این به‌روزرسانی محصول. به طور پیش فرض حساس به تأخیر است.