การผสานรวม 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 หรือทักษะของ Agent Merchant API เพื่อให้มีความแม่นยำมากขึ้นพร้อมกับเพิ่มความเร็วในการผสานรวม

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

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

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

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

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

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

คุณสามารถขอให้ Agent ย้ายข้อมูลโค้ดการผสานรวม products.insert ของ Content API for Shopping ไปยัง 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 จะดึงข้อมูลบริบทจาก Refactor code for concurrent requests ซึ่งอธิบายว่าไม่มีเมธอด custombatch เฉพาะใน Merchant API แต่จะระบุเอกสารประกอบเกี่ยวกับการใช้การจัดกลุ่ม HTTP ที่มี Content-Type เป็น multipart แทน จากนั้นผู้ช่วยจะอธิบายวิธีสร้างคำขอ HTTP รายการเดียวที่มีการเรียก API หลายรายการ ซึ่งส่งไปยังปลายทาง https://merchantapi.googleapis.com/batch/{sub-api}/v1 และระบุตัวอย่างวิธีจัดโครงสร้างคำขอ multipart ซึ่งจะเปลี่ยนงานการย้ายข้อมูลที่อาจทำให้สับสนให้เป็นกระบวนการที่มีคำแนะนำ

สถานการณ์ที่ 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 และการสร้างการผสานรวมใหม่ แพ็กเกจทักษะของ Agent Merchant API จะรวบรวมความรู้และเครื่องมือเฉพาะโดเมนเพื่อเพิ่มขีดความสามารถของ Agent 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. Agent AI จะใช้ข้อมูลนี้เพื่อสร้างคำตอบที่สังเคราะห์และนำไปปฏิบัติได้

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

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