Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdate

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

درخواست HTTP

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

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

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

پارامترها
packageName

string

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

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

productId

string

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

purchaseOptionId

string

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

درخواست بدن

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

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

object ( UpdateOneTimeProductOfferRequest )

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

بدن پاسخگو

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

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

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

object ( OneTimeProductOffer )

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

محدوده مجوز

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

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

UpdateOneTimeProductOfferRequest

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

نمایندگی JSON 
{
  "oneTimeProductOffer": {
    object (OneTimeProductOffer)
  },
  "updateMask": string,
  "regionsVersion": {
    object (RegionsVersion)
  },
  "allowMissing": boolean,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
فیلدها
oneTimeProductOffer

object ( OneTimeProductOffer )

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

updateMask

string ( FieldMask format)

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

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

regionsVersion

object ( RegionsVersion )

مورد نیاز. نسخه مناطق موجود که برای پیشنهاد استفاده می شود.

allowMissing

boolean

اختیاری. اگر روی true تنظیم شود و پیشنهاد با بستهName، productId، purchaseOptionId و offerId داده شده وجود نداشته باشد، یک پیشنهاد ایجاد خواهد شد.

اگر پیشنهاد جدیدی ایجاد شود، updateMask نادیده گرفته می شود.

latencyTolerance

enum ( ProductUpdateLatencyTolerance )

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