ภาพรวมของ Merchant API

หน้านี้จะแนะนำ Merchant API และอธิบายวิธีใช้ API ดังกล่าวเพื่อทำให้เวิร์กโฟลว์ต่างๆ ที่เกี่ยวข้องกับการจัดการบัญชี ผลิตภัณฑ์ และสินค้าคงคลังใน Merchant Center เป็นแบบอัตโนมัติ

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

  • การจัดการบัญชีอัตโนมัติ
  • การจัดการผลิตภัณฑ์อัตโนมัติ
  • การจัดการสินค้าคงคลังอัตโนมัติ
  • การรายงานที่กำหนดเอง

Merchant API ช่วยให้คุณสร้างและจัดการแหล่งข้อมูลได้หลายแหล่ง ซึ่งช่วยให้จัดระเบียบข้อมูลเกี่ยวกับผลิตภัณฑ์ โปรโมชัน และรีวิวได้ดียิ่งขึ้น Merchant API ช่วยให้คุณจัดการผลิตภัณฑ์ในลักษณะที่เสริมวิธีการอัปโหลดข้อมูลผลิตภัณฑ์อื่นๆ เช่น ไฟล์และฟีดอัตโนมัติ

Merchant API เป็น การรีดีไซน์ Content API for Shopping และประกอบด้วยAPI ย่อยหลายรายการ

ผู้ค้าปลีกมีหน้าที่รับผิดชอบในการปฏิบัติตามนโยบายโฆษณา Shopping และข้อมูลที่แสดงฟรี Google Shopping ขอสงวนสิทธิ์ในการใช้นโยบายเหล่านี้และดำเนินการตามความเหมาะสมหากพบเนื้อหาหรือพฤติกรรมที่ละเมิดนโยบายเหล่านี้

มีอะไรใหม่ใน Merchant API

เหตุผลที่ควรอัปเกรดเป็น Merchant API มีดังนี้

  • การจัดการข้อมูลสินค้าคงคลังได้ดียิ่งขึ้นด้วยการเปิดตัววิธีการใหม่ต่อไปนี้

  • ช่วยให้จัดการแหล่งข้อมูลเสริมได้ผ่านการสร้างและการเรียกข้อมูลแหล่งข้อมูลเสริม รวมถึงการลิงก์แหล่งข้อมูลเสริมกับแหล่งข้อมูลหลัก

  • เปิดใช้การแจ้งเตือนสำหรับการเปลี่ยนแปลงข้อมูลผลิตภัณฑ์ ซึ่งจะช่วยลดความจำเป็นในการดึงข้อมูลเป็นระยะๆ โดยการแจ้งเตือนคุณเมื่อสถานะผลิตภัณฑ์มีการเปลี่ยนแปลง

  • แนะนำแหล่งข้อมูลและวิธีการดึงข้อมูลและอัปเดตการตั้งค่าฟีดอัตโนมัติ accounts.autofeedSettings

  • เปิดตัวการอัปโหลดรีวิวผลิตภัณฑ์และรีวิวผู้ขาย

  • ทรัพยากรที่ลดความซับซ้อนของ accounts.products เมื่อมีการนำทรัพยากร accounts.productInputs มาใช้

  • เปิดใช้การอัปเดตข้อมูลผลิตภัณฑ์ร่วมกับวิธีการอัปโหลดข้อมูลอื่นๆ เช่น ไฟล์

  • ตารางใหม่สำหรับNonProductPerformanceView ข้อมูลประสิทธิภาพที่ไม่เกี่ยวข้องกับผลิตภัณฑ์ เช่น ข้อมูลการเข้าชมเว็บไซต์ของผู้ค้าปลีก

  • การออกแบบแบบโมดูลที่มีการปรับปรุงฟีเจอร์แยกต่างหากและบ่อยขึ้น

  • ปรับปรุงให้สอดคล้องกับข้อเสนอการปรับปรุง API ของ Google

  • เอกสารประกอบและตัวอย่างโค้ดที่อัปเดต

ดูข้อมูลเพิ่มเติมได้ที่ฟีเจอร์ใหม่ที่เปิดตัวใน Merchant API เวอร์ชันเบต้า

ก่อนจะเริ่ม

หากต้องการเรียกใช้คำขอ Merchant API คุณต้องมีสิ่งต่อไปนี้

  • บัญชี Merchant Center: บัญชีที่จะใช้ค้นหา อัปเดต และอัปโหลดข้อมูล ตรวจสอบว่าคุณมีสิทธิ์ที่จำเป็นในการจัดการผลิตภัณฑ์และสินค้าคงคลังในบัญชีนี้

  • โปรเจ็กต์ Google Cloud: โปรเจ็กต์นี้ใช้เพื่อรับสิทธิ์เข้าถึง API ของบัญชี

การตรวจสอบสิทธิ์ด้วย Merchant API

