카탈로그 관리

​

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_catalogs	15분당 1,000회
POST /product_catalogs	15분당 20회
PUT /product_catalogs/:product_catalog_id	15분당 20회
DELETE /product_catalogs/:product_catalog_id	15분당 20회

​

배치 제품 API

HTTP Method	요청 한도
GET /product_catalogs/:product_catalog_id/products	15분당 1,000회
PUT /product_catalogs/:product_catalog_id/products	15분당 600회
DELETE /product_catalogs/:product_catalog_id/products	15분당 150회

​

제품 세트

HTTP Method	요청 한도
GET /product_catalogs/:product_catalog_id/product_sets	15분당 2,000회
POST /product_catalogs/:product_catalog_id/product_sets	15분당 100회
PUT /product_catalogs/:product_catalog_id/product_sets/:product_set_id	15분당 500회
DELETE /product_catalogs/:product_catalog_id/product_sets/:product_set_id	15분당 100회

​

상품 피드

HTTP Method	요청 한도
GET /product_catalogs/:product_catalog_id/product_feeds	15분당 1,000회
POST /product_catalogs/:product_catalog_id/product_feeds	15분당 20회
PUT /product_catalogs/:product_catalog_id/product_feeds/:product_feed_id	15분당 20회
DELETE /product_catalogs/:product_catalog_id/product_feeds/:product_feed_id	15분당 20회