Method: monetization.onetimeproducts.purchaseOptions.batchDelete
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
گزینه های خرید را در یک یا چند محصول یکبار مصرف حذف می کند.
به‌طور پیش‌فرض، اگر پیشنهادات موجود در گزینه‌های خرید حذف‌شده وجود داشته باشد، این عملیات با شکست مواجه می‌شود. از پارامتر نیرو برای نادیده گرفتن رفتار پیش فرض استفاده کنید.
درخواست HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions:batchDelete
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
packageName | string مورد نیاز. برنامه والد (نام بسته) گزینه‌های خرید برای حذف. |
productId | string مورد نیاز. شناسه محصول محصول یکبار مصرف والد، اگر همه گزینه‌های خرید برای حذف متعلق به همان محصول یکبار مصرف باشد. اگر این حذف دسته ای شامل چندین محصول یک بار مصرف می شود، این قسمت را روی "-" تنظیم کنید. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| فیلدها |
|---|
requests[] | object ( DeletePurchaseOptionRequest ) مورد نیاز. لیستی از درخواست های حذف تا 100 عنصر. همه درخواست‌ها باید گزینه‌های خرید را از محصولات مختلف یک بار مصرف حذف کنند. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ یک شی JSON خالی است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/androidpublisher
DeletePurchaseOptionRequest
درخواست پیام برای حذف گزینه خرید.
| نمایندگی JSON |
|---|
{
"packageName": string,
"productId": string,
"purchaseOptionId": string,
"latencyTolerance": enum (ProductUpdateLatencyTolerance),
"force": boolean
} |
| فیلدها |
|---|
packageName | string مورد نیاز. برنامه والد (نام بسته) گزینه خرید برای حذف. |
productId | string مورد نیاز. محصول یک بار مصرف والدین (ID) گزینه خرید برای حذف. |
purchaseOptionId | string مورد نیاز. شناسه گزینه خرید گزینه خرید برای حذف. |
latencyTolerance | enum ( ProductUpdateLatencyTolerance ) اختیاری. تحمل تأخیر برای انتشار این به‌روزرسانی محصول. به طور پیش فرض حساس به تأخیر است. |
force | boolean اختیاری. این فیلد برای گزینه های خرید که هیچ پیشنهادی در زیر آنها وجود ندارد، تأثیری ندارد. برای گزینه‌های خرید با پیشنهادات مرتبط: * اگر force روی false (پیش‌فرض) تنظیم شود، یک خطا برگردانده می‌شود. * اگر force روی true تنظیم شود، هر پیشنهاد مرتبط تحت گزینه خرید حذف خواهد شد. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: monetization.onetimeproducts.purchaseOptions.batchDelete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [DeletePurchaseOptionRequest](#DeletePurchaseOptionRequest)\n - [JSON representation](#DeletePurchaseOptionRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nDeletes purchase options across one or multiple one-time products.\n\nBy default this operation will fail if there are any existing offers under the deleted purchase options. Use the force parameter to override the default behavior.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions:batchDelete`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` Required. The parent app (package name) of the purchase options to delete. |\n| `productId` | `string` Required. The product ID of the parent one-time product, if all purchase options to delete belong to the same one-time product. If this batch delete spans multiple one-time products, set this field to \"-\". |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"requests\": [ { object (/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions/batchDelete#DeletePurchaseOptionRequest) } ] } ``` |\n\n| Fields ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[DeletePurchaseOptionRequest](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions/batchDelete#DeletePurchaseOptionRequest)`)` Required. A list of delete requests of up to 100 elements. All requests must delete purchase options from different one-time products. |\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`\n\nDeletePurchaseOptionRequest\n---------------------------\n\nRequest message for deleting a purchase option.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"packageName\": string, \"productId\": string, \"purchaseOptionId\": string, \"latencyTolerance\": enum (/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance), \"force\": boolean } ``` |\n\n| Fields ||\n|--------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` Required. The parent app (package name) of the purchase option to delete. |\n| `productId` | `string` Required. The parent one-time product (ID) of the purchase option to delete. |\n| `purchaseOptionId` | `string` Required. The purchase option ID of the purchase option to delete. |\n| `latencyTolerance` | `enum (`[ProductUpdateLatencyTolerance](/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance)`)` Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive. |\n| `force` | `boolean` Optional. This field has no effect for purchase options with no offers under them. For purchase options with associated offers: \\* If `force` is set to false (default), an error will be returned. \\* If `force` is set to true, any associated offers under the purchase option will be deleted. |"]]
