> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/ja/references/catalog-products-reference.md).

# カタログ商品のリファレンス

以下は、次に記載されている標準同期リクエストで可能なプロパティの概要です： [API経由での商品同期](/retail-media-interface/integration/ja/data-api/catalog-products-2/syncing-products-via-api.md).

## リクエスト項目

| プロパティ       | 説明                                                                                                                     | 必須/オプショナル                                                     | 例                                                                                                                     |
| ----------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `catalogId` | 同期先のカタログ。                                                                                                              | 必須                                                            | `628dbe95-2ec9-4e07-881d-3e9f92ab2e0b`                                                                                |
| `filters`   | 商品に関連付けられているフィルター。これにはカテゴリ、場所、ブランド情報が含まれる場合があります。                                                                      | <p>必須<br>最大750文字</p>                                          | `"category:Health&Beauty","category:Grocery","Brand:Covergirl","Special_Flag:0"`                                      |
| `groups`    | クロスセルおよびアップセルキャンペーンに使用されます。                                                                                            | <p>選択グループでは非推奨です。<br>レガシー商品のクロスセルおよびアップセルキャンペーンでは引き続き必須です</p> | `[<br> "subClassName:Milk",<br> "xSellSubClassName:Coffee",<br> "xSellSubClassName:Tea"<br> "vendor:MilkBrand"<br> ]` |
| `gtin`      | システム内の商品の商品コード。                                                                                                        | <p>必須<br>最大50文字</p>                                           | `23556578965543`                                                                                                      |
| `inventory` | <p>システム内の商品の在庫。0に設定すると、商品広告は配信されません。<br><br>数を提示できない場合は、このフィールドを送信しないでください。 Epsilon Retail Media 在庫はデフォルトで1に設定されます</p> | <p>必須<br>32ビット符号なし整数を推奨</p>                                   | `1`                                                                                                                   |
| `price`     | 商品の価格                                                                                                                  | <p>オプショナル<br>小数点以下2桁を推奨</p>                                   | `9.90`                                                                                                                |
| `profit`    | 商品から得られる利益                                                                                                             | <p>オプショナル<br>小数点以下2桁を推奨</p>                                   |                                                                                                                       |
| `tags`      | ポータルで表示される商品名と画像を同期するために使用されます。例の構造に従ってください。 Epsilon Retail Media ポータル。例の構造に従ってください。                                   | <p>必須<br>最大750文字</p>                                          | `"imageurl:<https://your.image.host.com/image.jpg","name:Covergirl> Clean 120 Creamy Natural Liquid Foundation30mL"`  |
| `sellerId`  | セラーの一意のID。sellerIdsは通常、マーケットプレイスセラーをオンボーディングする際に使用されます。                                                                | <p>オプショナル<br>最大50文字</p>                                       | `73nns-32sxr-32ss` 連携ごとにカスタム                                                                                          |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/integration/ja/references/catalog-products-reference.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.