ย้ายข้อมูลการตั้งค่าการจัดส่งจาก 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 กับผู้ขายมีดังนี้ 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

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

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

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

1. คลังสินค้า: ให้ข้อมูลเกี่ยวกับคลังสินค้า ซึ่งจัดเก็บและจัดการสินค้าคงคลังได้
2. โปรแกรมสะสมคะแนน: ผู้ใช้ Merchant API สามารถป้อนข้อมูลโปรแกรมสะสมคะแนนเพื่อ การตั้งค่าการจัดส่ง
3. 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	ใช่	ไม่