ภาพรวมของ Merchant API

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

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

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

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

Merchant API ช่วยให้คุณสร้างและจัดการแหล่งข้อมูลหลายแหล่งได้ จึงทำให้จัดระเบียบข้อมูลเกี่ยวกับผลิตภัณฑ์ โปรโมชัน และ รีวิวได้ดียิ่งขึ้น นอกจากนี้ 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"
  }
}

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

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

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