Toolkit Integrasi API dan Code Assist menggunakan MCP

Dapatkan kecerdasan kontekstual tentang Merchant API dari asisten coding pilihan Anda. Dalam Integrated Development Environment (IDE), Anda kini dapat mengakses integrasi dokumentasi developer menggunakan layanan Model Context Protocol (MCP). Layanan ini mempercepat pengembangan alur kerja integrasi dan migrasi Anda dengan memberikan konteks resmi dari dokumentasi Google API resmi kepada asisten coding Anda.

Untuk mengetahui informasi selengkapnya tentang protokol itu sendiri, lihat standar Model Context Protocol.

Ringkasan

Saat bermigrasi dari Content API for Shopping ke Merchant API atau membuat integrasi baru, Anda perlu memahami struktur layanan, nama resource, dan metode baru. Layanan MCP menyederhanakan hal ini dengan menyediakan dokumentasi resmi dan contoh kode kepada asisten coding Anda.

Layanan ini menggunakan backend Retrieval-Augmented Generation (RAG) yang sangat khusus. Saat Anda mengajukan pertanyaan tentang Merchant API kepada asisten coding IDE yang mendukung MCP, layanan akan mengambil cuplikan teks dan kode yang paling relevan dari referensi resmi Google dan menampilkannya sebagai konteks kepada asisten coding Anda. Hal ini memungkinkan asisten Anda memberikan jawaban yang akurat dan terbaru tanpa Anda harus keluar dari lingkungan pengembangan.

Cara kerjanya

Integrasi dokumentasi developer menggunakan MCP terintegrasi ke dalam alur kerja pengembangan modern yang dibantu AI:

  1. Anda mengajukan pertanyaan di asisten atau Agen pengodean yang kompatibel dengan MCP. Ini dapat berupa pertanyaan dalam bahasa alami atau permintaan contoh kode untuk penerapan metode Merchant API.
  2. Asisten coding Anda mengirimkan permintaan konteks ke endpoint MCP.
  3. Layanan MCP menelusuri kumpulan dokumentasi, panduan, dan contoh kode Merchant API resmi yang diindeksnya untuk menemukan informasi yang paling relevan.
  4. Layanan ini menampilkan cuplikan resmi ini sebagai konteks untuk asisten pengodean Anda.
  5. Asisten coding Anda menggunakan konteks berkualitas tinggi ini untuk menghasilkan jawaban yang tepat dan bermanfaat atas pertanyaan awal Anda.

Memulai

Untuk menggunakan MCP, Anda memerlukan IDE atau asisten coding yang mendukung Model Context Protocol dengan transportasi HTTP yang dapat di-streaming.

Konfigurasi endpoint

Untuk menghubungkan alat Anda ke layanan, gunakan detail endpoint jarak jauh yang disediakan, yang mungkin mengharuskan Anda memasukkan URL layanan langsung atau definisi MCP, bergantung pada konfigurasi alat Anda.

URL layanan adalah:

MCP Server Name: "MAPI Docs MCP"
MCP Server URL:  "https://merchantapi.googleapis.com/devdocs/mcp/"

Contoh skenario penggunaan

MCP dapat mempercepat alur kerja Anda dalam kasus penggunaan umum berikut.

Skenario 1: Memigrasikan panggilan API lama

Anda memiliki aplikasi yang sudah ada menggunakan Content API for Shopping dan perlu mengupdatenya. Anda dapat menanyakan metode lama tertentu untuk mendapatkan detail tentang penerapan baru dan contoh kode yang relevan.

Perintah pengguna:

"Apa padanan Merchant API untuk metode accountstatuses.get di Content API for Shopping?"

Layanan MCP memberikan konteks dari panduan migrasi resmi dan dokumentasi referensi, sehingga asisten Anda dapat merespons dengan jawaban mendetail, termasuk nama API baru, accounts.issues.

Skenario 2: Menemukan contoh kode

Anda menerapkan fitur baru dan memerlukan contoh praktis untuk diikuti.

Perintah pengguna:

"Tampilkan contoh kode Python untuk menambahkan layanan pengiriman baru menggunakan Merchant API."

Layanan MCP mengambil contoh kode yang relevan dari repositori dan panduan developer Google GitHub resmi. Kemudian, asisten Anda dapat menyajikan blok kode yang lengkap dan siap disesuaikan.

Skenario 3: Memahami konsep API

Anda menemukan konsep baru atau ingin memahami struktur resource atau pola Merchant API secara keseluruhan.

Perintah pengguna:

"Bagaimana cara memperbarui inventaris produk menggunakan Merchant API?"

Layanan MCP menampilkan konteks dari dokumentasi resource produk dan panduan yang relevan. Kemudian, asisten Anda dapat menjelaskan cara menggunakan metode accounts.productInputs.insert dan memberikan resource produk parsial yang hanya berisi productId dan kolom terkait inventaris yang perlu Anda perbarui.

"Bagaimana cara mengizinkan panggilan aplikasi saya dengan Merchant API?"

Layanan MCP mengambil konteks dari panduan autentikasi resmi, yang mencakup berbagai metode otorisasi. Kemudian, asisten Anda dapat menjelaskan opsi utama yang tersedia, seperti menggunakan akun layanan untuk interaksi server ke server atau ID klien OAuth 2.0 saat bertindak atas nama pengguna.

Skenario 4: Menyesuaikan dengan perubahan API

Merchant API memperkenalkan pola baru — seperti permintaan batch — yang berbeda dari Content API for Shopping. Content API for Shopping menggunakan metode custombatch tertentu, sedangkan Merchant API menggunakan fitur batching HTTP generik bawaan.

Perintah pengguna:

"Apa cara baru untuk melakukan products.custombatch di Merchant API?"

Layanan MCP mengambil konteks dari Refactor code for concurrent requests yang menjelaskan bahwa metode custombatch khusus tidak ada di Merchant API. Sebagai gantinya, dokumen ini memberikan dokumentasi tentang penggunaan batch HTTP dengan Content-Type multipart. Kemudian, asisten Anda dapat menjelaskan cara membuat satu permintaan HTTP yang berisi beberapa panggilan API, yang dikirim ke endpoint https://merchantapi.googleapis.com/batch/{sub-api}/v1, dan memberikan contoh cara menyusun permintaan multipart. Hal ini mengubah tugas migrasi yang berpotensi membingungkan menjadi proses terpandu.

Sumber pusat informasi

Layanan MCP membangun pusat informasinya secara eksklusif dari sumber publik dan resmi untuk memastikan konteks yang diberikannya akurat dan andal. Layanan ini mengindeks seluruh konten situs developer resmi dan repositori contoh kode, termasuk:

Sebelumnya
Quickstart
Berikutnya
Overview