메인 콘텐츠로 건너뛰기

​
Overview

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

​
Catalog API를 사용하기 위한 사전 준비 사항

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

​
요청 한도

다음 표는 각 엔드포인트의 요청 한도를 보여 줍니다.

​
상품 카탈로그

HTTP Method요청 제한
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 Method요청 한도
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 Method요청 한도
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 Method요청 한도
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회