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 bài viết Bật tính năng cải tiế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 của Merchant API, hãy làm như sau:

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

Etag

Etag là một mã thông báo được mã hoá để tránh các bản cập nhật không đồng bộ. Etag thay đổi khi bất kỳ dữ liệu nào trong 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 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ông báo etag mới nhất. Bạn cần gọi yêu cầu GET để truy xuất mã thông báo 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 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 thành 7 cho một Dịch vụ vận chuyển có tên là GSA Shipping – Free Ship Over $49.99 (Dịch vụ vận chuyển của GSA – Miễn phí vận chuyển trên 49, 99 USD) trong 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"
        }
      ]
    }
  ]
}

Đặt kho

Mẫu JSON sau đây cho biết cách bạn có thể sử dụng dịch vụ cài đặt 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:

"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ế nội dung sau:

{street_address}: Phần địa chỉ ở cấp đường của kho.
{city}: Thành phố, thị trấn hoặc xã nơi kho hàng tọa lạc.
{administrative_area}: Tiểu bang 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 ở dạng chuỗi.
{minutes}: Số phút trong thời gian cắt máng cho đến khi kho xử lý đơn đặt hàng trong cùng ngày.
{handling_days}: Số ngày cần thiết để kho này đóng gói và vận chuyển một mặt hàng.

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

Quản lý kho

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

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

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

Dưới đây là nội dung yêu cầu INSERT mẫu có kho hàng cho Kho hàng 1 được cập nhật từ New York thành 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 để thiết lập dịch vụ vận chuyển 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ó local_delivery làm shipment_type. Hiện tại, tất cả dịch vụ vận chuyển 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 các đơn hàng 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 trong 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ử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 được đặt sau hạn chót nhận đơn đặt hàng để giao hàng cùng ngày sẽ được lên lịch giao hàng vào ngày tiếp theo. Để tắt dịch vụ giao hàng 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 sẽ chỉ xuất hiện trước thời điểm chót mỗi ngày.

Dịch vụ giao hàng vào ngày tiếp theo chỉ có khi shipment_type là local_delivery.

Tìm hiểu thêm

Để tìm hiểu về cách di chuyển từ Content API for Shopping, hãy xem bài viết Di chuyển tính năng quản lý chế độ cài đặt thông tin vận chuyển.