商品のお届け日数を設定する

商品のお届け日数は、注文してから商品が配送されるまでの推定所要時間です。配送シグナル パートナーは、この機能を使用して、提携している販売者に代わって特定の地域へのお届け日数を設定できます。

配送シグナルのパートナーは、このリソースを使用して、商品情報と地域のペアのお届け日数を設定したり、リンクされている販売者に代わって既存のお届け日数を表示または削除したりできます。1 つの ProductDeliveryTime リソースに複数のお届け日数が格納されます。また、クーポンごとに使用できる ProductDeliveryTime インスタンスは 1 つだけです。

ProductDeliveryTime リソースを使用するには、更新する販売アカウントではなく、ご自身の Merchant Center アカウントとして認証します。

開発する

配送シグナルのパートナーは、更新する販売アカウントの merchantId と ProductDeliveryTime インスタンスを指定して create を呼び出すことで、商品のお届け日数を作成または更新できます。既存の商品のお届け日数を更新するには、変更されていないものを含め、すべての ProductDeliveryTime フィールドを指定してください。各 create リクエストは以前のインスタンスが上書きされるため、含めないフィールドは失われます。このメソッドは、送信された情報を更新して ProductDeliveryTime インスタンスを返します。

各 ProductDeliveryTime には最大 100 個の areaDeliveryTimes エントリを含めることができます。

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime

リクエストの本文の例を次に示します。

{
  "productId": {
    "productId": "online:en:US:offer-id"
  }
  "areaDeliveryTimes": [
    {
      "deliveryArea": {
        "countryCode": "US"
        "postalCodeRange": {
          "firstPostalCode": "123*"
          "lastPostalCode": "456*"
        }
      }
      "deliveryTime": {
        "minHandlingTimeDays": "0"
        "maxHandlingTimeDays": "1"
        "minTransitTimeDays": "2"
        "maxTransitTimeDays": "4"
      }
    },
    {
      "deliveryArea": {
        "countryCode": "US"
        "administrativeAreaCode": "NY"
      }
      "deliveryTime": {
        "minHandlingTimeDays": "0"
        "maxHandlingTimeDays": "1"
        "minTransitTimeDays": "5"
        "maxTransitTimeDays": "7"
      }
    }
  ]
}

get

販売者の merchantId と productId で get を呼び出して、商品のお届け日数を取得します。このメソッドは、指定された productId の ProductDeliveryTime インスタンスを返します。

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId

delete

配送シグナルのパートナーは、販売者の merchantId と productId で delete を呼び出すことで、商品のお届け日数を削除できます。このメソッドは空のレスポンスを返します。

DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId