Merchant Center アカウントを準備する

Merchant Center アカウントが有効で、アカウントに無料リスティング用の承認済み商品がある必要があります。ご利用にあたっては、以下のヘルプセンター記事をご覧ください。

Merchant Center で商品を登録したら、API 統合を構築する前に、このセクションの要件を満たす必要があります。

1. Merchant Center の設定

Google Merchant Center アカウントで次の設定が構成されていることを確認します。

1.1. 返品に関するポリシー

返品に関するポリシーは、Merchant Center で定義する必要があります。これは、Merchant of Record の要件であり、購入手続き画面で参照されます。設定したポリシーはアカウント全体に適用されますが、return_policy_label フィード属性を使用して、特定の商品グループに返品ポリシーを制限することもできます。

Merchant Center アカウントがアドバンスアカウントの場合、返品に関するポリシーは個々のサブアカウントごとに設定する必要があります。

返品費用、返品の所要日数（期間）、ポリシー全文へのリンクを含める必要があります。返品の設定について詳しくは、こちらをご覧ください。

1.2. カスタマーサポート情報

Merchant Center でカスタマーサポート情報を設定する必要があります。注文確認ページの [販売者に連絡] リンクの生成に使用されます。詳しくは、こちらでカスタマーサポート情報を設定する方法をご覧ください。

2. 商品データ

対象であることを示すには、商品フィードを更新して、準拠データを提供する必要があります。この情報は、Google を使用した UCP での購入手続きを有効にするために必要です。この情報により、エージェントは商品の対象資格を判断し、正確な合計費用を計算し、ユーザーに法的警告を必ず表示できます。

2.1. エージェント機能による購入手続きの利用要件

これにより、Google での購入手続きに商品がオプトインされます。

これは、単一のブール値を含む商品属性 native_commerce を使用して提供されます。false に設定されているか、値が指定されていない場合、商品は購入手続きの対象になりません。

2.2. 商品の警告

これは、規制上の警告要件がある商品（カリフォルニア州プロポジション 65）。お客様は、製品の警告要件を含む、適用されるすべての法律を遵守する責任を負います。これらの警告は、入力すると購入手続き画面に大きく表示されます。

consumer_notice 属性グループに次の 2 つのサブ属性を指定します。

consumer_notice_type: legal_disclaimer、safety_warning、prop_65 のいずれかにする必要があります。
consumer_notice_message: 文字列（最大 1,000 文字）。HTML タグ <b>、<br>、<i> は使用できます。

2.3. 商品 ID

商品フィードの id は、Checkout API で想定される商品 ID と一致している必要があります。一致している場合は、対応は不要です。それ以外の場合は、merchant_item_id カスタム属性を使用してマッピングします。

2.4. 商品に属性を追加する方法

次の例では、Merchant Center に商品を登録するさまざまな方法について説明します。

2.4.1. フィード

補助データソースを作成することをおすすめします（手順はこちら）。この属性をメインフィードに追加することは可能ですが、形式が正しくないと通常の商品登録に影響する可能性があるため、注意して進めてください。

構文に関する注: 複雑な文字列（カリフォルニア州法プロポジション 65 のメッセージなど）に、ファイル形式を壊す文字（CSV の余分なカンマなど）が含まれていないことを確認してください。ただし、適切にエスケープされている場合は除きます。

テキストファイル形式:

ID	native_commerce	consumer_notice
11111	TRUE	`prop_65:This product can expose you...`
22222	TRUE
33333	FALSE

XML 形式:

<item>
  <g:id>11111</g:id>
  <g:native_commerce>TRUE</g:native_commerce>
  <g:consumer_notice>
    <g:consumer_notice_type>prop_65</g:consumer_notice_type>
    <g:consumer_notice_message>
      This product can expose you to chemicals...
    </g:consumer_notice_message>
  </g:consumer_notice>
</item>
<item>
  <g:id>22222</g:id>
  <g:native_commerce>TRUE</g:native_commerce>
</item>
<item>
  <g:id>33333</g:id>
  <g:native_commerce>FALSE</g:native_commerce>
</item>

2.4.2. Content API

