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 استفاده می کند.

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

پارامترها
package Name

string

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

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

product Id

string

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

base Plan Id

string

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

درخواست بدن

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

نمایندگی JSON 
{
  "requests": [
    {
      object (UpdateSubscriptionOfferRequest)
    }
  ]
}
فیلدها
requests[]

object ( UpdateSubscriptionOfferRequest )

مورد نیاز. لیستی از درخواست های به روز رسانی تا 100 عنصر. همه درخواست ها باید پیشنهادات اشتراک مختلف را به روز کنند.

بدن پاسخگو

پیام پاسخ برای offer.batchUpdate.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "subscriptionOffers": [
    {
      object (SubscriptionOffer)
    }
  ]
}
فیلدها
subscription Offers[]

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)
}
فیلدها
subscription Offer

object ( SubscriptionOffer )

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

update Mask

string ( FieldMask format)

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

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

regions Version

object ( RegionsVersion )

مورد نیاز. نسخه مناطق موجود که برای subscriptionOffer استفاده می شود.

allow Missing

boolean

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

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

latency Tolerance

enum ( ProductUpdateLatencyTolerance )

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