Đặt thời gian giao hàng

Thời gian giao sản phẩm là thời gian ước tính về thời gian cần thiết để giao đơn đặt hàng sau khi đặt hàng. Đối tác tín hiệu vận chuyển có thể sử dụng tính năng này để thay mặt người bán đặt thời gian giao hàng cho các khu vực cụ thể.

Lưu ý quan trọng: Người bán không thể chỉnh sửa trực tiếp ProductDeliveryTime. Phương thức create và delete trả về lỗi nếu người yêu cầu là người bán, không phải là đối tác tín hiệu vận chuyển.

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

Để sử dụng tài nguyên ProductDeliveryTime, hãy xác thực bằng tài khoản Merchant Center của chính 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 liên quan đến tín hiệu vận chuyển có thể tạo hoặc cập nhật thời gian giao hàng bằng cách gọi create thông qua merchantId của tài khoản người bán để cập nhật và một thực thể ProductDeliveryTime. Để cập nhật thời gian giao hàng hiện tại, hãy nhớ cung cấp tất cả các trường ProductDeliveryTime, bao gồm cả các trường chưa thay đổi. Mỗi yêu cầu create sẽ ghi đè thực thể trước đó, vì vậy, các trường 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 cập nhật mà bạn gửi.

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

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

Dưới đây là 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

Xem thời gian giao hàng của một sản phẩm bằng cách gọi get thông qua merchantId của người bán và productId. 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

Đối tác liên quan đến tín hiệu vận chuyển có thể xoá thời gian giao hàng của sản phẩm bằng cách gọi delete thông qua merchantId của người bán và productId. Phương thức này trả về phản hồi trống.

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