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

หากต้องการใช้ 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

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

ตัวอย่างการเปรียบเทียบ Content API for Shopping กับ Merchant Shipping Settings 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 ไม่รองรับการดำเนินการอ่านและเขียนในพื้นที่ที่กำหนดเอง เช่น กลุ่มสถานที่ตั้ง พื้นที่ที่กำหนดเอง เช่น กลุ่มสถานที่ตั้ง จะสามารถอ่านหรือเขียนได้โดยใช้บริการในภูมิภาคเท่านั้น
  3. วิธีการตั้งค่า WarehouseBasedDeliveryTime ใน Merchant API จะแตกต่างจาก Content API for Shopping หากใช้ Merchant API คุณต้องกำหนดข้อมูลคลังสินค้าในส่วน shippingsettings.warehouses จากนั้นบริการจัดส่งแต่ละรายการจะอ้างอิงคลังสินค้าผ่านชื่อคลังสินค้าในส่วน warehouseBaseDeliveryTime ได้
  4. บริการเดียวใน Merchant API รองรับประเทศนำส่งหลายประเทศ

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

Merchant Shipping settings API รองรับช่องใหม่ต่อไปนี้เมื่อเทียบกับ Content API for Shopping

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

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

ฟิลด์ต่อไปนี้เปลี่ยนชื่อใน Merchant API แล้ว

API เนื้อหาสำหรับช็อปปิ้ง 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 เพื่อดึงข้อมูลและอัปเดตการตั้งค่าการจัดส่งของหลายบัญชีในคำขอเดียวไม่ได้

ช่องที่เลิกใช้งาน

ช่องต่อไปนี้เลิกใช้งานแล้วใน Merchant API โปรดทราบว่า Merchant API ไม่ได้ให้ตัวเลือกอื่นสำหรับช่องเหล่านี้

API เนื้อหาสำหรับช็อปปิ้ง API ผู้ขาย
postal_code_group region
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
    • |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 และ Merchant Shipping Settings API มีดังนี้

      วิธีการ API เนื้อหาสำหรับช็อปปิ้ง API ผู้ขาย
      customBatch ได้ ไม่ได้
      รับ ได้ ได้
      อัปเดต ได้ ไม่ได้
      Insert ไม่ได้ ได้
      getSupportedCarrier ได้ ไม่ได้
      getSupportedHolidays ได้ ไม่ได้