Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

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

درخواست HTTP

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

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

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

پارامترها
packageName

string

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

productId

string

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

purchaseOptionId

string

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

درخواست بدن

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

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

object ( UpdateOneTimeProductOfferStateRequest )

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

بدن پاسخگو

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

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

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

object ( OneTimeProductOffer )

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

محدوده مجوز

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

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

UpdateOneTimeProductOfferStateRequest

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

نمایندگی JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
فیلدها
فیلد اتحادیه state_transition_type . نوع انتقال حالت برای اعمال، دقیقاً یکی باید تنظیم شود. state_transition_type فقط می تواند یکی از موارد زیر باشد:
activateOneTimeProductOfferRequest

object ( ActivateOneTimeProductOfferRequest )

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

cancelOneTimeProductOfferRequest

object ( CancelOneTimeProductOfferRequest )

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

deactivateOneTimeProductOfferRequest

object ( DeactivateOneTimeProductOfferRequest )

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

CancelOneTimeProductOfferRequest

درخواست پیام برای پیشنهادات. لغو.

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

string

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

productId

string

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

purchaseOptionId

string

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

offerId

string

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

latencyTolerance

enum ( ProductUpdateLatencyTolerance )

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

غیرفعال کردن OneTimeProductOfferRequest

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

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

string

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

productId

string

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

purchaseOptionId

string

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

offerId

string

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

latencyTolerance

enum ( ProductUpdateLatencyTolerance )

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