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

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

หากต้องการใช้ 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 กับแหล่งข้อมูลการตั้งค่าการจัดส่งใน Accounts 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}

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

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

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

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

ช่องที่เปลี่ยนชื่อ

ช่องต่อไปนี้เปลี่ยนชื่อในแหล่งข้อมูลการตั้งค่าการจัดส่งใน Accounts 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 region management
ถัดไป
Migrate online return policy management