Method: inventory.partners.feeds.record.batchDelete
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
지정된 피드 유형의 레코드를 삭제합니다. 기본 유효성 검사(예: 잘못된 형식의 요청)만 실행한 후 적절한 응답을 파트너에게 즉시 반환합니다. Google은 요청에 대해 비즈니스 로직 유효성 검사를 비동기식으로 실행합니다. 이러한 일괄 호출이 원자성을 보장하지 않습니다.
HTTP 요청
POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/feeds/*}/record:batchDelete
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 |
parent |
string
partners/{partner_id}/feeds/{feed_name} 형식으로 된 리소스 이름입니다.
|
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
필드 |
records[] |
object (GenericDeleteRecord )
삭제할 레코드입니다. 한 번의 API 호출에는 최대 1,000개의 레코드가 허용됩니다.
|
응답 본문
성공한 경우 응답 본문은 비어 있습니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/mapsbooking
GenericDeleteRecord
URL 요청에 언급된 피드 유형의 삭제할 레코드입니다.
JSON 표현 |
{
"deleteTime": string,
// Union field record_type can be only one of the following:
"dataRecord": string,
"protoRecord": {
"@type": string,
field1: ...,
...
}
// End of list of possible types for union field record_type .
} |
필드 |
deleteTime |
string (Timestamp format)
필수 항목입니다. 이 타임스탬프는 인벤토리에 삭제를 적용할 순서를 결정하는 데 사용됩니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z" 입니다.
|
통합 필드 record_type . 다양한 유형의 피드(ndjson, 프로토 기반 등) 캡슐화 파트너는 피드 또는 BatchPush API에 레코드를 제공하는 것과 유사한 방식으로 전체 기록을 제공할 수 있습니다. 파트너는 레코드를 고유하게 식별하는 데 필요한 필드만 포함할 수도 있습니다. record_type 은 다음 중 하나여야 합니다. |
dataRecord |
string (bytes format)
프로토 기반이 아닌 피드의 경우 base64 인코딩 문자열입니다.
|
protoRecord |
object
proto 기반 피드의 경우 임의 유형의 필드를 포함하는 객체입니다. 추가 필드 "@type" 은 유형을 식별하는 URI를 포함합니다. 예: { "id": 1234, "@type": "types.example.com/standard/id" }
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-24(UTC)
[null,null,["최종 업데이트: 2025-07-24(UTC)"],[[["\u003cp\u003eThis API endpoint (\u003ccode\u003ebatchDelete\u003c/code\u003e) is used to delete records from a specified feed within the Google Maps Booking inventory.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the \u003ccode\u003eparent\u003c/code\u003e (partner and feed) and an array of \u003ccode\u003erecords\u003c/code\u003e to be deleted, with a maximum of 1000 records per call.\u003c/p\u003e\n"],["\u003cp\u003eEach record to be deleted (\u003ccode\u003eGenericDeleteRecord\u003c/code\u003e) can be identified either by a full data record or a unique identifier, depending on the feed type.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003edeleteTime\u003c/code\u003e field is crucial for determining the order of deletion, ensuring data consistency.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful deletion requests will return an empty response body.\u003c/p\u003e\n"]]],[],null,["# Method: inventory.partners.feeds.record.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- [GenericDeleteRecord](#GenericDeleteRecord)\n - [JSON representation](#GenericDeleteRecord.SCHEMA_REPRESENTATION)\n\nDeletes records of specified feed type. Only performs basic validation (like malformed request) after which an appropriate response is returned to the partner immediately. Google performs business logic validation on the request asynchronously. This batch call does not guarantee atomicity.\n\n### HTTP request\n\n`POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/feeds/*}/record:batchDelete`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------------------------------------------|\n| `parent` | `string` Resource name, which has the format of - `partners/{partner_id}/feeds/{feed_name}`. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"records\": [ { object (/maps-booking/reference/maps-booking-api/rest/v1alpha/inventory.partners.feeds.record/batchDelete#GenericDeleteRecord) } ] } ``` |\n\n| Fields ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `records[]` | `object (`[GenericDeleteRecord](/maps-booking/reference/maps-booking-api/rest/v1alpha/inventory.partners.feeds.record/batchDelete#GenericDeleteRecord)`)` Records to be deleted. Maximum of 1000 records are allowed in one api call. |\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/mapsbooking`\n\nGenericDeleteRecord\n-------------------\n\nRecord to be deleted of the feed type mentioned in url request.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"deleteTime\": string, // Union field `record_type` can be only one of the following: \"dataRecord\": string, \"protoRecord\": { \"@type\": string, field1: ..., ... } // End of list of possible types for union field `record_type`. } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `delete``Time` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Required. This timestamp is used to determine the order in which a delete will be applied to the inventory. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n| Union field `record_type`. Encapsulate different types of feed (ndjson, proto-based, etc.) Partner can provide a full record similar to how a record is provided in a feed or BatchPush API. Partners also have the option to include only the essential fields of a record required to uniquely identify it. `record_type` can be only one of the following: ||\n| `data``Record` | `string (`[bytes](https://developers.google.com/discovery/v1/type-format)` format)` For non-proto based feeds. A base64-encoded string. |\n| `proto``Record` | `object` For proto-based feeds. An object containing fields of an arbitrary type. An additional field `\"@type\"` contains a URI identifying the type. Example: `{ \"id\": 1234, \"@type\": \"types.example.com/standard/id\" }`. |"]]