Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

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

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

درخواست HTTP

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

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

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

پارامترها
package Name

string

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

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

product Id

string

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

base Plan Id

string

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

درخواست بدن

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

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

object ( UpdateSubscriptionOfferStateRequest )

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

بدن پاسخگو

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

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

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

object ( SubscriptionOffer )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

UpdateSubscriptionOfferStateRequest

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

نمایندگی JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activateSubscriptionOfferRequest": {
    object (ActivateSubscriptionOfferRequest)
  },
  "deactivateSubscriptionOfferRequest": {
    object (DeactivateSubscriptionOfferRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
فیلدها
فیلد اتحادیه state_transition_type . نوع انتقال حالت برای اعمال، دقیقاً یکی باید تنظیم شود. state_transition_type فقط می تواند یکی از موارد زیر باشد:
activate Subscription Offer Request

object ( ActivateSubscriptionOfferRequest )

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

deactivate Subscription Offer Request

object ( DeactivateSubscriptionOfferRequest )

یک پیشنهاد را غیرفعال می کند. پس از غیرفعال شدن، این پیشنهاد برای مشترکین جدید در دسترس نخواهد بود، اما مشترکین موجود اشتراک خود را حفظ خواهند کرد.

ActivateSubscriptionOfferRequest

درخواست پیام برای ActivateSubscriptionOffer.

نمایندگی JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
فیلدها
packageName

string

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

productId

string

مورد نیاز. اشتراک والدین (ID) پیشنهاد برای فعال کردن.

basePlanId

string

مورد نیاز. طرح پایه والدین (ID) پیشنهاد برای فعال کردن.

offerId

string

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

latencyTolerance

enum ( ProductUpdateLatencyTolerance )

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

DeactivateSubscriptionOfferRequest

درخواست پیام برای offer.deactivate.

نمایندگی JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
فیلدها
package Name

string

مورد نیاز. برنامه والد (نام بسته) پیشنهاد غیرفعال کردن.

product Id

string

مورد نیاز. اشتراک والد (ID) پیشنهاد برای غیرفعال کردن.

base Plan Id

string

مورد نیاز. طرح پایه والدین (ID) پیشنهاد غیرفعال کردن.

offer Id

string

مورد نیاز. شناسه پیشنهاد منحصر به فرد پیشنهاد برای غیرفعال کردن.

latency Tolerance

enum ( ProductUpdateLatencyTolerance )

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