運送設定總覽

ShippingSettings敬上 資源可讓您擷取及更新帳戶的運送設定。

Google 可以自動更新部分產品的預估送達時間。 詳情請參閱啟用自動 加以改善

讀取、寫入或更新運送設定

如要使用 Merchant API 運送服務,請按照下列步驟操作:

  1. 提出 GET 要求,擷取完整的運送設定 讓他們使用服務帳戶
  2. 修改運送設定。
  3. 使用修改後的運送設定提出 INSERT 要求。

ETag

Etag 為編碼符記,以避免非同步更新。ETag 會在 任何運送設定資料的變更。使用者必須複製 ETag 從 GET 要求取得 INSERT 要求主體。

如果 GET 要求和 INSERT 之間的運送設定資料有所變更 要求,您收到一則錯誤訊息,要求再次提出 GET 要求 擷取最新的 Etag 權杖您必須呼叫 GET 要求,才能: 擷取新的 etag 權杖,並將新的 etag 權杖複製到 INSERT 要求

新增運送設定

使用 shippingsettings.insert 新增或更新 讓他們使用服務帳戶以下要求範例將 maxTransitDays 更新為 7, 名為「GSA Shipping - 免運費」運費,金額超過 $49.99 美元 10.

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings/

{
  "services": [
    {
      "name": "FedEx",
      "active": true,
      "deliveryCountries": ["US"],
      "currencyCode": "USD",
      "deliveryTime": {
        "minTransitDays": 4,
        "maxTransitDays": 6,
        "minHandlingDays": 0,
        "maxHandlingDays": 0
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 5990000,
              "currencyCode": "USD"
            }
          },
          "name": "All products"
        }
      ]
    },
    {
      "name": "GSA Shipping - Free Ship Over $49.99",
      "active": true,
      "deliveryCountries": "US",
      "currencyCode": "USD",
      "deliveryTime": {
        "minTransitDays": 3,
        "maxTransitDays": 7,
        "minHandlingDays": 1,
        "maxHandlingDays": 2
      },
      "rateGroups": [
        {
          "mainTable": {
            "rowHeaders": {
              "prices": [
                {
                  "amountMicros": 49990000,
                  "currencyCode": "USD"
                },
                {
                  "amountMicros": -1,
                  "currencyCode": "USD"
                }
              ]
            },
            "rows": [
              {
                "cells": [
                  {
                    "flatRate": {
                      "amountMicros": 6990000,
                      "currencyCode": "USD"
                    }
                  }
                ]
              },
              {
                "cells": [
                  {
                    "flatRate": {
                      "amountMicros": 0,
                      "currencyCode": "USD"
                    }
                  }
                ]
              }
            ]
          },
          "name": "Free Ship Over $49.99"
        }
      ]
    }
  ]
}

組合倉庫

以下 JSON 範例說明如何使用「商家運送」設定 服務來管理商家帳戶的倉儲資訊:

"warehouses": [
  {
    "name": "warehouse 1",
    "shippingAddress": {
      "streetAddress": {street_address},
      "city": {city},
      "administrativeArea": {administrative_area},
      "postalCode": {postal_code},
      "regionCode": {region_code}
    },
    "cutoffTime": {
      "minutes": {minutes}
    },
    "handlingDays": {handling_days},
    "businessDaysConfig": {
      "businessDays": [
        "MONDAY", "SUNDAY"
      ]
    }
  }
]

更改下列內容:

  • {street_address}:倉庫地址的街道層級部分。
  • {city}:倉庫所在的城市、鄉鎮或行政區。
  • {administrative_area}: 國家。例如,州/省行政區。
  • {postal_code}:郵遞區號或郵遞區號。
  • {region_code}:字串中的國家/地區代碼。
  • {minutes}:在截止時間中, 訂單必須提交於倉庫的同一天內處理。
  • {handling_days}:完成這項操作所需的天數 用於包裝及運送商品。

warehouses 資源是倉儲清單。每個倉儲可以 是經由運送服務的倉庫出貨時間所衍生的 warehouse.name

管理倉庫

以下說明如何使用 Merchant API 管理倉庫:

  1. 發出 GET 要求,擷取所有現有 shippingsettings 和 倉儲系統
  2. shippingsettingsGET 要求複製到 UPDATE 要求。

  3. 填入您想在 warehouses 區段中使用的倉庫 針對 INSERT 要求。

  4. 提出包含 shippingsettingswarehousesUPDATE 要求 再複習一下,機構節點 是所有 Google Cloud Platform 資源的根節點

以下是已更新倉庫的 INSERT 要求主體範例:Warehouse 1 從紐約到山景城:

{
  "services": [
    {
      "name": "Standard Shipping",
      "active": true,
      "deliveryCountries": ["US", "UK"],
      "currencyCode": "USD",
      "deliveryTime": {
        "minHandlingDays": 0,
        "maxHandlingDays": 1,
        "warehouseBasedDeliveryTimes": [
{"carrier": "Fedex"
 "carrierService": "ground"
 "warehouse": "Warehouse 1"
},
{"carrier": "Fedex"
 "carrierService": "2 days"
 "warehouse": "Warehouse 2"
}
]
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 0,
              "currencyCode": "USD"
            }
          },
          "name": "Standard Shipping"
        }
      ],
    },
    {
      "name": "Expedited",
            "flatRate": {
              "amountMicros": 9990000,
              "currencyCode": "USD"
            }
          },
          "name": "Expedited"
        }
      ],
    }
  ],
  "warehouses": [
    {
      "name": "Warehouse1",
      "shippingAddress": [
        {
        "streetAddress": "1111 shoreline street"
          "city": "Mountain View",
          "administrativeArea": "CA"
        }
      ]
    },
    {
      "name": "Warehouse 2",
      "country": "US",
      "postalCodeRanges": [
        {
        "streetAddress": "1111 5th avenue"
          "city": "New York",
          "administrativeArea": "NY"
        }
      ]
    }
  ]
}

新增當天到貨服務

你可以使用 Content API for Shopping 設定當天到貨服務 提供店面商品目錄資料當天到貨運送服務設有 local_delivery 做為shipment_type。所有運費:local_delivery 所有服務都會視為當天到貨。

你無法變更本地配送的delivery_time資訊。使用 如要為店面商品目錄設定當天到貨服務,請shippingsettings.insert 很少直接解答該如何打造產品

以下這個要求主體範例為所有商店新增當天到貨服務 帳戶:

{
  "name": "accounts/accountId/shippingSettings",
  "services": [
    {
      "name": "Local Delivery",
      "active": true,
      "shipmentType": "local_delivery",
      "deliveryCountries": "US",
      "currencyCode": "USD",
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 0,
              "currencyCode": "USD"
            }
          }
        }
      ],
      "storeConfig": {
        "storeServiceType": "all stores",
        "storeCodes": [],
        "cutoffConfig": {
          "storeCloseOffsetHours": 2,
          "noDeliveryPostCutoff": true
        },
        "serviceRadius": {
          "value": 4,
          "unit": "Miles"
        }
      }
    }
  ]
}

新增次日到貨服務

當天到貨截止時間後下單的訂單,已排定在下一次 日到貨。如要關閉次日到貨服務,請將 no_delivery_post_cutoff 欄位設為 true。如果關閉「次日到貨」服務,您的 運送服務必須在每日截止時間之前顯示。

只有在shipment_type的運送時間為 local_delivery

瞭解詳情

如要瞭解如何從 Content API for Shopping 遷移,請參閱遷移運送資訊 設定管理