Method: indexing.datasources.items.delete
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
지정된 리소스 이름의 Item resource를 삭제합니다. 이 API를 실행하려면 관리자 또는 서비스 계정이 필요합니다. 사용되는 서비스 계정은 해당 데이터 소스에 허용 목록에 추가된 계정입니다.
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 색인은 현재 색인이 생성된 항목의 버전과 같거나 낮은 버전 값을 가진 대기열에 있는 항목을 삭제하지 않습니다. 이 필드의 최대 길이는 1,024바이트입니다. 상품 버전이 삭제 프로세스에 미치는 영향에 대한 자세한 내용은 수동 삭제 후 버전 처리를 참고하세요. base64 인코딩 문자열입니다.
|
connectorName |
string
이 호출을 실행하는 커넥터의 이름입니다. 형식: datasources/{sourceId}/connectors/{id}
|
mode |
enum (RequestMode.Mode)
필수 항목입니다. 이 요청의 RequestMode입니다.
|
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 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[],[],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)."]]
