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 )

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