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