feedLabel フィールドを使用して、商品とデータフィードにラベルを追加できます。
フィードラベルの形式は次のとおりです。
- 文字列型
- 20 文字以下
- 大文字（A ～ Z）
- 数字（0 ～ 9）
- ダッシュ（-）
feedLabel は、次のリソースで使用できます。
REST ID
feedLabel は、新しい商品の REST ID の targetCountry に置き換わります。
online:language:targetCountry:offerId の代わりに、新しい商品の REST ID は online:language:feedLabel:offerId として形成されるようになりました。既存の商品の REST ID は変更されません。
商品を取得して一覧表示する
feedLabel フィールドには、返品されたすべての商品について常に値が入力されます。
feedLabel が有効な CLDR 地域コードの場合、互換性のために targetCountry フィールドが自動的にバックフィルされます。feedLabel が有効な CLDR テリトリー コードでない場合、targetCountry は空のままになります。
同じ変更が productstatuses エンドポイントにも適用されます。
feedLabel が CLDR 地域コードではない特典の場合、国固有のフィールドは空になります。
プロダクトの挿入と更新
新しい商品を挿入するには、feedLabel または targetCountry のいずれかが必要です。feedLabel と targetCountry を使用して商品を挿入または更新する場合、これらの値は一致している必要があります。
両方のフィールドが空の場合、または値が一致しない場合、API からエラーが返されます。
詳しくは、フィードラベルを使って特定のフィードの商品を宣伝するをご覧ください。
国によるターゲットの設定
商品を適切な国でターゲットに設定するには、次のいずれかの方法を使用します。
productsリソースのshippingフィールドdatafeedsリソースのtargetCountriesフィールド
商品
products の targetCountry フィールドは非推奨になりました。代わりに、shipping フィールドを使用して対象国を指定します。
複数の国をターゲットに設定する場合は、引き続き shipping を使用して国を追加できます。
詳しくは、複数の国で広告をターゲットに設定するをご覧ください。
データフィード
targets で、datafeed が明示的にターゲットにしている国を確認できるようになりました。これは、datafeedtarget 構成で country の代わりに feedLabel を使用する場合に適用されます。
また、datafeeds に targetCountries フィールドを追加したため、datafeeds のターゲティングを直接設定できます。フィード外でターゲティングを設定することもできます（商品リソースの shipping 属性を設定するなど）。
UK から GB への変換
現在、targetCountry フィールドでは、有効な国コードではない UK 値も許可されています。UK は自動的に GB に変換されます。targetCountry が UK の商品は、REST ID と offerId に GB が含まれた状態で保存されます。
feedLabel の値として UK を設定しても、GB に自動的に変換されることはありません。UK と GB は feedLabel の異なる文字列であり、異なる特典が作成されます。
UK の targetCountry を挿入し、それが GB に変換された場合は、get メソッドで商品を取得するために、UK ではなく GB を含むように商品の REST ID を更新する必要があります。