ย้ายข้อมูลจาก v1beta เป็น v1

คำแนะนำนี้จะช่วยคุณย้ายข้อมูลจาก Merchant API v1beta ไปยัง v1 ซึ่งเป็นเวอร์ชันแรก ที่พร้อมให้บริการแก่บุคคลทั่วไป เวอร์ชัน v1 มีการอัปเดตหลายอย่างและ การเปลี่ยนแปลงเล็กน้อยที่อาจต้องมีการอัปเดตโค้ด การเปลี่ยนแปลงเหล่านี้มีจุดประสงค์เพื่อ ลดความซับซ้อนของ API และปรับปรุงการจัดการบัญชี Merchant Center

ความแตกต่างที่สำคัญ

การเปลี่ยนแปลงที่สำคัญที่สุดซึ่งคุณควรทราบเมื่อย้ายข้อมูลจาก v1beta ไป v1 มีดังนี้

• ลงทะเบียนนักพัฒนา API อย่างน้อย 1 รายแบบครั้งเดียวเพื่อใช้ Merchant API: คุณจะต้องเรียกใช้เมธอด registerGcp (เพียงครั้งเดียวสำหรับแต่ละโปรเจ็กต์ Google Cloud ที่ใช้สำหรับการ ตรวจสอบสิทธิ์) เพื่อระบุรายละเอียดการติดต่อ ซึ่งจะช่วยให้คุณใช้ API และรับข้อมูลอัปเดตและประกาศที่เกี่ยวข้องกับ Merchant API ได้ คุณจะใช้ API ของ v1 หรือ v1alpha ไม่ได้จนกว่าจะทำขั้นตอนนี้เสร็จสมบูรณ์ ดูวิธีการได้ที่หัวข้อลงทะเบียนในฐานะนักพัฒนาแอป

• การเข้ารหัสชื่อผลิตภัณฑ์: ฟิลด์ ProductInput.name และ Product.name รองรับการเข้ารหัส base64url แบบไม่มีการเพิ่มแพด (RFC 4648 ส่วนที่ 5) ทำตาม หลักเกณฑ์ต่อไปนี้

  • สตริงต้องเป็นไปตามcontentLanguage~feedLabel~offerIdรูปแบบ

  • การเข้ารหัสเป็นข้อกำหนดหากชื่อผลิตภัณฑ์มีอักขระที่ใช้ โดย Merchant API หรืออักขระที่สงวนไว้สำหรับ URL เช่น

    % . + / : ~ , ( * ! ) & ? = @ # $
    

  • หากชื่อผลิตภัณฑ์เป็นไปตามcontentLanguage~feedLabel~offerId รูปแบบและไม่มีอักขระใดๆ ที่ใช้โดย Merchant API หรือ อักขระที่สงวนไว้สำหรับ URL คุณอาจใช้รูปแบบธรรมดาโดยไม่ต้องเข้ารหัส

  • เราขอแนะนำให้ใช้การเข้ารหัส base64url ที่ไม่มีการเพิ่มแพด สำหรับชื่อผลิตภัณฑ์ทั้งหมดเพื่อให้การแยกวิเคราะห์สอดคล้องและถูกต้อง

• การนำข้อมูลภาษีระดับผลิตภัณฑ์ออก: taxes และ taxCategory

• Product.attributes เปลี่ยนชื่อแล้ว: เปลี่ยนชื่อฟิลด์ Product.attributes เป็น Product.productAttributes แล้ว

• การนำข้อมูลภาษีระดับผลิตภัณฑ์ออก: ระบบได้นำฟิลด์ taxes และ taxCategory ออกจากออบเจ็กต์ Product.productAttributes แล้ว ดูข้อมูลเพิ่มเติมได้ที่บทความช่วยเหลือของ Google Merchant Center เกี่ยวกับภาษี

• การเปลี่ยนแปลงฟิลด์ GTIN: ฟิลด์ gtin ในออบเจ็กต์ Product.productAttributes ได้เปลี่ยนชื่อเป็น gtins เพื่อให้สะท้อนว่าฟิลด์นี้สามารถมีค่าได้หลายค่า ตอนนี้ช่อง gtin ในออบเจ็กต์ OrderTrackingSignals.lineItemDetails เป็น array และได้เปลี่ยนชื่อเป็น gtins แล้ว

