ShippingSettings
ช่วยให้คุณดึงข้อมูลและอัปเดตการตั้งค่าการจัดส่งของบัญชีและ
บัญชีย่อยทั้งหมดที่เกี่ยวข้อง สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่คุณจะ
เพิ่มหรือจัดการการตั้งค่าการจัดส่งในบัญชี โปรดดูภาพรวมของการจัดส่ง
การตั้งค่า
หากต้องการใช้ Merchant API เพื่ออ่านข้อมูลการตั้งค่าการจัดส่ง ให้ใช้รายการต่อไปนี้ คำขอ:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings
แทนที่ {accountId} ด้วยตัวระบุที่ไม่ซ้ำกัน บัญชี Merchant Center
หากต้องการใช้ Merchant API เพื่ออ่านข้อมูลการตั้งค่าการจัดส่ง ให้ใช้รายการต่อไปนี้ คำขอ:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
สำหรับข้อมูลเพิ่มเติม โปรดดูเมธอด:
accounts.shippingSettings.insert
การเปรียบเทียบระหว่าง Content API for Shopping กับ Merchant API
ตัวอย่างการเปรียบเทียบ Content API for Shopping กับผู้ขายมีดังนี้ API การตั้งค่าการจัดส่ง
Content API | API ผู้ขาย | |
---|---|---|
URL | https://shoppingcontent.googleapis.com/content/v2.1/ {accountId}/shippingsettings:insert |
https://merchantapi.googleapis.com/accounts/v1beta/accounts/ {accountId}/shippingSettings:insert |
รหัสระบุ | {accountId}/shippingsettings/ {accountId} |
{name} |
รายการต่อไปนี้กล่าวถึงการอัปเดตสำคัญใน Merchant Shipping Settings API เมื่อเทียบกับ Content API for Shopping
- ผู้ใช้ Merchant API ต้องใส่
accounts/{accountId}/shippingSettings
ในช่วง {name} เพื่อให้มีลักษณะการทำงานเหมือนกัน - Merchant API ไม่รองรับการดำเนินการอ่านและเขียนในพื้นที่ที่กำหนดเอง เช่น เป็นกลุ่มสถานที่ตั้ง พื้นที่ที่กำหนดเอง เช่น กลุ่มสถานที่ตั้ง สามารถอ่านได้เท่านั้น หรือ เขียนโดยใช้ Region Service
- วิธีการตั้งค่า
WarehouseBasedDeliveryTime
Merchant API แตกต่างจาก Content API for Shopping หากคุณ กำลังใช้ Merchant API คุณต้องระบุข้อมูลคลังสินค้าภายใต้shippingsettings.warehouses
จากนั้นบริการจัดส่งแต่ละรายการจะอ้างอิง คลังสินค้าผ่านชื่อคลังสินค้าภายใต้warehouseBaseDeliveryTime
- บริการเดียวใน Merchant API รองรับประเทศที่นำส่งหลายประเทศ
ช่องใหม่ที่รองรับ
API การตั้งค่าการจัดส่งของผู้ขายรองรับช่องใหม่ต่อไปนี้เมื่อเทียบกับ Content API for Shopping:
- คลังสินค้า: ให้ข้อมูลเกี่ยวกับคลังสินค้า ซึ่งจัดเก็บและจัดการสินค้าคงคลังได้
- โปรแกรมสะสมคะแนน: ผู้ใช้ Merchant API สามารถป้อนข้อมูลโปรแกรมสะสมคะแนนเพื่อ การตั้งค่าการจัดส่ง
- Etag: Etag ออกแบบมาเพื่อแก้ปัญหาการทำงานไม่พร้อมกันเมื่อผู้ใช้ต่างๆ พยายาม อัปเดตการตั้งค่าการจัดส่งโดยใช้ Merchant API และ UI ของ Merchant Center ที่ ในเวลาเดียวกัน
เปลี่ยนชื่อฟิลด์แล้ว
ช่องต่อไปนี้มีการเปลี่ยนชื่อใน Merchant API
Content API for Shopping | API การตั้งค่าการจัดส่งของผู้ขาย | คำอธิบาย |
---|---|---|
service |
services |
บริการจัดส่งรายการเดียว |
service.name |
services.serviceName |
ชื่อรูปแบบอิสระของบริการที่ต้องไม่ซ้ำกันภายในบัญชี Merchant Center |
service.deliveryCountry |
services.deliveryCountries |
รหัสเขตแดน CLDR ของประเทศที่ใช้บริการจัดส่ง |
service.currency |
services.currencyCode |
รหัส CLDR ของสกุลเงินที่ใช้บริการนี้ |
service.deliveryTime.minTransitTimeInDays |
services.deliveryTime.minTransitDays |
จำนวนวันทำการขั้นต่ำที่คำสั่งซื้อใช้ในการขนส่ง เช่น 0 หมายถึงการนำส่งวันเดียวกันและ 1 หมายถึงการนำส่งในวันถัดไป |
service.deliveryTime.maxTransitTimeInDays |
services.deliveryTime.maxTransitDays |
จำนวนวันทำการสูงสุดที่คำสั่งซื้อใช้ในการขนส่ง |
service.deliveryTime.minHandlingTimeInDays |
services.deliveryTime.minHandlingDays |
จำนวนวันทำการขั้นต่ำที่ใช้ก่อนที่จะจัดส่งสินค้าที่สั่งซื้อ |
service.deliveryTime.maxHandlingTimeInDays |
services.deliveryTime.maxHandlingDays |
จำนวนวันทำการสูงสุดที่ใช้ไปก่อนจัดส่งสินค้าที่สั่งซื้อ |
service.deliveryTime.cutoffTime.timezone |
services.deliveryTime.cutoffTime.timeZone |
ตัวระบุเขตเวลาสำหรับเวลาปิดรับคำสั่งซื้อ |
service.deliveryTime.transitTimeTable.postalCodeGroupName |
services.deliveryTime.transitTimeTable.postalCodeGroupNames |
ชื่อกลุ่มรหัสไปรษณีย์ |
service.deliveryTime.transitTimeTable.transitTimeLabel |
services.deliveryTime.transitTimeTable.transitTimeLabel |
ป้ายกำกับเวลาขนส่งของผลิตภัณฑ์ |
service.rate_group |
services.rateGroups |
คำจำกัดความของกลุ่มอัตราค่าจัดส่ง |
service.rate_group.subtable |
services.rateGroups.subtables |
รายการตารางย่อย |
service.rate_group.carrier_rate |
services.rateGroups.carrierRates |
รายการอัตราของผู้ให้บริการขนส่ง |
service.minimumOrderValueTable.storeCodeSetWithMovs |
services.minimumOrderValueTable.storeCodeSetWithMovs |
รายการชุดรหัสร้านค้าที่มีมูลค่าการสั่งซื้อขั้นต่ำเท่ากัน |
วิธีการที่เลิกใช้งานแล้ว
คุณไม่สามารถใช้ shippingsettings.custombatch
เพื่อเรียกดูและ
อัปเดตการตั้งค่าการจัดส่งของหลายบัญชีในคำขอเดียว
ช่องที่เลิกใช้งานแล้ว
ช่องต่อไปนี้จาก Content API เลิกใช้งานแล้วใน Merchant API ผู้ขาย API ไม่มีทางเลือกอื่นสำหรับช่องเหล่านี้
postal_code_group
service
Pickup_service
Eligibility
Scheduling_channel
Delivery_time
Holiday_cutoff
Min_scheduling_time_in_days
Max_scheduling_time_in_days
Scheduling_business_day_config
Rate_group
single_value_alternative_list
เมธอด
การเปรียบเทียบวิธีการใน Content API for Shopping และ API การตั้งค่าการจัดส่งของผู้ขาย
วิธีการ | Content API for Shopping | API ผู้ขาย |
---|---|---|
customBatch |
ใช่ | ไม่ได้ |
get |
ได้ | ได้ |
update |
ได้ | ไม่ได้ |
insert |
ไม่ได้ | ได้ |
getSupportedCarrier |
ได้ | ไม่ได้ |
getSupportedHolidays |
ใช่ | ไม่ |