- درخواست اچتیتیپی
- پارامترهای مسیر
- بدنه درخواست
- متن پاسخ
- دامنههای مجوز
- UpdateOneTimeProductOfferStateRequest
- CancelOneTimeProductOfferRequest
- DeactivateOneTimeProductOfferRequest
- امتحان کنید!
دستهای از وضعیتهای پیشنهاد ویژه محصول یکباره را بهروز میکند.
درخواست HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdateStates
این نشانی وب از نحو تراتبدیل gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
packageName |
الزامی. برنامه اصلی (نام بسته) پیشنهادهای ویژه محصول یکباره بهروزشده. |
productId |
الزامی. شناسه محصول محصول یکباره مادر، اگر همه پیشنهادهای ویژه بهروزشده به همان محصول یکباره تعلق داشته باشند. اگر این بهروزرسانی دستهای شامل چندین محصول یکباره میشود، این فیلد را روی «-» تنظیم کنید. |
purchaseOptionId |
الزامی. شناسه گزینه خرید گزینه خرید ولی، اگر همه پیشنهادهای ویژه بهروزشده متعلق به همان گزینه خرید باشند. اگر این بهروزرسانی دستهای شامل چندین گزینه خرید میشود، این فیلد را روی «-» تنظیم کنید. |
متن درخواست
بدنه درخواست حاوی دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{
"requests": [
{
object ( |
| فیلدها | |
|---|---|
requests[] |
الزامی. فهرست درخواست بهروزرسانی حداکثر ۱۰۰ عنصر. همه درخواستها باید پیشنهادهای مختلف را بهروز کنند. |
بدنه پاسخ
پیام پاسخ برای offers.batchUpdateStates.
اگر موفقیتآمیز باشد، بدنه پاسخ حاوی دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{
"oneTimeProductOffers": [
{
object ( |
| فیلدها | |
|---|---|
oneTimeProductOffers[] |
فهرست بهروزشده پیشنهادهای ویژه محصول یکباره، با همان ترتیب درخواست. |
دامنههای مجوز
به گستره 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 |
پیشنهاد ویژهای را لغو میکند. پساز لغو، پیشنهاد ویژه برای کاربران دردسترس نخواهد بود. همه سفارشهای معلق مربوط به این پیشنهاد لغو خواهد شد. این انتقال وضعیت مختص پیشسفارشها است. |
deactivateOneTimeProductOfferRequest |
پیشنهاد ویژهای را غیرفعال میکند. پساز غیرفعال شدن، پیشنهاد ویژه دیگر برای کاربران دردسترس نخواهد بود. این انتقال وضعیت مختص پیشنهادهای تخفیفدار و پاداش بازی است. |
| پایان فیلدهای متقابلاً انحصاری. | |
CancelOneTimeProductOfferRequest
پیام درخواست برای offers.cancel.
| نمایش JSON |
|---|
{
"packageName": string,
"productId": string,
"purchaseOptionId": string,
"offerId": string,
"latencyTolerance": enum ( |
| فیلدها | |
|---|---|
packageName |
الزامی. برنامه اصلی (نام بسته) پیشنهاد ویژه برای لغو. |
productId |
الزامی. محصول یکباره اصلی (شناسه) پیشنهاد ویژه برای لغو. |
purchaseOptionId |
الزامی. گزینه خرید ولی (شناسه) پیشنهاد ویژه برای لغو. |
offerId |
الزامی. شناسه پیشنهاد ویژه برای لغو کردن. |
latencyTolerance |
اختیاری. میزان تأخیر مجاز برای انتشار این بهروزرسانی. بهطور پیشفرض روی «حساس به تأخیر» تنظیم شده است. |
DeactivateOneTimeProductOfferRequest
پیام درخواست برای offers.deactivate.
| نمایش JSON |
|---|
{
"packageName": string,
"productId": string,
"purchaseOptionId": string,
"offerId": string,
"latencyTolerance": enum ( |
| فیلدها | |
|---|---|
packageName |
الزامی. برنامه اصلی (نام بسته) پیشنهاد ویژه برای غیرفعال کردن. |
productId |
الزامی. محصول یکباره اصلی (شناسه) پیشنهاد ویژه برای غیرفعال کردن. |
purchaseOptionId |
الزامی. گزینه خرید ولی (شناسه) پیشنهاد ویژه برای غیرفعال کردن. |
offerId |
الزامی. شناسه پیشنهاد ویژه برای غیرفعال کردن. |
latencyTolerance |
اختیاری. میزان تأخیر مجاز برای انتشار این بهروزرسانی. بهطور پیشفرض روی «حساس به تأخیر» تنظیم شده است. |