ภาพรวมของ Merchant API

คุณสามารถใช้ Merchant API เพื่อดำเนินการต่อไปนี้

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

Merchant API สามารถจัดการบัญชี Merchant Center ที่มีขนาดใหญ่หรือซับซ้อนได้ กรณีการใช้งานทั่วไปมีดังนี้

  • การจัดการบัญชีอัตโนมัติ
  • การจัดการผลิตภัณฑ์อัตโนมัติ
  • การจัดการพื้นที่โฆษณาอัตโนมัติ
  • การจัดการรายงานอัตโนมัติเกี่ยวกับประสิทธิภาพและข้อมูลเชิงลึกทางการตลาด

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

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

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

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

ก่อนจะเริ่มต้น

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

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

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

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

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

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

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

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

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

รูปแบบ URL ของคำขอ

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

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

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

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

DELETE https://merchantapi.googleapis.com/inventories/v1/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/v1/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 ได้ในคำแนะนำในเมนูการนำทางด้านซ้าย

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

ถัดไป
Terms and Conditions