Method: inappproducts.batchDelete
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
حذف المنتجات داخل التطبيق (المنتجات المُدارة أو الاشتراكات)
اضبط حقل latencyTolerance في الطلبات المُدمجة على PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT لتحقيق الحد الأقصى من معدل نقل البيانات للتعديل.
يجب عدم استخدام هذه الطريقة لحذف الاشتراكات. يُرجى الاطّلاع على هذه المقالة للحصول على مزيد من المعلومات.
طلب HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/inappproducts:batchDelete
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
packageName |
string
اسم حزمة التطبيق
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| الحقول |
requests[] |
object (InappproductsDeleteRequest)
طلبات حذف فردية يجب تقديم طلب واحد على الأقل. يمكن أن يحتوي على ما يصل إلى 100 طلب. يجب أن تتوافق جميع الطلبات مع منتجات مختلفة داخل التطبيق.
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة عنصر JSON فارغًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
InappproductsDeleteRequest
طلب حذف منتج داخل التطبيق
| الحقول |
packageName |
string
اسم حزمة التطبيق
|
sku |
string
معرّف فريد للمنتج داخل التطبيق
|
latencyTolerance |
enum (ProductUpdateLatencyTolerance)
اختياريّ. الحدّ المسموح به لوقت الاستجابة لنشر تحديث المنتج هذا. الإعداد التلقائي هو "حساسة لوقت الاستجابة".
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eDeletes in-app products (managed products or subscriptions) in batches using the \u003ccode\u003ebatchDelete\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing a list of delete requests, each specifying the package name and SKU of the in-app product to be deleted.\u003c/p\u003e\n"],["\u003cp\u003eSupports setting latency tolerance for product update propagation, potentially improving update throughput.\u003c/p\u003e\n"],["\u003cp\u003eUses the \u003ccode\u003eandroidpublisher\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eIt's crucial to note that this method should not be used to delete subscriptions, as per the linked article.\u003c/p\u003e\n"]]],["This document details how to batch delete in-app products (excluding subscriptions) via the Android Publisher API. Key actions involve sending a `POST` request to `https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/inappproducts:batchDelete`. The request body must include an array of `InappproductsDeleteRequest` objects, each specifying the `packageName`, `sku`, and optional `latencyTolerance`. The API uses `gRPC Transcoding`. Successful deletion returns an empty JSON object. Authorization requires the `androidpublisher` OAuth scope.\n"],null,["# Method: inappproducts.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- [InappproductsDeleteRequest](#InappproductsDeleteRequest)\n - [JSON representation](#InappproductsDeleteRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nDeletes in-app products (managed products or subscriptions).\n\nSet the latencyTolerance field on nested requests to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT to achieve maximum update throughput.\n\nThis method should not be used to delete subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/inappproducts:batchDelete`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|-----------------------------------|\n| `packageName` | `string` Package name of the app. |\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/inappproducts/batchDelete#InappproductsDeleteRequest) } ] } ``` |\n\n| Fields ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[InappproductsDeleteRequest](/android-publisher/api-ref/rest/v3/inappproducts/batchDelete#InappproductsDeleteRequest)`)` Individual delete requests. At least one request is required. Can contain up to 100 requests. All requests must correspond to different in-app 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\nInappproductsDeleteRequest\n--------------------------\n\nRequest to delete an in-app product.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"packageName\": string, \"sku\": string, \"latencyTolerance\": enum (/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance) } ``` |\n\n| Fields ||\n|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` Package name of the app. |\n| `sku` | `string` Unique identifier for the in-app product. |\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. |"]]
