2022年3月3日

サイクル外の変更。

マーケティングAPI

商品セット

カタログ検索フィルターに加えられた変更

2022年3月3日以降、カタログの商品セット作成に関する特定のフィルターの動作方法に変更が加えられました。それらの変更は、商品セット作成時、その中にどのアイテムが入れられるかという点に影響します。

タイムライン
90日後にフィールドと演算子の動作に変更が加えられます。2022年6月1日以降は、カタログ内に変更対象のフィルターを使用しているセットがある場合、セット内のアイテムが変わる可能性があります。つまり、そのセットを使う広告やショップで、これまでと違うアイテムが表示されることがあります。さらに、それらのフィルターを使うリクエストから返されるアイテムセットが異なるものになる可能性があります。

商品セットフィルターについて詳しくは、こちらをご覧ください。

変更のある演算子

演算子	変更
`contains` / `not_contains`	クエリで、単語の一部ではなく単語全体に一致しなければならなくなりました。例えば、`name: {"contains": "red car"}`では、「red car」や「red fast car」のように指定した2語が含まれている商品すべてが返されますが、「red carpet」は返されません。ハイフンでつながれた単語は、それぞれ別の単語と見なされます。例えば、`name: {"contains": "shirt"}`のクエリでは「shirt」と「T-shirt」のどちらも一致します。クエリの検索語句のすべての単語がフィールド中に含まれる必要がありますが、順序が同じである必要はありません。例えば、`name: {"contains": "jeans blue"}`のクエリでは、「blue cropped jeans」は一致しますが、「jeans」だけや「blue」だけでは一致しません。
`lt`	このフィルターオプションは、`custom_label`のフィールドには使用できなくなりました。
`lte`	このフィルターオプションは、`custom_label`のフィールドには使用できなくなりました
`gt`	このフィルターオプションは、`custom_label`のフィールドには使用できなくなりました
`gte`	このフィルターオプションは、`custom_label`のフィールドには使用できなくなりました
`starts_with`	今後、このフィルターオプションは、商品カテゴリフィールドでのみ使用できます。その他のフィールドでは`contains`フィルターを使ってください。

変更のあるフィールド

フィールド	説明
`custom_label_0`	商品アイテム、ホテル、目的地、自動車、不動産・住宅のカスタムラベルの値。値は文字列として処理されます。このフィールドに数値演算子(`gt`、`gte`、`lt`、`lte`)は使えません。その代わり、整数がサポートされている`custom_number_0 field`を使ってください。
`custom_label_1`	商品アイテム、ホテル、目的地、自動車、不動産・住宅のカスタムラベルの値。値は文字列として処理されます。このフィールドに数値演算子(`gt`、`gte`、`lt`、`lte`)は使えません。その代わり、整数がサポートされている`custom_number_1`フィールドを使ってください。
`custom_label_2`	商品アイテム、ホテル、目的地、自動車、不動産・住宅のカスタムラベルの値。値は文字列として処理されます。このフィールドに数値演算子(`gt`、`gte`、`lt`、`lte`)は使えません。その代わり、整数がサポートされている`custom_number_2`フィールドを使ってください。
`custom_label_3`	商品アイテム、ホテル、目的地、自動車、不動産・住宅のカスタムラベルの値。値は文字列として処理されます。このフィールドに数値演算子(`gt`、`gte`、`lt`、`lte`)は使えません。その代わり、整数がサポートされている`custom_number_3`フィールドを使ってください。
`custom_label_4`	商品アイテム、ホテル、目的地、自動車、不動産・住宅のカスタムラベルの値。値は文字列として処理されます。このフィールドに数値演算子(`gt`、`gte`、`lt`、`lte`)は使えません。その代わり、整数がサポートされている`custom_number_4`フィールドを使ってください。
`custom_number_0`	商品アイテム、ホテル、目的地、自動車、不動産・住宅のカスタム整数値。
`custom_number_1`	商品アイテム、ホテル、目的地、自動車、不動産・住宅のカスタム整数値。
`custom_number_2`	商品アイテム、ホテル、目的地、自動車、不動産・住宅のカスタム整数値。
`custom_number_3`	商品アイテム、ホテル、目的地、自動車、不動産・住宅のカスタム整数値。
`custom_number_4`	商品アイテム、ホテル、目的地、自動車、不動産・住宅のカスタム整数値。

オフセットページネーション

GET /{product-catalog-id}/products?filter=.....&offset=...&limit=...&bulk_pagination=falseエンドポイントでの結果数が2000以下に制限されるようになりました。

変更点

これまで、offset + limitのサイズに関して制限はありませんでした。本日以降は、bulk_pagination = falseの場合にoffset + limitは2000以下でなければなりません。例:

offset = 1000、limit = 1500では、offset + limit = 2500であるため、動作しません
offset = 100、limit = 1500では、offset + limit = 1600であるため、動作します

カタログでページネーションの制限がないようにするには、bulk_pagination = trueを使ってください。