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

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

ภาพรวม

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

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

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

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

(Merchant API) แผนภาพผู้ช่วยเขียนโค้ดการผสานรวม AI

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

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

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

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

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

  1. คุณถามคำถามในผู้ช่วยเขียนโค้ดหรือเอเจนต์ที่เข้ากันได้กับ 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. เพิ่มคำสั่งสำหรับตัวแทน (ไม่บังคับ)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

สถานการณ์ที่ 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: แปลคำค้นหาการรายงาน

คุณขอให้ตัวแทนแปลคำค้นหาการรายงานจาก 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 จะดึงเอกสารอ้างอิงการรายงานล่าสุด คู่มือนักพัฒนาซอฟต์แวร์ และคู่มือการย้ายข้อมูล โดยจะแปลงคำค้นหาเป็นโครงสร้างใหม่และอัปเดตช่องเป็นชื่อและค่าใหม่ตามข้อมูลนี้

ทักษะของตัวแทน Merchant API

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

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

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

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

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

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

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

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

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

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

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

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

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

"ฉันจะแทรกผลิตภัณฑ์โดยใช้ Merchant API ใน Python ได้อย่างไร"

"วิธีการของ Content API accountstatuses.get เทียบเท่ากับ Merchant API คืออะไร"

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

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

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

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

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