カタログ・アップデートAPI

リクエストの凡例

注記: プロパティ名はすべて大文字小文字を区別します。

リクエスト例

[
  {
    "id": "123",
    "name": "Playstation 4",
    "categories": ["E495", "VG555"],
    "brand": "Sony",
    "price": 299.99,
    "recommendable": true,
    "image_url": "http://my.cdn.com/path/to/my/image/123.jpg",
    "link_url": "http://my.domain.com/path/to/my/product/detail/123.html",
    "start_date": 2016-02-28
  },
  {
    "id": "124",
    "name": "XBox One",
    "categories": ["E495", "VG555"],
    "brand": "Microsoft",
    "price": 249.99,
    "recommendable": true,
    "image_url": "http://my.cdn.com/path/to/my/image/124.jpg",
    "link_url": "http://my.domain.com/path/to/my/product/detail/124.html",
    "start_date": 2016-07-28,
    "included_games": ["Destiny", "Final Fantasy XV"]
  }
]

リクエスト例

[
  {
    "id": "123",
    "name": "Playstation 4",
    "categories": ["E495", "VG555"],
    "brand": "Sony",
    "price": 299.99,
    "recommendable": true,
    "image_url": "http://my.cdn.com/path/to/my/image/123.jpg",
    "link_url": "http://my.domain.com/path/to/my/product/detail/123.html",
    "start_date": 2016-02-28,
    "overrides": {
      "region": {
        "CA": {
          "properties": {
            "in_stock": true
          }
        },
        "WA": {
          "properties": {
            "in_stock": false
          }
        }
      }
    }
  },
  {
    "id": "124",
    "name": "XBox One",
    "categories": ["E495", "VG555"],
    "brand": "Microsoft",
    "price": 249.99,
    "recommendable": true,
    "image_url": "http://my.cdn.com/path/to/my/image/124.jpg",
    "link_url": "http://my.domain.com/path/to/my/product/detail/124.html",
    "start_date": 2016-07-28,
    "included_games": ["Destiny", "Final Fantasy XV"]
    "overrides": {
      "region": {
        "CA": {
          "properties": {
            "in_stock": true
          }
        },
        "WA": {
          "properties": {
            "in_stock": false
          }
        }
      }
    }
  }
]

リクエストの凡例

リクエスト例

[
  {
    "id": "123",
    "name": "Playstation 4",
    "categories": ["E495", "VG555"],
    "brand": "Sony",
    "price": 299.99,
    "recommendable": true,
    "image_url": "http://my.cdn.com/path/to/my/image/123.jpg",
    "link_url": "http://my.domain.com/path/to/my/product/detail/123.html",
    "start_date": 2016-02-28,
    "overrides": {
      "sku": {
        "123A": {
          "properties": {
            "color": "black"
          }
        },
        "123B": {
          "properties": {
            "color": "red
          }
        }
      }
    }
  },
  {
    "id": "124",
    "name": "XBox One",
    "categories": ["E495", "VG555"],
    "brand": "Microsoft",
    "price": 249.99,
    "recommendable": true,
    "image_url": "http://my.cdn.com/path/to/my/image/124.jpg",
    "link_url": "http://my.domain.com/path/to/my/product/detail/124.html",
    "start_date": 2016-07-28,
    "included_games": ["Destiny", "Final Fantasy XV"]
    "overrides": {
      "sku": {
        "124A": {
          "properties": {
            "size": "small",
            "color": "black"
          }
        },
        "124B": {
          "properties": {
            "size": "large",
            "color": ["black", "gold"]
          }
        }
      }
    }
  }
]

リクエストの凡例

SKUのサイズ・タイプ

買物客のサイズのプリファレンスを考慮するのであれば、様々なタイプのサイズを区別しなければなりません。ある買物客のサイズが、靴は24cm、ワンピースが9号、パンツは11号であるとします。ここでサイズ情報としてその数値だけをシステムに提供すると混乱が生じます。

例えば、この買物客がパンツを購入した場合、サイズが11号であるということだけを記録しても不十分です。これがパンツのサイズであるということを記録しないと、他のものを購入する際に適切なサイズをレコメンドできません。

サイズをshirt_size、hat_size、あるいはus_women_shoe_sizeなどのように固有の属性として送信すれば、何のサイズであるかが明確となり余計な作業が必要なくなります。

このような属性の使用が不可能な場合でも対応策があります。SizeTypeという属性を作成し、カタログ何サイズのタイプを区別します。SKUフィード内でこれらの属性を各商品と紐付け、買物客がサイズのプリファレンスを示すたびに、ログを取ることができます。 

リクエストの凡例

注記: プロパティ名はすべて大文字小文字を区別します。

リクエスト例

[
  {
    "id": "E495",
    "name": "Electronics",
  },
  {
    "id": "VG555",
    "parent_id": "E495",
    "name": "Video Games"
  }
]

リクエスト例

[
  {
    "id": "E495",
    "name": "Electronics",
    "link_url": "/Electronics.html",
    "image_url": "/Electronics.jpg",
    "overrides": {
      "language": {
        "en-US": {
          "properties": {
            "name": "Electronics",
            "link_url": "/en-US/Electronics.html",
            "image_url": "/en-US/Electronics.jpg"
          }
        },
        "fr-CA": {
          "properties": {
            "name": "Électronique",
            "link_url": "/fr-CA/Electronics.html",
            "image_url": "/fr-CA/Electronics.jpg"
          }
        }
      }
    }
  },
  {
    "id": "VG555",
    "parent_id": "E495",
    "name": "Video Games"
    "overrides": { ... }
  }
]

リクエストの凡例 

リクエストの凡例

注記: プロパティ名はすべて大文字小文字を区別します。

リクエスト例

{
  "myRegion1": {
    "name": "Name of region 1",
    "description": "Description of region 1",
    "currency_code": "USD",
    "language_tag": "en-US",
    "price_multiplier": 100,
    "price_prefix": "$",
    "price_suffix": ""
  },
  "myRegion2": {
    ...
  },
  ...
}

ヒント: 新規のブラウズ・ブースト・ルール作成画面を開いて、このリージョン情報が正しく追加されているかどうかを確認できます。作成画面のコンテキストでリージョンを選択しドロップダウン・メニューから該当するリージョンをクリックしてください。フィードが正しく読み込まれていれば追加したすべてのリージョンのタイトルが表示されます。

レスポンスの凡例

レスポンス例

[
  {
    "trackingId": "YOUR_TRACKING_ID",
    "submitted": "2016-02-28T16:41:41.090Z",
    "statusMessage": {
      "status": "FINISHED",
      "notes": "Additional notes to explain status."
    }
  }
]

レスポンスの凡例

レスポンス例

{
  "status": "FINISHED",
  "notes": "Additional notes to explain status."
}