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