Method: indexing.datasources.items.delete
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تحذف Item resource لاسم المورد المحدّد. تتطلّب واجهة برمجة التطبيقات هذه حساب مشرف أو حساب خدمة لتنفيذها. حساب الخدمة المستخدَم هو الحساب المدرَج في القائمة المسموح بها في مصدر البيانات المقابل.
طلب HTTP
DELETE https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*/items/*}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
name |
string
مطلوب. اسم العنصر المطلوب حذفه. التنسيق: datasources/{sourceId}/items/{itemId}
|
مَعلمات طلب البحث
| المعلمات |
version |
string (bytes format)
مطلوب. الإصدار المتزايد للعنصر المطلوب حذفه من الفهرس يخزِّن نظام الفهرسة الإصدار من مصدر البيانات كسلسلة من وحدات البايت ويقارن إصدار السلعة في الفهرس بإصدار السلعة في "قائمة الانتظار" باستخدام الترتيب المعجمي. لن تحذف ميزة "فهرسة Cloud Search" أي عنصر في "قائمة الانتظار" إذا كانت قيمة الإصدار أقل من أو مساوية لقيمة الإصدار للعنصر المفهرَس حاليًا. الحد الأقصى لطول هذا الحقل هو 1024 بايت. للحصول على معلومات عن كيفية تأثير إصدار العنصر في عملية الحذف، يُرجى الرجوع إلى مقالة معالجة المراجعات بعد عمليات الحذف اليدوي. سلسلة بترميز base64
|
connectorName |
string
اسم الموصِّل الذي يُجري هذا الطلب التنسيق: datasources/{sourceId}/connectors/{id}
|
mode |
enum (RequestMode.Mode)
مطلوب. وضع الطلب لهذا الطلب.
|
debugOptions |
object (DebugOptions)
خيارات تصحيح الأخطاء الشائعة
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation.
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/cloud_search.indexinghttps://www.googleapis.com/auth/cloud_search
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: indexing.datasources.items.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDeletes [Item resource](/workspace/cloud-search/docs/reference/rest/v1/indexing.datasources.items#Item) for the specified resource name. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source.\n\n### HTTP request\n\n`DELETE https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*/items/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|--------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of the item to delete. Format: datasources/{sourceId}/items/{itemId} |\n\n### Query parameters\n\n| Parameters ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `version` | `string (`[bytes](https://developers.google.com/discovery/v1/type-format)` format)` Required. The incremented version of the item to delete from the index. The indexing system stores the version from the datasource as a byte string and compares the Item version in the index to the version of the queued Item using lexical ordering. Cloud Search Indexing won't delete any queued item with a version value that is less than or equal to the version of the currently indexed item. The maximum length for this field is 1024 bytes. For information on how item version affects the deletion process, refer to [Handle revisions after manual deletes](https://developers.google.com/workspace/cloud-search/docs/guides/operations). A base64-encoded string. |\n| `connectorName` | `string` The name of connector making this call. Format: datasources/{sourceId}/connectors/{id} |\n| `mode` | `enum (`[RequestMode.Mode](/workspace/cloud-search/docs/reference/rest/v1/RequestMode.Mode)`)` Required. The RequestMode for this request. |\n| `debugOptions` | `object (`[DebugOptions](/workspace/cloud-search/docs/reference/rest/v1/DebugOptions)`)` Common debug options. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/workspace/cloud-search/docs/reference/rest/v1/operations#Operation).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud_search.indexing`\n- `https://www.googleapis.com/auth/cloud_search`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
