Method: indexing.datasources.items.delete
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
刪除指定資源名稱的 Item resource
。這個 API 需要管理員或服務帳戶才能執行。系統會使用對應資料來源中已加入白名單的服務帳戶。
HTTP 要求
DELETE https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*/items/*}
這個網址使用 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 )
必要欄位。此要求的 RequestMode。
|
debugOptions |
object (DebugOptions )
常見的偵錯選項。
|
回應主體
如果成功,回應主體會包含 Operation
的執行例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 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)."]]