Skip to main content
Dynamic Product Ads를 위한 제품 카탈로그, 제품, product set, 예약 피드를 프로그래밍 방식으로 관리하세요.

빠른 링크

개요

Catalog API는 광고주에게 product feed를 설정하고, 제품을 세트로 그룹화하며, catalog 제품을 전반적으로 관리할 수 있는 능력을 제공하는 커머스 솔루션입니다. Catalog API는 프로그래밍 방식의 catalog 관리를 지원하며, 광고주에게 catalog가 수집되고 업데이트되는 방식에 대한 더 많은 제어권을 부여합니다. catalog는 사용자의 제품 및 product set에 관한 모든 것을 담고 있으며, 사용자의 handle과 연결됩니다. 현재 사용자당 하나의 catalog만 생성할 수 있습니다. Catalog API는 제품을 수집하는 두 가지 방법을 지원합니다:
  1. Scheduled Feed: 주기적으로 가져올 feed URL(CSV, TSV, XML)을 추가합니다. X는 최대 8GB 파일을 지원합니다.
  2. Batch Products API: 배치(JSON) 요청으로 제품 속성을 조회, 생성, 업데이트, 삭제합니다.
X 판매자는 필터 규칙을 기반으로 product set을 만들 수 있습니다. 이를 통해 제품에 추가 메타데이터를 첨부하고 오가닉 커머스 기능이나 Dynamic Product Ads를 위한 특별한 product set을 만들 수 있습니다. Catalog API 및 X Shopping Manager는 두 가지 유형의 product set을 지원합니다:
  1. Manual: 최대 50개의 제품을 선택하고 이름과 설명을 설정합니다.
  2. Filter: 최대 30개의 필터를 추가하여 세트를 자동으로 생성합니다(가격, Google 제품 카테고리, 제품 유형, 재고, 세일 가격, 사용자 정의 필드 등).

사전 요건

Catalog API 엔드포인트는 현재 얼리 액세스 전용으로만 제공됩니다. 액세스를 신청하려면 X 담당자에게 문의하거나 해당 양식을 작성하세요. X Shopping Manager를 통해 서비스 약관에 동의해야 합니다. 제품 사양 및 Shopping Manager 세부 정보는 Product specifications 가이드를 참조하세요.

Rate Limit

Product Catalog

Batch Products API

Product Sets

Scheduled Feeds

전체 API 참조

전체 참조(Product Catalogs, Products, Product Sets, Scheduled Feeds 엔드포인트)는 Catalog Management API Reference 페이지를 참조하세요.