> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 카탈로그 관리

<div id="overview">
  ## Overview
</div>

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](https://developer.x.com/en/docs/x-ads-api/catalog-management/api-reference/product-catalogs) - 상품 정보를 위한 컨테이너 생성
* [Products](https://developer.x.com/en/docs/x-ads-api/catalog-management/api-reference/products) -  카탈로그에서 상품을 동기적으로 추가, 업데이트, 조회 및 제거
* [Product Sets](https://developer.x.com/en/docs/x-ads-api/catalog-management/api-reference/product-sets) -  상품 정보를 기반으로 상품을 그룹으로 분류
* [Schedule Feeds](https://developer.x.com/en/docs/twitter-ads-api/catalog-management/api-reference/scheduled-feeds) - 파일 기반 상품 데이터를 카탈로그로 비동기 적재하도록 설정

<div id="prerequisites-for-the-catalog-api">
  ### Catalog API를 사용하기 위한 사전 준비 사항
</div>

Catalog API 엔드포인트는 현재 조기 액세스 프로그램을 통해서만 제공됩니다. 액세스를 신청하려면 X 담당자에게 문의해 주세요. 

서비스 약관에 동의하려면 [X Shopping Manager](https://ads.x.com/shopping_manager)를 통해 진행해야 합니다.

X Shopping Manager와 상품 사양에 대한 자세한 내용은 [상품 사양 가이드](https://business.x.com/en/help/shopping-specs.html)를 참고하세요.

<div id="rate-limits">
  ### 요청 한도
</div>

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

<div id="product-catalog">
  #### 상품 카탈로그
</div>

| 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회    |

<div id="batch-products-api">
  #### 배치 제품 API
</div>

| 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회   |

<div id="product-sets">
  #### 제품 세트
</div>

| 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회   |

<div id="product-feeds">
  #### 상품 피드
</div>

| 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회    |