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

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

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

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

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

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

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

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

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

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

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

รายการต่อไปนี้กล่าวถึงการอัปเดตที่สำคัญในแหล่งข้อมูลการตั้งค่าการจัดส่ง ใน Sub-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

ฟิลด์ใหม่ที่รองรับ

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

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

ฟิลด์ที่เปลี่ยนชื่อ

เราได้เปลี่ยนชื่อช่องต่อไปนี้ในทรัพยากรการตั้งค่าการจัดส่งใน Sub-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 ใช่ ไม่
ก่อนหน้า
Migrate data sources management
ถัดไป
Migrate conversion sources management