카탈로그 배치 API

이 가이드에서는 카탈로그 배치 API를 사용하는 방법을 설명합니다.

어드밴티지+ 카탈로그 광고 카탈로그 — 재고 변동이 큰 수백만 개의 제품이 포함된 카탈로그와 같이 규모가 큰 카탈로그가 있는 경우 이 API를 사용하세요. 단일 HTTP 요청에서 여러 항목을 생성, 업데이트 및 삭제할 수 있습니다.
커머스 카탈로그 — 1시간에 2회 이상 제품 정보를 업데이트해야 할 경우 이 API를 사용하세요(그렇지 않을 경우 피드 API 사용). 단일 HTTP 요청에서 여러 항목을 업데이트할 수 있습니다.

사용 방법

재고 변동이 큰 수백만 개의 제품이 포함된 카탈로그와 같이 규모가 큰 카탈로그가 있는 경우 카탈로그 배치 API를 사용하세요. 단일 HTTP 요청에서 여러 항목을 생성, 업데이트 및 삭제할 수 있습니다.

카탈로그 배치 API는 다음의 엔드포인트로 구성됩니다.

엔드포인트 설명 가이드 내용

엔드포인트	설명	가이드 내용
`POST`/{catalog_id}/items_batch	카탈로그에 대한 요청 배치(생성, 업데이트, 삭제)를 전송합니다. 제품, 호텔, 호텔 객실, 항공편, 목적지, 주택 매물, 차량, 차량 쿠폰 등의 여러 가지 개체에 사용됩니다. 모든 MAPI 버전 3.2 이하를 지원합니다.	제품 업데이트 전송
`GET`/{catalog_id}/check_batch_request_status	배치 요청 상태를 확인합니다. (`{catalog_id}/batch`에 대한 호출에서 반환된) 핸들을 사용하여 `GET`을 호출합니다. 모든 MAPI 버전 3.1 미만을 지원합니다.	배치 요청 상태 확인
`POST`/{catalog_id}/localized_items_batch	카탈로그의 기존 카탈로그 항목으로 배치 현지화 요청을 보냅니다. 배치는 현지화 요청을 포함(생성, 업데이트, 삭제)할 수 있습니다. 이 엔드포인트는 제품, 호텔, 항공편, 목적지, 주택 매물, 차량 등의 여러 가지 개체에 사용할 수 있습니다. 3.1 미만인 모든 MAPI 버전을 지원합니다.	현지화된 항목 배치 전송

카탈로그에 대한 요청 배치(생성, 업데이트, 삭제)를 전송합니다. 제품, 호텔, 호텔 객실, 항공편, 목적지, 주택 매물, 차량, 차량 쿠폰 등의 여러 가지 개체에 사용됩니다.

모든 MAPI 버전 3.2 이하를 지원합니다.

배치 요청 상태를 확인합니다. ({catalog_id}/batch에 대한 호출에서 반환된) 핸들을 사용하여 GET을 호출합니다.

모든 MAPI 버전 3.1 미만을 지원합니다.

카탈로그의 기존 카탈로그 항목으로 배치 현지화 요청을 보냅니다. 배치는 현지화 요청을 포함(생성, 업데이트, 삭제)할 수 있습니다. 이 엔드포인트는 제품, 호텔, 항공편, 목적지, 주택 매물, 차량 등의 여러 가지 개체에 사용할 수 있습니다.

3.1 미만인 모든 MAPI 버전을 지원합니다.

카탈로그 배치 API 가이드를 사용하면 카탈로그 배치 API로 일반적인 작업을 수행하는 데 도움이 됩니다.