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

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

مولفه های
packageName

string

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

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

productId

string

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

basePlanId

string

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

درخواست بدن

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

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

object ( UpdateSubscriptionOfferStateRequest )

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

بدن پاسخگو

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

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

نمایندگی JSON
{
  "subscriptionOffers": [
    {
      object (SubscriptionOffer)
    }
  ]
}
زمینه های
subscriptionOffers[]

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 فقط می تواند یکی از موارد زیر باشد:
activateSubscriptionOfferRequest

object ( ActivateSubscriptionOfferRequest )

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

deactivateSubscriptionOfferRequest

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)
}
زمینه های
packageName

string

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

productId

string

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

basePlanId

string

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

offerId

string

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

latencyTolerance

enum ( ProductUpdateLatencyTolerance )

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