ภาพรวมของ Merchant API

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

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

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

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

Merchant API เป็นการออกแบบใหม่ของ Content API for Shopping และประกอบด้วย API ย่อยหลายรายการ

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ฟีเจอร์ใหม่ที่เปิดตัวใน 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 2 วิธีในการเรียก Merchant API มีดังนี้

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 โปรดดูคำแนะนำในเมนูการนำทางด้านซ้าย

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

ก่อนหน้า
Latest updates
ถัดไป
Design