หากต้องการใช้ 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
การเปรียบเทียบระหว่าง Content API for Shopping กับ Merchant API
ตัวอย่างการเปรียบเทียบ Content API for Shopping กับ Merchant Shipping Settings 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 ไม่รองรับการดำเนินการอ่านและเขียนในพื้นที่ที่กำหนดเอง เช่น กลุ่มสถานที่ตั้ง พื้นที่ที่กำหนดเอง เช่น กลุ่มสถานที่ตั้ง จะสามารถอ่านหรือเขียนได้โดยใช้บริการในภูมิภาคเท่านั้น
- วิธีการตั้งค่า
WarehouseBasedDeliveryTime
ใน Merchant API จะแตกต่างจาก Content API for Shopping หากใช้ Merchant API คุณต้องกำหนดข้อมูลคลังสินค้าในส่วนshippingsettings.warehouses
จากนั้นบริการจัดส่งแต่ละรายการจะอ้างอิงคลังสินค้าผ่านชื่อคลังสินค้าในส่วนwarehouseBaseDeliveryTime
ได้ - บริการเดียวใน Merchant API รองรับประเทศนำส่งหลายประเทศ
ช่องใหม่ที่รองรับ
Merchant Shipping settings API รองรับช่องใหม่ต่อไปนี้เมื่อเทียบกับ Content API for Shopping
- คลังสินค้า: ให้ข้อมูลเกี่ยวกับคลังสินค้าดำเนินการตามคำสั่งซื้อ ซึ่งจัดเก็บและจัดการสินค้าคงคลัง
- โปรแกรมสะสมคะแนน: ผู้ใช้ Merchant API จะป้อนข้อมูลโปรแกรมสะสมคะแนนลงในการตั้งค่าการจัดส่งได้
- Etag: Etag ออกแบบมาเพื่อแก้ปัญหาอะซิงโครนัสเมื่อผู้ใช้แต่ละคนพยายามอัปเดตการตั้งค่าการจัดส่งโดยใช้ Merchant API และ UI ของ Merchant Center พร้อมกัน
ช่องที่เปลี่ยนชื่อ
ฟิลด์ต่อไปนี้เปลี่ยนชื่อใน Merchant API แล้ว
API เนื้อหาสำหรับช็อปปิ้ง | 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
เพื่อดึงข้อมูลและอัปเดตการตั้งค่าการจัดส่งของหลายบัญชีในคำขอเดียวไม่ได้
ช่องที่เลิกใช้งาน
ช่องต่อไปนี้เลิกใช้งานแล้วใน Merchant API โปรดทราบว่า Merchant API ไม่ได้ให้ตัวเลือกอื่นสำหรับช่องเหล่านี้
API เนื้อหาสำหรับช็อปปิ้ง | API ผู้ขาย | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
postal_code_group |
region |
||||||||||||||||||||
service
| วิธีการการเปรียบเทียบวิธีการใน Content API for Shopping และ Merchant Shipping Settings API มีดังนี้
|