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
如需了解详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):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)."]]