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

ดูข้อมูลเพิ่มเติมได้ที่ Method: 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/v1/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. บริการ 1 รายการใน 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 ใช่ ไม่
ก่อนหน้า
Migrate region management
ถัดไป
Migrate online return policy management