Chiến lược phát hành đĩa đơ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 trong tài khoản của mình.
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 chế độ 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 qua API Merchant, hãy làm như sau:
- Gửi 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.
- Đưa ra yêu cầu
INSERTvới chế độ cài đặt thông tin vận chuyển đã sửa đổi.
Thẻ etag
Etag là mã thông báo được mã hoá để tránh cập nhật không đồng bộ. Thẻ etag sẽ thay đổi khi
bất kỳ thay đổi nào về dữ liệu trong chế độ cài đặt thông tin vận chuyển. Người dùng cần sao chép thẻ etag mà họ muốn
được lấy từ yêu cầu GET gửi đến 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à INSERT
bạn nhận được một thông báo lỗi khi nhắc gửi một yêu cầu GET khác để
truy xuất mã thông báo etag gần đây nhất. Bạn cần gọi yêu cầu GET tới
truy xuất mã thông báo thẻ etag mới rồi sao chép mã thông báo etag mới vào yêu cầu INSERT
nội dung.
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. Dưới đây là 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 Vận chuyển GPay – Giao hàng miễn phí trên 49,99 đô la Mỹ, theo 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 nhà kho
Mẫu JSON sau đây hướng dẫn cách sử dụng chế độ cài đặt Thông tin vận chuyển của người bán dịch vụ quản lý thông tin kho hàng cho tài khoản người bán của 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ế đoạn mã sau:
- {street_address}: Phần đường phố trong địa chỉ của kho hàng.
- {city}: Thành phố, thị trấn hoặc xã nơi đặt kho hàng.
- {administrative_area}: Phân khu 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}: Số phút của hạn chót nhận đơn hàng cho đến khi kho hàng phải đặt hàng để kho hàng xử lý đơn đặt hàng trong cùng ngày.
- {handling_days}: Số ngày cần thiết để thực hiện việc này kho để đóng gói và vận chuyển hàng.
Tài nguyên warehouses là một danh sách các nhà kho. Mỗi kho hàng có thể
được giới thiệu theo thời gian giao hàng theo kho hàng của dịch vụ vận chuyển thông qua
warehouse.name.
Quản lý kho hàng
Sau đây là cách sử dụng API Merchant để quản lý các kho hàng của bạn:
- Đưa ra yêu cầu
GETđể truy xuất tất cảshippingsettingshiện có và nhà kho. Sao chép
shippingsettingstừ yêu cầuGETvào yêu cầuUPDATE.Điền các kho dữ liệu nếu bạn muốn sử dụng chúng trong phần
warehousescho yêu cầuINSERT.Tạo một yêu cầu
UPDATEchứashippingsettingsvàwarehousescủa chúng tôi.
Dưới đây là nội dung yêu cầu INSERT mẫu, trong đó có kho hàng cho Kho lưu trữ 1, được cập nhật
từ New York đế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 để thiết lập dịch vụ giao hàng cùng ngày
các dịch vụ khác nếu bạn có kho hàng tại địa phương. Dịch vụ giao hàng cùng ngày có
local_delivery làm shipment_type của trẻ. Tất cả phí vận chuyển của local_delivery
các dịch vụ này được coi là đơn đặt hàng trong cùng ngày tại thời điểm nà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 kho hàng tại địa phương
của Google dành cho doanh nghiệp.
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 cho 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
Những đơ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 vào lần tiếp theo
giao hàng trong ngày theo mặc định. Để tắt tính năng giao hàng vào ngày tiếp theo, hãy đặt
Trường no_delivery_post_cutoff thành true. Nếu tắt tính năng giao hàng vào ngày tiếp theo,
dịch vụ vận chuyển chỉ hiển thị trước hạn chót nhận đơn hàng 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 cho Mua sắm, hãy xem phần Di chuyển thông tin vận chuyển quản lý chế độ cài đặt.