Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

دسته‌ای از وضعیت‌های پیشنهاد ویژه محصول یک‌باره را به‌روز می‌کند.

درخواست HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdateStates

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

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

پارامترها
packageName

string

الزامی. برنامه اصلی (نام بسته) پیشنهادهای ویژه محصول یک‌باره به‌روزشده.

productId

string

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

purchaseOptionId

string

الزامی. شناسه گزینه خرید گزینه خرید ولی، اگر همه پیشنهادهای ویژه به‌روزشده متعلق به همان گزینه خرید باشند. اگر این به‌روزرسانی دسته‌ای شامل چندین گزینه خرید می‌شود، این فیلد را روی «-» تنظیم کنید.

متن درخواست

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

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

object (UpdateOneTimeProductOfferStateRequest)

الزامی. فهرست درخواست به‌روزرسانی حداکثر ۱۰۰ عنصر. همه درخواست‌ها باید پیشنهادهای مختلف را به‌روز کنند.

بدنه پاسخ

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

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

نمایش JSON
{
  "oneTimeProductOffers": [
    {
      object (OneTimeProductOffer)
    }
  ]
}
فیلدها
oneTimeProductOffers[]

object (OneTimeProductOffer)

فهرست به‌روزشده پیشنهادهای ویژه محصول یک‌باره، با همان ترتیب درخواست.

دامنه‌های مجوز

به گستره OAuth زیر نیاز دارد:

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

UpdateOneTimeProductOfferStateRequest

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

نمایش JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // End of mutually exclusive fields.
}
فیلدها
نوع انتقال حالت برای اعمال، دقیقاً یکی باید تنظیم شود. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

پیشنهاد ویژه‌ای را فعال می‌کند. پس‌از فعال‌سازی، پیشنهاد برای کاربران دردسترس است، به‌شرطی که شرایط آن برآورده شود.

cancelOneTimeProductOfferRequest

object (CancelOneTimeProductOfferRequest)

پیشنهاد ویژه‌ای را لغو می‌کند. پس‌از لغو، پیشنهاد ویژه برای کاربران دردسترس نخواهد بود. همه سفارش‌های معلق مربوط به این پیشنهاد لغو خواهد شد. این انتقال وضعیت مختص پیش‌سفارش‌ها است.

deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

پیشنهاد ویژه‌ای را غیرفعال می‌کند. پس‌از غیرفعال شدن، پیشنهاد ویژه دیگر برای کاربران دردسترس نخواهد بود. این انتقال وضعیت مختص پیشنهادهای تخفیف‌دار و پاداش بازی است.

پایان فیلدهای متقابلاً انحصاری.

CancelOneTimeProductOfferRequest

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

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

string

الزامی. برنامه اصلی (نام بسته) پیشنهاد ویژه برای لغو.

productId

string

الزامی. محصول یک‌باره اصلی (شناسه) پیشنهاد ویژه برای لغو.

purchaseOptionId

string

الزامی. گزینه خرید ولی (شناسه) پیشنهاد ویژه برای لغو.

offerId

string

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

latencyTolerance

enum (ProductUpdateLatencyTolerance)

اختیاری. میزان تأخیر مجاز برای انتشار این به‌روزرسانی. به‌طور پیش‌فرض روی «حساس به تأخیر» تنظیم شده است.

DeactivateOneTimeProductOfferRequest

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

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

string

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

productId

string

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

purchaseOptionId

string

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

offerId

string

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

latencyTolerance

enum (ProductUpdateLatencyTolerance)

اختیاری. میزان تأخیر مجاز برای انتشار این به‌روزرسانی. به‌طور پیش‌فرض روی «حساس به تأخیر» تنظیم شده است.