การผสานรวม API และชุดเครื่องมือช่วยเขียนโค้ด

ใช้ชุดเครื่องมือการผสานรวม API และความช่วยเหลือในการเขียนโค้ดเพื่อเร่งการย้ายข้อมูลไปยัง Merchant API และสร้างการผสานรวมใหม่ด้วยเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ที่ทำงานด้วยระบบ AI

ภาพรวม

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

  • การแปลงโค้ดและการย้ายข้อมูล: ช่วยให้คุณเข้าใจและแปลงโค้ด Content API for Shopping เดิมเป็นรูปแบบ Merchant API ใหม่ ซึ่งรวมถึงการแมปคุณสมบัติของสินค้ากับโครงสร้างใหม่และการอัปเดตไฟล์การจัดการทรัพยากร Dependency
  • ความเชี่ยวชาญด้านเอกสารประกอบเกี่ยวกับ API: ให้คำอธิบายที่ชัดเจนเกี่ยวกับทรัพยากร, เมธอด, ฟิลด์, โควต้า และแนวทางปฏิบัติแนะนำของ Merchant API โดยอิงตามบริบทที่เชื่อถือได้จากเอกสารประกอบเกี่ยวกับ Google API อย่างเป็นทางการ
  • การสร้างโค้ด: สร้างข้อมูลโค้ดสำหรับงานต่างๆ ของ Merchant API ในภาษาต่างๆ เช่น Python, Java, PHP และภาษาอื่นๆ
  • การแก้ปัญหา: ช่วยวิเคราะห์และแก้ไขข้อผิดพลาดที่พบบ่อยเกี่ยวกับ API

เลือกตัวเลือกที่เหมาะกับสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และ Use Case ที่เฉพาะเจาะจงมากที่สุด ใช้ชุดเครื่องมือการผสานรวม API และความช่วยเหลือในการเขียนโค้ดเพื่อปรับแต่งการตั้งค่าให้เหมาะกับเวิร์กโฟลว์ที่ต้องการ ดังนี้

แผนภาพต่อไปนี้แสดงตัวเลือกการตั้งค่าสำหรับการย้ายข้อมูลโค้ดที่มีการใช้งาน AI ในสภาพแวดล้อมในการพัฒนาซอฟต์แวร์แบบผสานรวม (IDE) ที่ใช้กันโดยทั่วไป เช่น Antigravity, Visual Studio Code, Cursor หรือ Copilot คุณสามารถตั้งค่าผู้ช่วยการเขียนโค้ด เช่น Gemini, Claude, ChatGPT, Grok และเพิ่มประสิทธิภาพด้วยเซิร์ฟเวอร์ MCP ของเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ Merchant API หรือทักษะตัวแทน Merchant API เพื่อให้มีความแม่นยำมากขึ้นพร้อมทั้งเพิ่มความเร็วในการผสานรวม

แผนภาพความช่วยเหลือในการเขียนโค้ดสำหรับการผสานรวม AI (Merchant API)

เซิร์ฟเวอร์ MCP สำหรับเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ Merchant API

รับข้อมูลอัจฉริยะตามบริบทเกี่ยวกับ Merchant API จากผู้ช่วยเขียนโค้ดที่คุณเลือก ตอนนี้คุณสามารถเข้าถึงเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ภายใน IDE โดยใช้บริการ Model Context Protocol (MCP) ได้แล้ว บริการนี้จะป้อนข้อมูลสำคัญจากเอกสารประกอบอย่างเป็นทางการของ Google API ให้กับผู้ช่วยเขียนโค้ด ดูข้อมูลเพิ่มเติมเกี่ยวกับโปรโตคอลได้ที่มาตรฐาน Model Context Protocol

วิธีการทำงาน

เมื่อคุณถามคำถามเกี่ยวกับ Merchant API กับผู้ช่วยการเขียนโค้ด IDE ที่เปิดใช้ MCP ความช่วยเหลือในการเขียนโค้ดจะดึงข้อมูลตัวอย่างข้อความและโค้ดที่เกี่ยวข้องมากที่สุดจากแหล่งข้อมูลอย่างเป็นทางการ และแสดงผลเป็นบริบทแก่ผู้ช่วยการเขียนโค้ดโดยใช้แบ็กเอนด์ Retrieval-Augmented Generation (RAG) เฉพาะทาง ระบบ RAG คือระบบที่ปรับปรุงคุณภาพของคำตอบจาก LLM โดยเชื่อมต่อกับแหล่งความรู้ภายนอกที่อัปเดตอยู่เสมอ ซึ่งจะช่วยให้ผู้ช่วยของคุณสามารถให้คำตอบที่ถูกต้องและเป็นปัจจุบันได้โดยที่คุณไม่ต้องออกจากสภาพแวดล้อมในการพัฒนาซอฟต์แวร์

