Trang này được dịch bởi Cloud Translation API.

Tổng quan về chế độ cài đặt thông tin vận chuyển

Tài nguyên shippingsettings cho phép bạn truy xuất và cập nhật chế độ cài đặt thông tin vận chuyển của tài khoản.

Google có thể tự động cập nhật thời gian giao hàng dự kiến cho một số sản phẩm. Để biết thêm thông tin, hãy xem phần Bật tính năng cải thiện tự động.

Đọc, ghi hoặc cập nhật chế độ cài đặt thông tin vận chuyển

Để sử dụng dịch vụ vận chuyển API của Merchant Center, hãy làm như sau:

Hãy gửi yêu cầu GET để truy xuất toàn bộ chế độ cài đặt thông tin vận chuyển của tài khoản.
Sửa đổi chế độ cài đặt thông tin vận chuyển.
Tạo yêu cầu INSERT với chế độ cài đặt thông tin vận chuyển đã sửa đổi.

Thẻ Etag

Etag là một mã thông báo được mã hoá để tránh cập nhật không đồng bộ. Thẻ này thay đổi khi bất kỳ dữ liệu nào về chế độ cài đặt thông tin vận chuyển thay đổi. Người dùng cần sao chép etag mà họ nhận được từ yêu cầu GET vào nội dung yêu cầu INSERT.

Nếu dữ liệu về chế độ cài đặt thông tin vận chuyển thay đổi giữa yêu cầu GET và yêu cầu INSERT, bạn sẽ nhận được thông báo lỗi yêu cầu một yêu cầu GET khác truy xuất mã thẻ etag mới nhất. Bạn cần gọi yêu cầu GET để truy xuất mã thẻ etag mới và sao chép mã thông báo etag mới vào nội dung yêu cầu INSERT.

Thêm chế độ cài đặt thông tin vận chuyển

Sử dụng shippingsettings.insert để thêm hoặc cập nhật các chế độ cài đặt thông tin vận chuyển cho tài khoản của bạn. Dưới đây là một yêu cầu mẫu cập nhật maxTransitDays lên 7 cho một Dịch vụ vận chuyển có tên là RSS Shipping – Free Ship trên $49.99, thuộc tài khoản 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"
        }
      ]
    }
  ]
}

Thiết lập kho hàng

Mẫu JSON sau đây cho biết cách bạn có thể sử dụng dịch vụ cài đặt Thông tin vận chuyển của người bán để quản lý thông tin kho hàng cho tài khoản người bán của mình:

"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"
      ]
    }
  }
]

Thay thế các đoạn mã sau:

{street_address}: Phần cấp đường phố trong địa chỉ nhà kho.
{city}: Thành phố, thị trấn hoặc xã nơi đặt nhà kho.
{administrative_area}: Đơn vị hành chính của quốc gia. Ví dụ: tiểu bang.
{postal_code}: Mã bưu chính hoặc mã ZIP.
{region_code}: Mã quốc gia trong chuỗi.
{minutes}: Tính bằng phút trong thời hạn đặt hàng cho đến khi kho hàng phải đặt hàng để kho hàng xử lý trong cùng ngày.
{handling_days}: Số ngày cần thiết để kho hàng này đóng gói và vận chuyển một mặt hàng.

Tài nguyên warehouses là một danh sách các kho hàng. Bạn có thể tham chiếu mỗi kho hàng theo thời gian giao hàng dựa trên kho hàng của dịch vụ vận chuyển thông qua warehouse.name.

Quản lý kho hàng của bạn

Sau đây là cách sử dụng Merchant API để quản lý kho hàng:

Tạo yêu cầu GET để truy xuất tất cả shippingsettings và kho hàng hiện có.
Sao chép shippingsettings từ yêu cầu GET vào yêu cầu UPDATE.

Lưu ý: Nếu bạn không sao chép tất cả shippingsettings hiện có, thì chúng sẽ bị xoá khỏi tài khoản của bạn trong yêu cầu INSERT.
Điền vào các kho hàng nếu bạn muốn sử dụng các kho đó trong phần warehouses cho yêu cầu INSERT.
Tạo một yêu cầu UPDATE chứa tài nguyên shippingsettings và warehouses.

Dưới đây là nội dung yêu cầu INSERT mẫu kèm theo kho hàng cho Warehouse 1 được cập nhật từ New York lên Mountain View:

{
  "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"
        }
      ]
    }
  ]
}

Thêm dịch vụ giao hàng cùng ngày

Bạn có thể sử dụng Content API for Shopping để định cấu hình dịch vụ giao hàng cùng ngày nếu có kho hàng tại địa phương. Dịch vụ vận chuyển giao hàng cùng ngày có shipment_type là local_delivery. Hiện tại, tất cả các dịch vụ vận chuyển của local_delivery đều được xem là giao hàng cùng ngày.

Bạn không thể thay đổi thông tin delivery_time cho dịch vụ giao hàng tại địa phương. Sử dụng shippingsettings.insert để thiết lập dịch vụ giao hàng cùng ngày cho các sản phẩm kho hàng tại địa phương.

Dưới đây là nội dung yêu cầu mẫu thêm dịch vụ giao hàng cùng ngày vào tất cả các cửa hàng cho tài khoản của bạn:

{
  "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"
        }
      }
    }
  ]
}

Thêm dịch vụ giao hàng vào ngày tiếp theo

Theo mặc định, các đơn đặt hàng sau hạn chót nhận đơn hàng để giao hàng trong cùng ngày sẽ được lên lịch giao hàng vào ngày tiếp theo. Để tắt tính năng phân phối vào ngày tiếp theo, hãy đặt trường no_delivery_post_cutoff thành true. Nếu bạn tắt dịch vụ giao hàng vào ngày tiếp theo, thì các dịch vụ vận chuyển của bạn chỉ xuất hiện trước hạn chót nhận đơn hàng mỗi ngày.

Chỉ có thể giao hàng vào ngày tiếp theo khi shipment_type là local_delivery.