ใช้ชุดเครื่องมือการผสานรวม 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 ที่พบบ่อย
เลือกตัวเลือกที่เหมาะกับสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และกรณีการใช้งานเฉพาะของคุณมากที่สุด ใช้ชุดเครื่องมือการผสานรวม API และการช่วยเขียนโค้ดเพื่อปรับแต่งการตั้งค่าให้เหมาะกับเวิร์กโฟลว์ที่คุณต้องการ ดังนี้
- เซิร์ฟเวอร์ MCP ในเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ Merchant API สำหรับการดึงบริบทโดยตรง
- ทักษะของตัวแทน Merchant API สำหรับคำแนะนำที่ขับเคลื่อนด้วยเวิร์กโฟลว์
แผนภาพต่อไปนี้แสดงตัวเลือกการตั้งค่าสำหรับการย้ายข้อมูลโค้ดที่ AI ช่วย ในสภาพแวดล้อมในการพัฒนาซอฟต์แวร์แบบผสานรวม (IDE) ที่ใช้กันโดยทั่วไป เช่น Antigravity, Visual Studio Code, Cursor หรือ Copilot คุณสามารถตั้งค่าผู้ช่วยการเขียนโค้ด เช่น Gemini, Claude, ChatGPT, Grok และเพิ่มประสิทธิภาพด้วยเซิร์ฟเวอร์ MCP ของเอกสารประกอบสำหรับนักพัฒนา Merchant API หรือทักษะของเอเจนต์ Merchant API เพื่อให้มีความแม่นยำมากขึ้นพร้อมทั้งเพิ่มความเร็วในการผสานรวม
เอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ 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 โดยเชื่อมต่อกับ แหล่งความรู้ภายนอกที่เป็นข้อมูลล่าสุด ซึ่งจะช่วยให้ผู้ช่วยของคุณให้คำตอบที่ถูกต้องและเป็นปัจจุบันได้โดยที่คุณไม่ต้องออกจากสภาพแวดล้อมการพัฒนา
เวิร์กโฟลว์ตัวอย่าง
- คุณถามคำถามในผู้ช่วยการเขียนโค้ดหรือ Agent ที่เข้ากันได้กับ MCP (เช่น คำถามภาษาธรรมชาติ คำขอตัวอย่างโค้ด หรือการแปลงโค้ด)
- ผู้ช่วยเขียนโค้ดจะส่งคำขอรับบริบทไปยังปลายทาง MCP
- บริการ MCP จะค้นหาคอลเล็กชันที่จัดทำดัชนีของเอกสารประกอบ คำแนะนำ และตัวอย่างโค้ดอย่างเป็นทางการของ Merchant API
- บริการจะแสดงข้อมูลโค้ดที่เชื่อถือได้เป็นบริบทให้กับผู้ช่วยการเขียนโค้ด ของคุณ
- ผู้ช่วยเขียนโค้ดจะใช้ประโยชน์จากบริบทนี้เพื่อสร้างคำตอบที่อิงตามข้อมูลที่มี หรือสร้างงานแปลโค้ด
เริ่มต้นใช้งาน
หากต้องการผสานรวมและใช้ 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 จะดึงตัวอย่างโค้ดที่เกี่ยวข้องจากที่เก็บ GitHub อย่างเป็นทางการของ Google และคำแนะนำสำหรับนักพัฒนาแอป จากนั้น Assistant จะแสดงโค้ดบล็อกที่สมบูรณ์ พร้อมปรับใช้
สถานการณ์ที่ 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
ข้อกำหนดทักษะของเอเจนต์เป็นมาตรฐานแบบเปิด ที่ใช้ในเครื่องมือพัฒนา AI ใช้ทักษะของเอเจนต์เพื่อปรับปรุงประสบการณ์การใช้งานของนักพัฒนาซอฟต์แวร์และเพิ่มประสิทธิภาพทั้ง 2 อย่าง โดยการย้ายข้อมูลจาก Content API for Shopping และสร้างการผสานรวมใหม่ แพ็กเกจทักษะ Agent ของ Merchant API ความรู้และเครื่องมือเฉพาะโดเมนเพื่อเพิ่มความสามารถของ AI Agent และ ให้ความช่วยเหลือจากผู้เชี่ยวชาญแบบออนดีมานด์สำหรับการค้นหาเอกสารประกอบ การสร้างโค้ด และการแก้ปัญหา
ทักษะตัวแทน Merchant API ใช้ได้กับเครื่องมือบรรทัดคำสั่งและ IDE ต่างๆ ที่ทำงานด้วยระบบ AI เช่น Antigravity และ Claude Code
วิธีการทำงาน
ทักษะของ Merchant API Agent มีแพ็กเกจความเชี่ยวชาญเฉพาะทางที่สร้างขึ้นตามมาตรฐานทักษะของ Agent แบบเปิด ทักษะของเอเจนต์mapi-developer-assistantทำหน้าที่เป็น
เลเยอร์อัจฉริยะระหว่างเครื่องมือพัฒนา AI กับ
เซิร์ฟเวอร์ MCP ของเอกสารสำหรับนักพัฒนา Merchant API ที่อยู่เบื้องหลัง โดยจะฝังความเชี่ยวชาญด้านโดเมนและคำแนะนำเชิงกระบวนการ ซึ่งมีคุณสมบัติดังนี้
- การกำหนดค่าเป็นศูนย์: จัดการการเชื่อมต่อเซิร์ฟเวอร์ MCP โดยอัตโนมัติ จึงไม่จำเป็นต้องตั้งค่าปลายทางด้วยตนเอง
- เวิร์กโฟลว์ของผู้เชี่ยวชาญ: ปรับพรอมต์ของผู้ใช้ให้เป็นคำค้นหาที่เพิ่มประสิทธิภาพเพื่อดึงข้อมูลที่เกี่ยวข้องที่สุดอย่างมีประสิทธิภาพ
- การจัดการบริบทและประสิทธิภาพของโทเค็น: ใช้ "การเปิดเผยแบบก้าวหน้า" เพื่อ โหลดข้อมูลตามต้องการและรักษาหน้าต่างบริบทของ AI
- การจัดรูปแบบเอาต์พุตที่ได้รับการปรับปรุง: ให้วิธีการจัดรูปแบบและจัดโครงสร้าง เอาต์พุตเพื่อให้ได้คำตอบที่นำไปใช้ได้จริง อ่านได้ และสอดคล้องกัน
เวิร์กโฟลว์ตัวอย่าง:
- คุณถามคำถามเกี่ยวกับ Merchant API ในเครื่องมือพัฒนา AI
- ทักษะตัวแทน Merchant API จะวิเคราะห์ความตั้งใจของคุณ สร้างคำค้นหาที่แม่นยำ และใช้ความรู้เชิงกระบวนการกับคำขอ
- Agent Skill จะส่งคำขอเพื่อขอข้อมูลบริบทไปยัง Merchant API Dev Doc MCP
Server ที่
merchantapi.googleapis.com/devdocs/mcp/ - บริการ MCP จะค้นหาคอลเล็กชันที่จัดทำดัชนีของเอกสารประกอบ คำแนะนำ และตัวอย่างโค้ดอย่างเป็นทางการของ Merchant API
- AI Agent จะใช้ประโยชน์จากข้อมูลนี้เพื่อสร้างคำตอบที่สังเคราะห์และนำไปใช้ได้
เริ่มต้นใช้งาน
README ของทักษะตัวแทน Merchant API จะให้คำแนะนำแบบทีละขั้นตอนเกี่ยวกับสิ่งต่อไปนี้
- ข้อกำหนดเบื้องต้นสำหรับเครื่องมือต่างๆ เช่น เครื่องมือบรรทัดคำสั่ง Antigravity
- เปิดใช้การรองรับทักษะของ Agent ในเครื่องมือที่คุณเลือก
- การติดตั้งทักษะ
mapi-developer-assistantจากที่เก็บ GitHub ตามที่ระบุไว้ใน README - กำลังยืนยันการติดตั้ง
- คำสั่งการจัดการทักษะพื้นฐาน
ดูวิธีการติดตั้งและตั้งค่าเครื่องมือ AI ต่างๆ โดยละเอียด รวมถึงเครื่องมือบรรทัดคำสั่ง Antigravity, 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 สร้างฐานความรู้จากแหล่งข้อมูลสาธารณะและแหล่งข้อมูลอย่างเป็นทางการเท่านั้น เพื่อให้มั่นใจว่าบริบทที่ให้บริการนั้นถูกต้องและเชื่อถือได้ บริการจะจัดทำดัชนีเนื้อหาทั้งหมดของเว็บไซต์นักพัฒนาซอฟต์แวร์อย่างเป็นทางการและที่เก็บตัวอย่างโค้ด ซึ่งรวมถึง
- เว็บไซต์นักพัฒนา Merchant API: คำแนะนำ เอกสารอ้างอิง และเอกสารประกอบทั้งหมด
- บริการ Apps Script ของ Merchant API: ตัวอย่างการใช้งาน Merchant API จาก Apps Script
- ตัวอย่างโค้ดอย่างเป็นทางการ: ตัวอย่างโค้ดอย่างเป็นทางการทั้งหมดที่ Google จัดเตรียมไว้ให้สำหรับ Merchant API จากที่เก็บ GitHub
- ไลบรารีของไคลเอ็นต์: ไลบรารีของไคลเอ็นต์อย่างเป็นทางการทั้งหมดที่รองรับโดย Merchant API