ตัวอย่างเวิร์กโฟลว์

  1. คุณถามคำถามในผู้ช่วยเขียนโค้ดหรือ Agent ที่เข้ากันได้กับ MCP (เช่น คำถามภาษาธรรมชาติ คำขอตัวอย่างโค้ด หรือการแปลงโค้ด)
  2. ความช่วยเหลือในการเขียนโค้ดจะส่งคำขอข้อมูลบริบทไปยังปลายทาง MCP
  3. บริการ MCP จะค้นหาคอลเล็กชันเอกสารประกอบ คู่มือ และตัวอย่างโค้ดอย่างเป็นทางการของ Merchant API ที่จัดทำดัชนีไว้
  4. บริการจะแสดงตัวอย่างที่เชื่อถือได้เป็นบริบทสำหรับผู้ช่วยเขียนโค้ด
  5. ผู้ช่วยเขียนโค้ดจะใช้ประโยชน์จากบริบทนี้เพื่อสร้างคำตอบที่มีข้อมูลสนับสนุนหรือทำงานแปลโค้ด

เริ่มต้นใช้งาน

หากต้องการผสานรวมและใช้ MCP ให้ทำตามขั้นตอนต่อไปนี้

1. ใช้เครื่องมือที่เข้ากันได้

เปิด IDE หรือความช่วยเหลือในการเขียนโค้ดที่รองรับ Model Context Protocol ที่มีการส่งผ่านข้อมูล HTTP แบบสตรีมได้

2. กำหนดค่าปลายทาง

หากต้องการเชื่อมต่อ IDE หรือผู้ช่วยเขียนโค้ดกับ MCP ให้ใช้รายละเอียดปลายทางระยะไกลที่ระบุไว้ ซึ่งอาจกำหนดให้คุณป้อน URL บริการโดยตรงหรือคำจำกัดความ MCP ทั้งนี้ขึ้นอยู่กับการกำหนดค่าของเครื่องมือ

การตั้งค่าการกำหนดค่า

Antigravity

ทำตามวิธีการในเอกสารประกอบของ Antigravity

"mcpServers": {
  "mapi-devdocs": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://merchantapi.googleapis.com/devdocs/mcp"
    ]
  }
}

Visual Studio Code

ทำตามวิธีการในเอกสารประกอบของ Visual Studio Code

"servers": {
"mapi-devdocs": {
  "type": "http",
  "url": "https://merchantapi.googleapis.com/devdocs/mcp/"
  }
}

3. เพิ่มคำสั่งสำหรับ Agent (ไม่บังคับ)

หากต้องการเปิดใช้ Agent ให้แปลโค้ดโดยตรงโดยใช้ MCP ให้ระบุวิธีการของระบบ: Merchant Integrator Agent Protocol คำสั่งเหล่านี้จะแนะนำเอเจนต์เกี่ยวกับวิธีใช้ MCP อย่างถูกต้องสำหรับการแปลโค้ด คุณสามารถระบุวิธีการเหล่านี้ได้ในการกำหนดค่าคำสั่งของระบบหรือเป็นไฟล์บริบทเพิ่มเติมสำหรับ Agent ทั้งนี้ขึ้นอยู่กับเครื่องมือที่คุณใช้

ตัวอย่างสถานการณ์การใช้งาน

MCP สามารถเร่งเวิร์กโฟลว์ของคุณในกรณีการใช้งานทั่วไปต่อไปนี้

สถานการณ์ที่ 1: ย้ายข้อมูลโค้ด products.insert

คุณสามารถขอให้ตัวแทนย้ายข้อมูลโค้ดการผสานรวม Content API for Shopping products.insert ไปยัง Merchant API โดยตรงได้

พรอมต์ของผู้ใช้:

"ย้ายข้อมูลโค้ด products.insert ไปยัง Merchant API"

