메인 콘텐츠로 건너뛰기

​
개요

Catalog API는 광고주가 제품 피드를 설정하고, 제품을 세트로 묶고, 카탈로그 제품을 통합적으로 관리할 수 있도록 하는 커머스 솔루션입니다. Catalog API는 프로그램적 카탈로그 관리를 가능하게 하는 핵심 도구로, 광고주가 카탈로그의 수집 및 업데이트 방식을 보다 세밀하게 제어할 수 있게 해줍니다. 카탈로그에는 사용자의 제품 및 제품 세트 관련 모든 정보가 포함되며, 사용자의 핸들과 연결됩니다. 현재는 한 사용자가 하나의 카탈로그만 생성할 수 있습니다.  Catalog API는 제품을 가져오는 두 가지 방식을 지원합니다:
  1. Scheduled Feed: 사용자는 주기적으로 가져올 피드 URL(CSV, TSV, XML)을 추가할 수 있습니다(X는 현재 최대 8GB 파일을 지원)
  2. Batch Products API: 사용자는 배치(JSON) 요청으로 제품 속성을 조회, 생성, 업데이트 및 삭제할 수 있습니다
X 판매자는 필터 규칙을 기반으로 제품 세트를 생성할 수 있습니다. 이를 통해 제품에 추가 메타데이터를 부여하고, 오가닉 커머스 기능 또는 동적 제품 광고를 통해 해당 제품을 선보이기 위한 특수 제품 세트를 만들 수 있습니다. Catalog API와 X Shopping Manager는 두 가지 유형의 제품 세트를 지원합니다. 
  1. Manual: 사용자는 최대 50개의 제품을 선택하고 이름과 설명을 설정할 수 있습니다
  2. Filter: 사용자는 최대 30개의 필터를 추가하여 해당 조건을 충족하는 제품으로 세트를 자동 생성할 수 있습니다. 필터 유형에는 가격, Google 제품 카테고리, 제품 유형, 재고, 세일 가격, 커스텀 필드가 포함됩니다.
Catalog API에는 카탈로그를 관리하기 위한 4개의 엔드포인트가 포함됩니다:
  • Product Catalogs - 제품 정보를 위한 컨테이너 생성
  • Products - 카탈로그에서 제품을 동기적으로 추가, 업데이트, 조회 및 제거
  • Product Sets - 제품 정보를 기준으로 제품을 그룹으로 분류
  • Scheduled Feeds - 파일 기반 제품 데이터를 카탈로그로 비동기 수집 설정

​
Catalog API의 사전 필요 조건

Catalog API 엔드포인트는 현재 얼리 액세스로만 제공됩니다. 액세스를 신청하려면 귀하의 X 담당자에게 문의해 주세요. X Shopping Manager를 통해 서비스 약관에 동의해야 합니다. Shopping Manager 및 제품 사양에 대한 자세한 내용은 제품 사양 가이드를 참조하세요.

​
요청 한도 

다음 표에는 엔드포인트별 요청 한도가 표시되어 있습니다.

​
제품 카탈로그

HTTP 메서드속도 제한
GET /product_catalogs15분당 1,000회
POST /product_catalogs15분당 20회
PUT /product_catalogs/:product_catalog_id15분당 20회
DELETE /product_catalogs/:product_catalog_id15분당 20회

​
배치 상품 API

HTTP 메서드호출 한도
GET /product_catalogs/:product_catalog_id/products15분당 1,000회
PUT /product_catalogs/:product_catalog_id/products15분당 600회
DELETE /product_catalogs/:product_catalog_id/products15분당 150회

​
제품 세트

HTTP 메서드요청 한도
GET /product_catalogs/:product_catalog_id/product_sets15분당 2,000회
POST /product_catalogs/:product_catalog_id/product_sets15분당 100회
PUT /product_catalogs/:product_catalog_id/product_sets/:product_set_id15분당 500회
DELETE /product_catalogs/:product_catalog_id/product_sets/:product_set_id15분당 100회

​
제품 피드

HTTP 메서드요청 한도
GET /product_catalogs/:product_catalog_id/product_feeds15분당 1,000회
POST /product_catalogs/:product_catalog_id/product_feeds15분당 20회
PUT /product_catalogs/:product_catalog_id/product_feeds/:product_feed_id15분당 20회
DELETE /product_catalogs/:product_catalog_id/product_feeds/:product_feed_id15분당 20회