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

แหล่งข้อมูล ShippingSettings ช่วยให้คุณเรียกข้อมูลและอัปเดตการตั้งค่าการจัดส่งของบัญชีและบัญชีย่อยทั้งหมดที่เชื่อมโยงกับบัญชีได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีเพิ่มหรือจัดการการตั้งค่าการจัดส่งของบัญชีได้ที่ภาพรวมเกี่ยวกับการตั้งค่าการจัดส่ง

หากต้องการใช้ Merchant API เพื่ออ่านข้อมูลการตั้งค่าการจัดส่ง ให้ใช้คำขอต่อไปนี้

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/shippingSettings

แทนที่ {ACCOUNT_ID} ด้วยตัวระบุที่ไม่ซ้ำกันของบัญชี Merchant Center

หากต้องการใช้ Merchant API เพื่ออัปเดตข้อมูลการตั้งค่าการจัดส่ง ให้ใช้คำขอต่อไปนี้

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/shippingSettings:insert

ดูข้อมูลเพิ่มเติมได้ที่เมธอด: accounts.shippingSettings.insert

การเปรียบเทียบระหว่าง Content API for Shopping กับ Merchant API

ต่อไปนี้คือตัวอย่างการเปรียบเทียบ Content API for Shopping กับแหล่งข้อมูลการตั้งค่าการจัดส่งใน API ย่อยของบัญชี

	Content API	Merchant API
URL	https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/shippingsettings/{ACCOUNT_ID}	https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/shippingSettings:insert
รหัสระบุ	{MERCHANT_ID}/shippingsettings/{ACCOUNT_ID}	{NAME}

รายการต่อไปนี้กล่าวถึงการอัปเดตที่สำคัญในแหล่งข้อมูลการตั้งค่าการจัดส่งใน API ย่อยของบัญชีเมื่อเทียบกับ Content API for Shopping

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

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

แหล่งข้อมูลการตั้งค่าการจัดส่งใน API ย่อยของบัญชีรองรับช่องใหม่ต่อไปนี้เมื่อเทียบกับ Content API for Shopping

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

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

เราได้เปลี่ยนชื่อช่องต่อไปนี้ในแหล่งข้อมูลการตั้งค่าการจัดส่งใน API ย่อยของบัญชี

Content API for Shopping	แหล่งข้อมูลการตั้งค่าการจัดส่ง	คำอธิบาย
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 for Shopping ใน Merchant API Merchant API ไม่มีทางเลือกอื่นสำหรับช่องเหล่านี้

• postal_code_group
• service
• Pickup_service
• Eligibility
• Scheduling_channel
• Delivery_time
• Holiday_cutoff
• Rate_group
  • single_value_alternative_list

เมธอด

ต่อไปนี้เป็นการเปรียบเทียบวิธีการใน Content API for Shopping และแหล่งข้อมูลการตั้งค่าการจัดส่ง

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