ย้ายข้อมูลการตั้งค่าการจัดส่งจาก Content API for Shopping

แหล่งข้อมูล 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 กับ Merchant Shipping settings API

	Content API	Merchant 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

1. ผู้ใช้ Merchant API ต้องใส่ accounts/{accountId}/shippingSettings ในช่อง {name} เพื่อให้มีการทำงานแบบเดียวกัน
2. Merchant API ไม่รองรับการดำเนินการอ่านและเขียนในพื้นที่ที่กำหนดเอง เช่น กลุ่มสถานที่ตั้ง พื้นที่ที่กำหนดเอง เช่น กลุ่มสถานที่ตั้ง จะอ่านหรือเขียนได้โดยใช้บริการภูมิภาคเท่านั้น
3. วิธีตั้งค่า WarehouseBasedDeliveryTime จะแตกต่างกันสำหรับ Merchant API เมื่อเทียบกับ Content API for Shopping หากคุณใช้ Merchant API คุณต้องกําหนดข้อมูลคลังสินค้าในส่วน shippingsettings.warehouses จากนั้นบริการจัดส่งแต่ละรายการจะอ้างอิงถึงคลังสินค้าผ่านชื่อคลังสินค้าในส่วน warehouseBaseDeliveryTime ได้
4. บริการเดียวใน Merchant API รองรับหลายประเทศที่จัดส่งได้

ช่องใหม่ที่รองรับ

Merchant Shipping settings API รองรับช่องใหม่ต่อไปนี้เมื่อเทียบกับ Content API for Shopping

1. คลังสินค้า: ให้ข้อมูลเกี่ยวกับคลังสินค้าสำหรับการดำเนินการตามคำสั่งซื้อซึ่งจัดเก็บและจัดการสินค้าคงคลัง
2. โปรแกรมสะสมคะแนน: ผู้ใช้ Merchant API สามารถป้อนข้อมูลโปรแกรมสะสมคะแนนในการตั้งค่าการจัดส่ง
3. Etag: Etag ออกแบบมาเพื่อแก้ปัญหาแบบไม่พร้อมกันเมื่อผู้ใช้รายอื่นพยายามอัปเดตการตั้งค่าการจัดส่งโดยใช้ Merchant API และ UI ของ Merchant Center พร้อมกัน

ช่องที่มีการเปลี่ยนชื่อ

เราได้เปลี่ยนชื่อฟิลด์ต่อไปนี้ใน Merchant API

Content API for Shopping	Merchant Shipping Settings 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 แล้ว Merchant 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 กับ Merchant Shipping Settings API

วิธีการ	Content API for Shopping	Merchant API
customBatch	ใช่	ไม่ได้
get	ได้	ใช่
update	ได้	ไม่ได้
insert	ไม่ได้	ได้
getSupportedCarrier	ได้	ไม่ได้
getSupportedHolidays	ใช่	ไม่