คุณใช้ตัวเลือกต่อไปนี้เพื่อตรวจสอบสิทธิ์ได้

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

ตัวระบุบัญชีและผลิตภัณฑ์

Merchant API ใช้ชื่อทรัพยากรแทนรหัสในการระบุตัวตน ตัวอย่างชื่อทรัพยากรของผลิตภัณฑ์อาจเป็นaccounts/123456/products/online~en~US~sku123 โดยที่ 123456 คือตัวระบุที่ไม่ซ้ำกันของบัญชี และ online~en~US~sku123 คือตัวระบุที่ไม่ซ้ำกันของผลิตภัณฑ์

รูปแบบ URL คำขอ

หากต้องการดำเนินการกับทรัพยากร ให้ส่งคำขอไปยัง URL ในรูปแบบต่อไปนี้

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

ระบบจะไม่ใส่ส่วน :{METHOD} สำหรับเมธอดมาตรฐาน เช่น list และ get

ตัวอย่างเช่น คำขอต่อไปนี้จะลบสินค้าคงคลังระดับภูมิภาค

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123456/products/online~en~US~sku123/regionalInventories/456

หากต้องการสร้างทรัพยากรใหม่ คุณสามารถใช้ชื่อทรัพยากรของทรัพยากรหลักและ URL ต่อไปนี้

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

ตัวอย่างเช่น คําขอต่อไปนี้แสดงวิธีสร้างภูมิภาคใหม่สําหรับ accounts/123456

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

ดูรายละเอียดเพิ่มเติมเกี่ยวกับบริการที่เฉพาะเจาะจงได้ในเอกสารอ้างอิง Merchant API

เริ่มต้นใช้งาน Merchant API

หากต้องการดูวิธีการทำงานของ Merchant API และลองอัปโหลดตัวอย่างผลิตภัณฑ์อย่างรวดเร็ว โปรดดูหัวข้อเริ่มต้นใช้งาน Merchant API

ใช้ gRPC หรือ REST

Merchant API รองรับ gRPC และ REST การเรียก Merchant API มี 2 วิธีดังนี้

gRPC (แนะนำ) REST
  1. สร้างเนื้อหาของคําขอเป็นบัฟเฟอร์โปรโตคอล
  2. ส่งเนื้อหาคำขอไปยังเซิร์ฟเวอร์ด้วย HTTP/2
  3. แปลงค่าการตอบกลับเป็นบัฟเฟอร์โปรโตคอล
  4. ตีความผลลัพธ์
  1. สร้างเนื้อหาของคำขอเป็นออบเจ็กต์ JSON
  2. ส่งไปยังเซิร์ฟเวอร์โดยใช้ HTTP 1.1
  3. แปลงค่าการตอบกลับเป็นออบเจ็กต์ JSON
  4. ตีความผลลัพธ์

ใช้ไลบรารีไคลเอ็นต์และตัวอย่างโค้ด

API ย่อยแต่ละรายการมีไลบรารีของไคลเอ็นต์เพื่อช่วยในการเริ่มต้นใช้งาน ตัวอย่างโค้ดจะช่วยคุณเริ่มต้นเขียนโค้ดใน Java, PHP และ Python ดูข้อมูลเพิ่มเติมได้ที่ตัวอย่างสำหรับ Merchant API

รับความช่วยเหลือ

ดูข้อมูลเกี่ยวกับการรับการสนับสนุนได้ที่รับความช่วยเหลือเกี่ยวกับ Merchant API

แสดงความคิดเห็น

ระยะเวลาเบต้าช่วยให้เรามีเวลารวบรวมและดำเนินการตามความคิดเห็นของคุณก่อนเปิดตัวเวอร์ชันสำหรับผู้ใช้ทั่วไป หากต้องการแสดงความคิดเห็น โปรดส่งข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้

  • ฟีเจอร์ API: ส่งแบบฟอร์มความคิดเห็น
  • เอกสารประกอบ: ใช้การกดไอคอนชอบในหน้าเว็บและปุ่มส่งความคิดเห็น
  • ตัวอย่างและไลบรารี: สร้างปัญหาในที่เก็บ GitHub เพื่อขอตัวอย่างโค้ด

หากต้องการแสดงความคิดเห็นทั่วไปหลังจากใช้งานแต่ละงาน ให้ใช้แบบฟอร์มความคิดเห็น

ขั้นตอนถัดไป

  • ดูข้อมูลเกี่ยวกับการเข้ากันได้แบบย้อนหลังได้ที่ความเข้ากันได้ของ Content API for Shopping

  • ดูข้อมูลเพิ่มเติมเกี่ยวกับฟีเจอร์หลักของ Merchant API ได้ในคู่มือในเมนูการนำทางด้านซ้าย

  • ดูข้อมูลเกี่ยวกับแหล่งข้อมูลและบริการที่มีให้บริการได้ที่เอกสารอ้างอิง

ถัดไป
การออกแบบ