Method: monetization.onetimeproducts.purchaseOptions.offers.batchDelete
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يحذف هذا الإجراء عرضًا واحدًا أو أكثر من عروض المنتجات التي يتم تحصيل سعرها مرة واحدة.
طلب HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchDelete
يستخدِم عنوان URL بنية تحويل الترميز gRPC.
مَعلمات المسار
المعلمات |
packageName |
string
مطلوب. التطبيق الرئيسي (اسم الحزمة) للعروض المطلوب حذفها يجب أن تكون القيمة مساوية لحقل packageName في جميع موارد OneTimeProductOffer.
|
productId |
string
مطلوب. معرّف المنتج الرئيسي الذي يتم تحصيل سعره مرة واحدة، إذا كانت جميع عروض الحذف تنتمي إلى المنتج نفسه إذا كان هذا الطلب يشمل عدة منتجات تُدفع لمرة واحدة، اضبط هذا الحقل على "-".
|
purchaseOptionId |
string
مطلوب. خيار الشراء الرئيسي (المعرّف) الذي يجب حذف العروض المرتبطة به يمكن تحديدها على أنّها "-" لتعديل العروض من خيارات شراء متعددة.
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
الحقول |
requests[] |
object (DeleteOneTimeProductOfferRequest )
مطلوب. قائمة بطلبات التعديل التي تتضمّن ما يصل إلى 100 عنصر يجب أن تتوافق جميع الطلبات مع عروض مختلفة.
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيكون نص الاستجابة عبارة عن كائن JSON فارغ.
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
DeleteOneTimeProductOfferRequest
رسالة الطلب لحذف عرض منتج يتم تحصيل سعره مرة واحدة
تمثيل JSON |
{
"packageName": string,
"productId": string,
"purchaseOptionId": string,
"offerId": string,
"latencyTolerance": enum (ProductUpdateLatencyTolerance )
} |
الحقول |
packageName |
string
مطلوب. التطبيق الرئيسي (اسم الحزمة) للعرض الترويجي المطلوب حذفه
|
productId |
string
مطلوب. المنتج الرئيسي الذي يتم تحصيل سعره مرة واحدة (المعرّف) للعرض المراد حذفه
|
purchaseOptionId |
string
مطلوب. تمثّل هذه السمة خيار الشراء الرئيسي (المعرّف) للعرض الذي سيتم حذفه.
|
offerId |
string
مطلوب. المعرّف الفريد للعرض الترويجي الذي سيتم حذفه.
|
latencyTolerance |
enum (ProductUpdateLatencyTolerance )
اختيارية: الحدّ الأقصى لوقت الاستجابة المسموح به لنشر تعديل المنتج هذا. يتم ضبط القيمة التلقائية على "حساسة لوقت الاستجابة".
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: monetization.onetimeproducts.purchaseOptions.offers.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- [DeleteOneTimeProductOfferRequest](#DeleteOneTimeProductOfferRequest)\n - [JSON representation](#DeleteOneTimeProductOfferRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nDeletes one or more one-time product offers.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers: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 offers to delete. Must be equal to the packageName field on all the OneTimeProductOffer resources. |\n| `productId` | `string` Required. The product ID of the parent one-time product, if all offers to delete belong to the same product. If this request spans multiple one-time products, set this field to \"-\". |\n| `purchaseOptionId` | `string` Required. The parent purchase option (ID) for which the offers should be deleted. May be specified as '-' to update offers from multiple purchase options. |\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.offers/batchDelete#DeleteOneTimeProductOfferRequest) } ] } ``` |\n\n| Fields ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[DeleteOneTimeProductOfferRequest](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions.offers/batchDelete#DeleteOneTimeProductOfferRequest)`)` Required. A list of update requests of up to 100 elements. All requests must correspond to different offers. |\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\nDeleteOneTimeProductOfferRequest\n--------------------------------\n\nRequest message for deleting an one-time product offer.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"packageName\": string, \"productId\": string, \"purchaseOptionId\": string, \"offerId\": string, \"latencyTolerance\": enum (/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance) } ``` |\n\n| Fields ||\n|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` Required. The parent app (package name) of the offer to delete. |\n| `productId` | `string` Required. The parent one-time product (ID) of the offer to delete. |\n| `purchaseOptionId` | `string` Required. The parent purchase option (ID) of the offer to delete. |\n| `offerId` | `string` Required. The unique offer ID of the offer 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. |"]]