ภาพรวมของ Merchant API

คุณใช้ Merchant API เพื่อทำสิ่งต่อไปนี้ได้

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

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

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

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

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

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

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

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

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

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

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

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

  • ลิงก์บัญชี Merchant Center กับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google โดยลงทะเบียนเป็นนักพัฒนาแอป ผู้ใช้ที่มีบทบาทเป็นนักพัฒนา API จะได้รับการสื่อสารเกี่ยวกับ 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/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 โปรดดูคู่มือในเมนูการนำทางด้านซ้าย

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

ถัดไป
Merchant API terms and conditions