การให้คำสั่งของระบบและสิทธิ์เข้าถึง MCP แก่ Agent จะช่วยให้ Agent สามารถแปลโค้ด Content API for Shopping เป็นโค้ด Merchant API ได้โดยตรงใน IDE ของคุณ ในกรณีนี้ ระบบจะระบุว่า productInputs.insert เป็นการเรียกที่เทียบเท่าและแมปคุณสมบัติของสินค้าจากรูปแบบเก่าเป็นรูปแบบใหม่ที่ Merchant API กำหนด นอกจากนี้ยังอัปเดตการนำเข้าที่จำเป็นและไฟล์การจัดการทรัพยากร Dependency ได้ด้วย (เช่น requirements.txt, pom.xml หรือ package.json) คุณสามารถสั่งให้ Agent ทำการเปลี่ยนแปลงในตำแหน่งเดิมหรือสร้างโฟลเดอร์ใหม่ได้

สถานการณ์ที่ 2: ค้นหาฟังก์ชันการทำงานที่เทียบเท่า

คุณมีแอปพลิเคชันที่ใช้ Content API for Shopping อยู่แล้วและต้องการอัปเดตแอปพลิเคชันดังกล่าว คุณสามารถถามเกี่ยวกับเมธอดเดิมที่เฉพาะเจาะจงเพื่อดูรายละเอียดเกี่ยวกับการติดตั้งใช้งานใหม่และตัวอย่างโค้ดที่เกี่ยวข้อง

พรอมต์ของผู้ใช้:

"เมธอด accountstatuses.get ใน Content API for Shopping มี Merchant API ที่เทียบเท่ากันคืออะไร"

บริการ MCP จะให้บริบทจากคำแนะนำในการย้ายข้อมูลอย่างเป็นทางการและเอกสารอ้างอิง ซึ่งช่วยให้ผู้ช่วยตอบคำถามโดยละเอียดได้ รวมถึงชื่อ API ใหม่ accounts.issues

สถานการณ์ที่ 3: การค้นหาตัวอย่างโค้ด

คุณกำลังใช้ฟีเจอร์ใหม่และต้องการตัวอย่างที่นำไปใช้ได้จริงเพื่อทำตาม

พรอมต์ของผู้ใช้:

"แสดงตัวอย่างโค้ด Python สำหรับการเพิ่มบริการจัดส่งใหม่โดยใช้ Merchant API"

บริการ MCP จะดึงตัวอย่างโค้ดที่เกี่ยวข้องจากที่เก็บ GitHub อย่างเป็นทางการของ Google และคู่มือนักพัฒนาซอฟต์แวร์ จากนั้นผู้ช่วยจะแสดงบล็อกโค้ดที่สมบูรณ์และพร้อมนำไปปรับใช้

สถานการณ์ที่ 4: ทำความเข้าใจแนวคิด API

คุณพบแนวคิดใหม่หรือต้องการทำความเข้าใจโครงสร้างของแหล่งข้อมูลหรือรูปแบบโดยรวมของ Merchant API

พรอมต์ของผู้ใช้:

"ฉันจะอัปเดตสินค้าคงคลังสำหรับผลิตภัณฑ์โดยใช้ Merchant API ได้อย่างไร"

บริการ MCP จะแสดงผลบริบทจากเอกสารประกอบของแหล่งข้อมูลผลิตภัณฑ์และคำแนะนำที่เกี่ยวข้อง จากนั้นผู้ช่วยจะอธิบายวิธีใช้เมธอด accounts.productInputs.insert และระบุทรัพยากรผลิตภัณฑ์บางส่วนที่มีเพียง productId และช่องที่เกี่ยวข้องกับสินค้าคงคลังที่คุณต้องอัปเดต

"ฉันจะให้สิทธิ์การเรียกใช้แอปพลิเคชันด้วย Merchant API ได้อย่างไร"

บริการ MCP จะดึงบริบทจากคู่มือการตรวจสอบสิทธิ์อย่างเป็นทางการ ซึ่งครอบคลุมวิธีการให้สิทธิ์ต่างๆ จากนั้นผู้ช่วยจะอธิบายตัวเลือกหลักที่มีให้ เช่น การใช้บัญชีบริการสำหรับการโต้ตอบระหว่างเซิร์ฟเวอร์กับเซิร์ฟเวอร์ หรือรหัสไคลเอ็นต์ OAuth 2.0 เมื่อดำเนินการในนามของผู้ใช้

สถานการณ์ที่ 5: การปรับตัวให้เข้ากับการเปลี่ยนแปลงของ API

Merchant API มีรูปแบบใหม่ๆ เช่น การจัดกลุ่มคำขอ ซึ่งแตกต่างจาก Content API for Shopping Content API for Shopping ใช้วิธีการ custombatch ที่เฉพาะเจาะจง ส่วน Merchant API ใช้ฟีเจอร์การจัดกลุ่ม HTTP ทั่วไปในตัว

