การผสานรวม 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

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

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

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

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

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

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

เมื่อคุณถามคำถามเกี่ยวกับ 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. เพิ่มคำสั่งสำหรับตัวแทน (ไม่บังคับ)

หากต้องการให้เอเจนต์แปลโค้ดโดยตรงโดยใช้ 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 และให้ความช่วยเหลือจากผู้เชี่ยวชาญแบบออนดีมานด์สำหรับการค้นหาเอกสารประกอบ การสร้างโค้ด และการแก้ปัญหา

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

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

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

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

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

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

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

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