feedLabel フィールドを使用して、商品とデータフィードにラベルを追加できます。
フィードラベルの形式は次のとおりです。
- 文字列型
- 20 文字以下
- 大文字（A ～ Z）
- 数字（0 ～ 9）
- ダッシュ（-）
feedLabel は次のリソースで入手できます。
REST ID
新しいプロダクトの REST ID にある targetCountry が feedLabel に置き換えられます。
新しいプロダクトの REST ID は、online:language:targetCountry:offerId ではなく 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 を使用して国を追加できます。
詳しくは、複数の国での広告のターゲット設定をご覧ください。
データフィード
datafeed が明示的にターゲットにしている国を targets で確認できるようになりました。これは、datafeedtarget 構成で country ではなく feedLabel を使用する場合に適用されます。
また、datafeeds に targetCountries フィールドが追加され、datafeeds のターゲティングを直接設定できるようになりました。商品リソースの shipping 属性を設定するなどして、フィードの外部でターゲティングを設定することもできます。
UK から GB への変換
targetCountry フィールドは有効な国コードではありませんが、現在、UK 値は許可されます。UK は自動的に GB に変換されます。UK が targetCountry のプロダクトは、REST ID と offerId に GB とともに保存されます。
UK を feedLabel の値として設定しても、GB に自動的に変換されることはありません。UK と GB は feedLabel の異なる文字列であり、異なるオファーを作成します。
UK の targetCountry を挿入し、GB に変換する場合、get メソッドで商品を取得するには、商品の REST ID を更新して、UK ではなく GB を含める必要があります。