# GMC（Google Merchant Center）連携ガイド

## **連携方式**

* GMC連携は、お客様の環境に応じて2つの方式からお選びいただけます。

<table><thead><tr><th width="111.3828125">区分</th><th width="301.65234375">1. ファイルフィード連携</th><th>2. Merchant API連携</th></tr></thead><tbody><tr><td>方式</td><td>管理画面にファイルURLを登録（Google・YouTubeショッピング等で使用中のFeed URLを通じて商品を連携）</td><td>GMC Merchant APIの呼び出し方式で、指定のエンドポイントへ送信</td></tr><tr><td>収集方式</td><td>スケジュールベースの自動収集</td><td>リアルタイム連携</td></tr></tbody></table>

{% hint style="info" %}
**API連携方式**：Google Merchant APIの仕様に基づいたリクエストbodyを、そのまま専用エンドポイントへ送信してください。詳細なエンドポイントについては、下位の案内ドキュメントをご参照ください。
{% endhint %}

### **1. ファイルフィード連携**

#### Step 1. URL登録およびスケジュール設定

**管理画面でのURL登録**

* 管理画面の【連携商品管理 > GMC Feed】画面で連携設定ボタンを押し、以下の項目を入力します。&#x20;
* 自社サーバーにフィードファイルをアップロードした後、該当ファイルのURLを画面に登録します。

<figure><img src="/files/X8YRJy6w8aA1vvK44rmm" alt=""><figcaption></figcaption></figure>

**URL形式の条件**

* `http://` または `https://` を含む完全なURLである必要があります。
* 外部からアクセス可能な公開URLである必要があります。
* 最大ファイルサイズ：4GB

正しいURLの例

```
https://example.com/feed/products.tsv
https://cdn.example.com/gmc/feed.xml
```

誤ったURLの例

```
www.example.com/feed.tsv       ← http:// または https:// が欠落している
/products/feed.tsv             ← 相対パスは使用不可
```

#### **スケジュール設定**

連携スケジュール：毎日決まった時間に1回、フィードファイルを自動収集します。

* 当日予定の収集がまだ完了していない場合 → 当日から反映
* 当日予定の収集がすでに完了している場合 → 翌日0時以降から反映

{% hint style="info" %}
連携リクエストが集中する時間帯は、収集完了までに時間がかかる場合があります。\
安定した収集のため、深夜時間帯の設定を推奨します。
{% endhint %}

#### 即時連携&#x20;

スケジュールとは別に、即時収集を実行することができます。

* 提供回数：月3回
* リセット周期：毎月1日に自動リセット
* 実行方法：【連携商品管理 > GMC Feed > 即時連携】ボタンをクリック

#### Step 2. 保存および有効化

【保存】ボタンをクリックするとURLの有効性チェックが実行され、問題がなければ連携が有効化されます。

* 右上のトグルをON状態に維持することで、スケジュール連携が正常に動作します。
* 設定完了後、画面から次回の連携予定時刻を確認できます。

<figure><img src="/files/p3TY9QBaJejtMz7doiay" alt=""><figcaption></figcaption></figure>

### **2. Merchant API連携方法**

GMC Merchant APIの仕様に基づいたリクエストbodyを、そのまま専用エンドポイントへ送信してください。別途データ変換を行うことなく、GMC API標準の方式をそのままご利用いただけます。

{% hint style="info" %}
GMC Merchant APIの仕様については、[Google公式ドキ](https://developers.google.com/merchant/api/reference/rest/products_v1/accounts.productInputs?_gl=1*1vgo8gg*_up*MQ..*_ga*MTE4OTkwOTY4NC4xNzcyNzEyNzM0*_ga_SM8HXJ53K2*czE3NzI3MTI3MzQkbzEkZzAkdDE3NzI3MTI3MzQkajYwJGwwJGgw#ProductInput)ュメントをご参照ください。
{% endhint %}

**GMC APIエンドポイント**

* リクエスト先：[https://gateway.gelatto.jp](https://gateway.gelatto.ai)

<table><thead><tr><th width="234.796875">Endpoint</th><th width="114.9921875">Method</th><th width="175.58984375">Header</th><th></th></tr></thead><tbody><tr><td>/collector/google/products</td><td>POST</td><td>Api-Key：発行済みのAPI KEY</td><td>Merchant APIのbodyと同一</td></tr><tr><td>/collector/google/products/{productInputsName}</td><td>PATCH</td><td>Api-Key：発行済みのAPI KEY</td><td>Merchant APIのbodyと同一</td></tr><tr><td>/collector/google/products/{productInputsName}</td><td>DELETE</td><td>Api-Key：発行済みのAPI KEY</td><td></td></tr></tbody></table>

***

## FAQ

**Q. ファイルフィード連携の際、事前に必要な設定はありますか？**

Googleショッピングの仕様に準拠したTSVまたはXMLのフィードファイルを準備します。準備したフィードファイルを自社サーバーにアップロードし、外部からアクセス可能なURLを確認します。

* Google Merchant Centerのフィード仕様に準拠する必要があり、ファイルサイズは最大4GBです。
* ファイルは弊社サーバーからHTTP GETリクエストでアクセス可能である必要があります。

**Q. フィードファイルが更新されるたびにURLを再登録する必要がありますか？**

いいえ。URLは一度登録するだけで構いません。以降は同じURLパスにファイルを上書きアップロードすることで、スケジュールに従って最新ファイルが自動的に収集されます。

**Q. スケジュール連携の時刻を変更した場合、いつから反映されますか？**

当日予定の収集がまだ完了していない場合は当日から反映され、すでに完了している場合は翌日から適用されます。

**Q. API連携方式はどのように進めればよいですか？**

GMC Merchant APIの仕様のまま、弊社の専用エンドポイントへリクエストしてください。GMC公式ドキュメントをご参照ください。


---

# Agent Instructions: 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:

```
GET https://docs.genser.ai/more-info/gmcgoogle-merchant-centergaido.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.