属性をカスタム属性として指定します。products.update では customAttributes の更新がサポートされていないため、完全な商品を含む products.insert に含める必要があります。

例:

"customAttributes": [
  {
    "name": "native commerce",
    "groupValues": [
      {
        "name": "checkout eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "consumer notice",
    "groupValues": [
      {
        "name": "notice type",
        "value": "prop_65"
      },
      {
        "name": "notice message",
        "value": "This product can expose you to chemicals..."
      }
    ]
  },
  {
    "name": "merchant item id",
    "value": "some_checkout_item_id_1"
  }
]

2.4.2. Merchant API

属性をカスタム属性として指定します。既存の accounts.productInputs.insert に追加するか、accounts.productInputs.patch を使用して直接更新できます。

挿入の例:

"customAttributes": [
  {
    "name": "native commerce",
    "groupValues": [
      {
        "name": "checkout eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "consumer notice",
    "groupValues": [
      {
        "name": "notice type",
        "value": "prop_65"
      },
      {
        "name": "notice message",
        "value": "This product can expose you to chemicals..."
      }
    ]
  },
  {
    "name": "merchant item id",
    "value": "some_checkout_item_id_1"
  }
]

update の例:

タイプ	名前	値
パスパラメータ	`productInput.name`	`accounts/{account}/productInputs/en~US~11111`
クエリパラメータ	`updateMask`	`customAttributes.native%20commerce,customAttributes.consumer%20notice,customAttributes.product%20fee,customAttributes.merchant%20item%20id`
	`dataSource`	`dataSources/{datasource}`

{
  "offerId": "11111",
  "contentLanguage": "en",
  "feedLabel": "US",
    "customAttributes": [
    {
      "name": "native commerce",
      "groupValues": [
        {
          "name": "checkout eligibility",
          "value": "true"
        }
      ]
    },
    {
      "name": "consumer notice",
      "groupValues": [
        {
          "name": "notice type",
          "value": "prop_65"
        },
        {
          "name": "notice message",
          "value": "This product can expose you to chemicals..."
        }
      ]
    },
    {
      "name": "product fee",
      "groupValues": [
        {
          "name": "product fee type",
          "value": "US_AZ_TIRE_FEE"
        },
        {
          "name": "product fee amount",
          "value": "2.75 USD"
        }
      ]
    },
    {
      "name": "merchant item id",
      "value": "some_checkout_item_id_1"
    }
  ]
}

3. プロダクトの制限

次のカテゴリの商品は購入手続きの対象外です。これらのアイテムの native_commerce が空であるか、false に設定されていることを確認します。

金融商品と定期購入モデル

定期購入: 定期的な請求サイクルが必要なアイテム。
分割払い: 販売者が義務付ける支払いプランまたは融資を必要とする取引。

カスタムメイドの商品と配送オプション

パーソナライズされた商品: カスタムデザインの決定が必要な商品（彫刻、モノグラムなど）。
新品以外の商品または最終セール商品: 再生品、中古品、「最終セール」（返品不可）と記載されている商品。
予約購入アイテム: 発売日が指定済みで、配送が延期されている商品。
バンドルされたサービス: 保証、設置、セットアップなど、追加の契約が必要なアイテム。
特別配送: 標準以外の配送料（貨物、プレミアム配送など）が必要な商品アイテム。
ギフト: 請求書の分割や受取人向けの価格の非表示が必要な取引。
実店舗での有効化: 実店舗で物理的に有効化する必要がある商品。

ポリシーと安全に関する制限

年齢制限あり: 身分証明書の確認が必要な商品（例: アルコール、タバコ）。
禁止されているコンテンツ: 武器、アダルトコンテンツ、医療/医薬品、偽造品、または標準の Google ショッピングポリシーでブロックされているその他のカテゴリ。

デジタル商品とサービス

サービス: レッスン、オンラインクラス、旅行パッケージ（特定の旅行レールを使用して統合されている場合を除く）。
レンタル: 映画のレンタル、機器のレンタル、リース。
仮想アイテム: ゲーム内通貨、MMORPG の商品、スキン。
ソフトウェアの依存関係: 購入を完了する前にユーザーが特定のソフトウェアをインストールする必要がある商品。