พรอมต์ของผู้ใช้:

"วิธีใหม่ในการทำ products.custombatch ใน Merchant API คืออะไร"

บริการ MCP จะดึงข้อมูลบริบทจาก เปลี่ยนโครงสร้างภายในโค้ดสำหรับคำขอหลายรายการพร้อมกัน ซึ่งอธิบายว่าไม่มีเมธอด custombatch โดยเฉพาะใน Merchant API แต่จะให้เอกสารประกอบเกี่ยวกับการใช้การรวมกลุ่ม HTTP กับ Content-Type ของ multipart แทน จากนั้นผู้ช่วยจะอธิบายวิธีสร้างคำขอ HTTP รายการเดียวที่มีการเรียก API หลายรายการ ซึ่งส่งไปยังปลายทาง https://merchantapi.googleapis.com/batch/{sub-api}/v1 และแสดงตัวอย่างวิธีจัดโครงสร้างคำขอแบบหลายส่วน ซึ่งจะเปลี่ยนงานการย้ายข้อมูลที่อาจสร้างความสับสนให้เป็นกระบวนการที่มีคำแนะนำ

สถานการณ์ที่ 6: แปลคำค้นหาการรายงาน

คุณขอให้ Agent แปลคำค้นหาการรายงานจาก Content API for Shopping เป็น Merchant API ได้

พรอมต์ของผู้ใช้:

"ย้ายข้อมูลการค้นหาการรายงานนี้จาก Content API ไปยัง Merchant API: SELECT metrics.impressions, metrics.clicks, metrics.ctr FROM MerchantPerformanceView WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'"

บริการ MCP จะดึงเอกสารอ้างอิงการรายงาน คู่มือนักพัฒนาซอฟต์แวร์ และคำแนะนำในการย้ายข้อมูลล่าสุด จากข้อมูลนี้ ระบบจะเปลี่ยนรูปแบบการค้นหาเป็นโครงสร้างใหม่และอัปเดตช่องเป็นชื่อและค่าใหม่

ทักษะของ Agent สำหรับ Merchant API

ข้อกำหนดทักษะของ Agent เป็นมาตรฐานแบบเปิดที่ใช้ในเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ AI ใช้ทักษะของ Agent เพื่อปรับปรุงประสบการณ์การใช้งานของนักพัฒนาซอฟต์แวร์และเพิ่มประสิทธิภาพทั้งการย้ายข้อมูลจาก Content API for Shopping และการสร้างการผสานรวมใหม่ แพ็กเกจ Merchant API Agent Skills จะรวมความรู้และเครื่องมือเฉพาะโดเมนเพื่อเพิ่มความสามารถของ AI Agent และให้ความช่วยเหลือจากผู้เชี่ยวชาญแบบออนดีมานด์สำหรับการค้นหาเอกสารประกอบ การสร้างโค้ด และการแก้ปัญหา

ทักษะตัวแทน Merchant API ใช้ได้กับเครื่องมือบรรทัดคำสั่งและ IDE ที่ทำงานด้วยระบบ AI ต่างๆ เช่น Antigravity และ Claude Code

วิธีการทำงาน

ทักษะ Agent ของ Merchant API มอบแพ็กเกจความเชี่ยวชาญเฉพาะทางที่สร้างขึ้นตามมาตรฐานทักษะ Agent แบบเปิด ทักษะ Agent mapi-developer-assistant ของเราทำหน้าที่เป็นเลเยอร์อัจฉริยะระหว่างเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ AI กับเซิร์ฟเวอร์ MCP ของเอกสารสำหรับนักพัฒนาซอฟต์แวร์ Merchant API ที่เกี่ยวข้อง โดยจะฝังความเชี่ยวชาญเฉพาะด้านและคำแนะนำเกี่ยวกับขั้นตอนต่างๆ ไว้ และมีคุณสมบัติดังต่อไปนี้

  • ไม่ต้องกำหนดค่า: จัดการการเชื่อมต่อเซิร์ฟเวอร์ MCP โดยอัตโนมัติ ทำให้ไม่ต้องตั้งค่าปลายทางด้วยตนเอง
  • เวิร์กโฟลว์ผู้เชี่ยวชาญ: ปรับแต่งพรอมต์ของผู้ใช้ให้เป็นคำค้นหาที่เพิ่มประสิทธิภาพเพื่อดึงข้อมูลที่เกี่ยวข้องมากที่สุดได้อย่างมีประสิทธิภาพ
  • การจัดการบริบทและประสิทธิภาพของโทเค็น: ใช้ "การเปิดเผยแบบต่อเนื่อง" เพื่อโหลดข้อมูลแบบออนดีมานด์และรักษาหน้าต่างบริบทของ AI
  • การจัดรูปแบบเอาต์พุตที่ปรับปรุงแล้ว: ให้คำแนะนำในการจัดรูปแบบและโครงสร้างเอาต์พุตเพื่อให้ได้คำตอบที่นำไปใช้ได้จริง อ่านง่าย และสอดคล้องกัน

