此页面由 Cloud Translation API 翻译。

配送设置概览

通过 ShippingSettings 资源，您可以检索和更新账号的运费设置。

Google 可以自动更新某些商品的预计送货时间。有关详情，请参阅启用自动改进。

读取、写入或更新配送设置

如需使用 Merchant API 配送服务，请执行以下操作：

请发出 GET 请求以检索您的。
修改运费设置。
使用修改后的运费设置发出 INSERT 请求。

ETag

Etag 是一个编码令牌，以避免异步更新。etag 会在运费设置数据的任何更改用户需要复制从 GET 请求的 INSERT 请求正文获取。

如果运费设置数据在 GET 请求和 INSERT 之间发生变化请求，则会收到一条错误消息，请求再次 GET 请求检索最新的 etag 令牌。您需要调用 GET 请求以检索新的 etag 令牌，并将新的 etag 令牌复制到 INSERT 请求正文。

添加配送设置

使用shippingsettings.insert为您的。下面是一个示例请求，该请求会将maxTransitDays 账号下的名为 GSA 配送 - 满 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 管理仓库的方法如下：

发出 GET 请求以检索所有现有 shippingsettings 和模型。
将 GET 请求中的 shippingsettings 复制到 UPDATE 请求中。

注意：如果您未复制所有现有 shippingsettings，它们会被删除在 INSERT 请求中使用您的账号。
如果您想在 warehouses 部分使用仓库，请填充这些仓库用于 INSERT 请求。
发出包含 shippingsettings 和 warehouses 的 UPDATE 请求资源。

以下是更新了 Warehouse 1 的仓库的 INSERT 请求正文示例从纽约到山景城：

{
  "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 迁移，请参阅迁移配送信息设置管理。