Đặt thời gian giao hàng

Thời gian giao hàng của sản phẩm là thời gian ước tính để một đơn đặt hàng được giao sau khi đặt. Đối tác cung cấp tín hiệu vận chuyển có thể sử dụng tính năng này để đặt thời gian giao hàng cho các khu vực cụ thể thay mặt cho những người bán mà họ hợp tác.

Các đối tác cung cấp tín hiệu vận chuyển có thể sử dụng tài nguyên này để đặt thời gian giao hàng cho các cặp sản phẩm-khu vực, cũng như xem hoặc xoá thời gian giao hàng hiện có thay cho những người bán mà họ liên kết. Một tài nguyên ProductDeliveryTime lưu trữ nhiều thời gian giao hàng và chỉ có thể có một thực thể ProductDeliveryTime cho mỗi mặt hàng.

Để sử dụng tài nguyên ProductDeliveryTime, hãy xác thực dưới dạng tài khoản Merchant Center của riêng bạn, chứ không phải tài khoản người bán mà bạn đang cập nhật.

create

Các đối tác về tín hiệu vận chuyển có thể tạo hoặc cập nhật thời gian giao hàng của sản phẩm bằng cách gọi create bằng merchantId của tài khoản người bán để cập nhật và một phiên bản ProductDeliveryTime. Để cập nhật thời gian giao hàng của một sản phẩm hiện có, hãy đảm bảo rằng bạn cung cấp tất cả các trường ProductDeliveryTime, kể cả những trường không thay đổi. Mỗi yêu cầu create sẽ ghi đè thực thể trước đó, vì vậy, các trường mà bạn không đưa vào sẽ bị mất. Phương thức này trả về thực thể ProductDeliveryTime có thông tin mới nhất mà bạn gửi.

Mỗi ProductDeliveryTime có thể có tối đa 100 mục areaDeliveryTimes.

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime

Sau đây là một nội dung yêu cầu mẫu:

{
  "productId": {
    "productId": "online:en:US:offer-id"
  }
  "areaDeliveryTimes": [
    {
      "deliveryArea": {
        "countryCode": "US"
        "postalCodeRange": {
          "firstPostalCode": "123*"
          "lastPostalCode": "456*"
        }
      }
      "deliveryTime": {
        "minHandlingTimeDays": "0"
        "maxHandlingTimeDays": "1"
        "minTransitTimeDays": "2"
        "maxTransitTimeDays": "4"
      }
    },
    {
      "deliveryArea": {
        "countryCode": "US"
        "administrativeAreaCode": "NY"
      }
      "deliveryTime": {
        "minHandlingTimeDays": "0"
        "maxHandlingTimeDays": "1"
        "minTransitTimeDays": "5"
        "maxTransitTimeDays": "7"
      }
    }
  ]
}

get

Lấy thời gian giao hàng của một sản phẩm bằng cách gọi get với merchantId và productId của người bán. Phương thức này trả về thực thể ProductDeliveryTime cho productId đã cho.

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId

xóa

Các đối tác cung cấp tín hiệu vận chuyển có thể xoá thời gian giao hàng của một sản phẩm bằng cách gọi delete cùng với merchantId và productId của người bán. Phương thức này trả về một phản hồi trống.

DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId