ภาพรวมของ Merchant API

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

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

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

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

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

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

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

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

  • accounts.products.localInventories.delete
  • accounts.products.localInventories.list
  • accounts.products.regionalInventories.delete
  • accounts.products.regionalInventories.list

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

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

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

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

• accounts.products ที่ใช้งานง่ายขึ้นด้วยการเปิดตัว accounts.productInputs

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

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

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

• ความสอดคล้องที่ดียิ่งขึ้นกับข้อเสนอการปรับปรุง API ของ Google

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

• ปรับปรุงการสนับสนุนและการสื่อสารสำหรับนักพัฒนาแอปผ่านการลงทะเบียนนักพัฒนาแอป

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

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

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

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

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

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

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

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

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

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

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

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

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