• การนำช่องทางออก: ระบบได้นำช่อง channel ออกจาก ผลิตภัณฑ์ ข้อมูลผลิตภัณฑ์ และแหล่งข้อมูล เราได้เพิ่มฟิลด์บูลีนใหม่ legacyLocal เพื่อระบุผลิตภัณฑ์ที่ขายเฉพาะในร้านค้าจริงอย่างชัดเจน หมายเหตุ: ฟิลด์ legacyLocal เป็นฟิลด์เสริมที่ช่วยในการ ย้ายข้อมูล และจะเลิกใช้งานในที่สุดเมื่อกำหนดเป้าหมายวิธีการทางการตลาดออนไลน์และในร้าน ได้อย่างเต็มที่ด้วยแหล่งที่มาของผลิตภัณฑ์เดียว ดูข้อมูลเพิ่มเติมได้ในตาราง ในส่วนต่อไปนี้

• ฟิลด์ใหม่สำหรับแอตทริบิวต์สินค้าคงคลังระดับภูมิภาคและระดับท้องถิ่น:

  • ฟิลด์ RegionalInventory ทั้งหมด ยกเว้น name, account และ region จะรวมอยู่ภายใต้ออบเจ็กต์ใหม่ที่ชื่อ regionalInventoryAttributes เช่น ตอนนี้แอตทริบิวต์ RegionalInventory.price อยู่ในส่วน RegionalInventory.regionalInventoryAttributes.price
  • ฟิลด์ LocalInventory ทั้งหมด ยกเว้น name, account และ storeCode จะรวมอยู่ภายใต้ออบเจ็กต์ใหม่ที่ชื่อ localInventoryAttributes เช่น ตอนนี้แอตทริบิวต์ LocalInventory.price อยู่ในส่วน LocalInventory.localInventoryAttributes.price

• การนำ customAttributes ออกจากสินค้าคงคลังระดับภูมิภาคและระดับท้องถิ่น: ระบบได้นำฟิลด์ customAttributes ออกจากทั้งทรัพยากร RegionalInventory และ LocalInventory แล้ว

• การสร้างบัญชีที่ปรับปรุงแล้ว: เราได้นำฟิลด์ users ที่ซ้ำซ้อนออก จาก CreateAndConfigureAccountRequest แล้ว ใช้ฟิลด์ user เดียวเพื่อเชื่อมโยงผู้ใช้เริ่มต้นกับบัญชีใหม่

• มีการเปลี่ยนประเภทแอตทริบิวต์บางประเภทจากสตริงเป็น Enum: มีการเปลี่ยนฟิลด์บางรายการ ภายในทรัพยากร Product และ Inventory ที่มีรายการค่าแบบย่อที่กำหนดจากประเภท string เป็นประเภท enum เพื่อการตรวจสอบข้อมูลที่ดีขึ้น (เช่น ฟิลด์ Product.ProductAttributes.condition ตอนนี้เป็น enum)

• การนำวิธีการอัปเดตนโยบายคืนสินค้าออนไลน์ออก: เราจะนำวิธีการ onlineReturnPolicy.update ออกในv1 สร้างนโยบายการคืนสินค้าออนไลน์โดยใช้วิธีการ onlineReturnPolicy.create แทน

วิธีย้ายข้อมูล

เรามีกำหนดจะหยุดให้บริการ Merchant API เวอร์ชัน v1beta ในวันที่ 28 กุมภาพันธ์ 2026 ดูข้อมูลเพิ่มเติมเกี่ยวกับกำหนดการเลิกใช้งานได้ที่คู่มือการกำหนดเวอร์ชัน Merchant API

• ขั้นตอนแรกในการย้ายข้อมูลคือการลงทะเบียนนักพัฒนาแอปแบบครั้งเดียว (ดูลงทะเบียนเป็นนักพัฒนาแอป) คุณต้องเรียกใช้เมธอด registerGcp สำหรับโปรเจ็กต์ Google Cloud แต่ละโปรเจ็กต์ที่คุณใช้ สำหรับการตรวจสอบสิทธิ์ก่อนที่เมธอด v1 จะทำงาน

• ไม่ว่าคุณจะเรียกใช้ API ด้วยวิธีใด (ด้วย REST, gRPC หรือโดยใช้ไลบรารี ไคลเอ็นต์) คุณก็สามารถย้ายข้อมูลเป็นระยะๆ ได้ ซึ่งหมายความว่าคุณสามารถอัปเดตและย้ายข้อมูลโค้ดทีละ API ได้ (เช่น ย้าย Products API ไปยัง v1 ขณะที่ยังคงใช้ Accounts API ใน v1beta) โดยไม่ต้องอัปเดตการผสานรวมทั้งหมดพร้อมกัน

การเปลี่ยนแปลงฟิลด์โดยละเอียด

ตารางนี้แสดงการเปรียบเทียบโดยละเอียดของฟิลด์ที่มีการเปลี่ยนแปลง ระหว่างเวอร์ชัน v1beta และ v1