ภาพรวมของ 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 มีดังนี้

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

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

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

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

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

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

• แนะนําทรัพยากร accounts.productInputs เพื่อลดความซับซ้อนของทรัพยากร accounts.products

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

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

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

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

• สอดคล้องกับข้อเสนอการปรับปรุง API ของ Google มากขึ้น

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

ก่อนจะเริ่ม

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

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

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

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

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

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

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

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

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

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

หากต้องการแสดงความคิดเห็น ให้ส่งข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้

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

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

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

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

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