ตัวอย่างเวิร์กโฟลว์

  1. คุณถามคำถามเกี่ยวกับ Merchant API ในเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ AI
  2. ทักษะของ Agent สำหรับ Merchant API จะวิเคราะห์ความตั้งใจของคุณ กำหนดคำค้นหาที่แม่นยำ และใช้ความรู้ด้านกระบวนการกับคำขอ
  3. ทักษะของ Agent จะส่งคำขอข้อมูลบริบทไปยังเซิร์ฟเวอร์ MCP ของเอกสารสำหรับนักพัฒนาซอฟต์แวร์ Merchant API ที่ merchantapi.googleapis.com/devdocs/mcp/
  4. บริการ MCP จะค้นหาคอลเล็กชันเอกสารประกอบ คู่มือ และตัวอย่างโค้ดอย่างเป็นทางการของ Merchant API ที่จัดทำดัชนีไว้
  5. AI Agent จะใช้ข้อมูลนี้เพื่อสร้างคำตอบที่สังเคราะห์ขึ้นและนำไปใช้ได้จริง

เริ่มต้นใช้งาน

ไฟล์ README ของทักษะ Agent ของ Merchant API มีคำแนะนำทีละขั้นตอนเกี่ยวกับสิ่งต่อไปนี้

  • ข้อกำหนดเบื้องต้นสำหรับเครื่องมือต่างๆ เช่น เครื่องมือบรรทัดคำสั่ง Antigravity
  • การเปิดใช้การรองรับทักษะของ Agent ในเครื่องมือที่คุณเลือก
  • ติดตั้งสกิล mapi-developer-assistant จากที่เก็บ GitHub ตามคำแนะนำใน README
  • กำลังยืนยันการติดตั้ง
  • คำสั่งการจัดการทักษะพื้นฐาน

ดูวิธีการติดตั้งและตั้งค่าโดยละเอียดสำหรับเครื่องมือ AI ต่างๆ รวมถึงเครื่องมือบรรทัดคำสั่ง Antigravity, Claude Code และอื่นๆ ได้จากไฟล์ README

ตัวอย่างพรอมต์

เมื่อติดตั้งและเปิดใช้ในเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ AI แล้ว โดยปกติแล้วทักษะ mapi-developer-assistant จะเปิดใช้งานโดยอัตโนมัติเมื่อคุณถามคำถามที่เกี่ยวข้องกับ Merchant API

"ฉันจะแทรกสินค้าโดยใช้ Merchant API ใน Python ได้อย่างไร"

"เมธอด accountstatuses.get ของ Content API เทียบเท่ากับเมธอดใดใน Merchant API"

"แสดงตัวอย่าง Java สำหรับการจัดการการตรวจสอบสิทธิ์ด้วย Merchant API"

"ฉันได้รับข้อผิดพลาด '400 คำขอไม่ถูกต้อง' พร้อมข้อผิดพลาดในการตรวจสอบเมื่อเรียกใช้ productInputs.insert ฉันจะแก้ไขปัญหานี้ได้อย่างไร"

"ProductInput และ Product ใน Merchant API แตกต่างกันอย่างไร"

แหล่งข้อมูลฐานความรู้

บริการ MCP สร้างฐานความรู้จากแหล่งข้อมูลสาธารณะและแหล่งข้อมูลอย่างเป็นทางการเท่านั้น เพื่อให้มั่นใจว่าบริบทที่ให้มานั้นถูกต้องและเชื่อถือได้ บริการนี้จะจัดทำดัชนีเนื้อหาทั้งหมดของเว็บไซต์อย่างเป็นทางการของนักพัฒนาซอฟต์แวร์และที่เก็บตัวอย่างโค้ด ซึ่งรวมถึงรายการต่อไปนี้