Integrasi API dan Toolkit Code Assist

Gunakan API Integration dan Code Assist Toolkit untuk mempercepat migrasi Anda ke Merchant API dan membangun integrasi baru dengan alat developer yang didukung AI.

Ringkasan

Saat bermigrasi dari Content API for Shopping ke Merchant API atau membangun integrasi baru, Anda perlu memahami struktur layanan, nama resource, dan metode baru. Alat developer yang didukung AI sangat cocok untuk membantu operasi berikut:

  • Penerjemahan dan migrasi kode: Membantu Anda memahami dan mengonversi kode Content API for Shopping lama ke format Merchant API yang baru. Hal ini termasuk memetakan atribut produk ke struktur baru dan memperbarui file pengelolaan dependensi.
  • Keahlian dokumentasi API: Memberikan penjelasan yang jelas tentang resource, metode, kolom, kuota, dan praktik terbaik Merchant API berdasarkan konteks yang kredibel dari dokumentasi resmi Google API.
  • Pembuatan kode: Membuat cuplikan kode untuk berbagai tugas Merchant API dalam bahasa termasuk Python, Java, PHP, dan bahasa lainnya.
  • Pemecahan masalah: Membantu mendiagnosis dan memperbaiki error API umum.

Pilih opsi yang paling sesuai dengan lingkungan pengembangan dan kasus penggunaan spesifik Anda. Gunakan API Integration and Code Assist Toolkit untuk menyesuaikan penyiapan dengan alur kerja pilihan Anda:

Diagram berikut mengilustrasikan opsi penyiapan untuk migrasi kode yang dibantu AI di seluruh Lingkungan Pengembangan Terintegrasi (IDE) yang paling umum digunakan seperti Antigravity, Visual Studio Code, Cursor, atau Copilot. Anda dapat menyiapkan asisten coding seperti Gemini, Claude, ChatGPT, Grok, dan memberdayakannya dengan server MCP Dokumentasi Developer Merchant API atau Merchant API Agent Skills agar lebih akurat sekaligus meningkatkan kecepatan integrasi.

Diagram Code Assist Integrasi AI (Merchant API)

Server MCP Dokumentasi Developer Merchant API

Dapatkan kecerdasan kontekstual tentang Merchant API dari asisten coding pilihan Anda. Dalam IDE, Anda kini dapat mengakses dokumentasi developer menggunakan layanan Model Context Protocol (MCP). Layanan ini memberikan informasi penting kepada asisten coding Anda dari dokumentasi Google API resmi. Untuk mengetahui informasi selengkapnya tentang protokol itu sendiri, lihat standar Model Context Protocol.

Cara kerjanya

Saat Anda mengajukan pertanyaan tentang Merchant API kepada asisten coding IDE yang mendukung MCP, layanan ini akan mengambil cuplikan teks dan kode yang paling relevan dari referensi resmi dan menampilkannya sebagai konteks ke asisten coding Anda menggunakan backend Retrieval-Augmented Generation (RAG) khusus. Sistem RAG adalah sistem yang meningkatkan kualitas respons dari LLM dengan menghubungkannya ke sumber pengetahuan eksternal yang terbaru. Hal ini memungkinkan asisten Anda memberikan jawaban yang akurat dan terbaru tanpa Anda harus keluar dari lingkungan pengembangan.

Contoh alur kerja:

  1. Anda mengajukan pertanyaan di Agen atau asisten coding yang kompatibel dengan MCP (misalnya, pertanyaan bahasa alami, permintaan contoh kode, atau terjemahan kode).
  2. Asisten coding Anda mengirimkan permintaan konteks ke endpoint MCP.
  3. Layanan MCP menelusuri koleksi dokumentasi, panduan, dan contoh kode Merchant API resmi yang diindeks.
  4. Layanan ini menampilkan cuplikan yang kredibel sebagai konteks untuk asisten coding Anda.
  5. Asisten coding Anda memanfaatkan konteks ini untuk menghasilkan jawaban yang di-grounding atau tugas penerjemahan kode.

Memulai

Untuk mengintegrasikan dan menggunakan MCP, ikuti langkah-langkah berikut:

1. Menggunakan alat yang kompatibel

Buka IDE atau bantuan coding yang mendukung Model Context Protocol dengan transportasi HTTP yang dapat di-streaming.

2. Mengonfigurasi endpoint

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

Penyiapan konfigurasi:

Antigravity

Ikuti petunjuk dalam dokumentasi Antigravity.

"mcpServers": {
  "mapi-devdocs": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://merchantapi.googleapis.com/devdocs/mcp"
    ]
  }
}

Visual Studio Code

Ikuti petunjuk dalam dokumentasi Visual Studio Code.

"servers": {
"mapi-devdocs": {
  "type": "http",
  "url": "https://merchantapi.googleapis.com/devdocs/mcp/"
  }
}

3. Menambahkan petunjuk agen (opsional)

Agar agen Anda dapat langsung menerjemahkan kode menggunakan MCP, berikan System Instructions: Merchant Integrator Agent Protocol. Petunjuk ini memandu agen tentang cara menggunakan MCP dengan benar untuk penerjemahan kode. Bergantung pada alat Anda, Anda dapat memberikan petunjuk ini dalam konfigurasi petunjuk sistem atau sebagai file konteks tambahan untuk agen.

Contoh skenario penggunaan

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

Skenario 1: Memigrasikan kode products.insert

Anda dapat meminta agen untuk langsung memigrasikan kode integrasi Content API for Shopping products.insert ke Merchant API.

Perintah pengguna:

"Migrate products.insert code to Merchant API"

Dengan memberikan petunjuk sistem dan akses ke MCP kepada agen, agen Anda dapat menerjemahkan kode Content API for Shopping ke kode Merchant API langsung di IDE Anda. Dalam hal ini, Merchant API akan mengidentifikasi productInputs.insert sebagai panggilan yang setara dan memetakan atribut produk dari format lama ke format baru yang diperlukan oleh Merchant API. Agen ini juga dapat memperbarui impor yang diperlukan dan file pengelolaan dependensi (misalnya requirements.txt, pom.xml, atau package.json). Anda dapat menginstruksikan agen untuk melakukan perubahan di tempat atau membuat folder baru.

Skenario 2: Menemukan fungsi yang setara

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

Perintah pengguna:

"Apa Merchant API yang setara dengan 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 3: Menemukan contoh kode

Anda sedang menerapkan fitur baru dan memerlukan contoh praktis untuk diikuti.

Perintah pengguna:

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

Layanan MCP mengambil contoh kode yang relevan dari repositori GitHub Google resmi dan panduan developer. Asisten Anda kemudian dapat menampilkan blok kode yang lengkap dan siap diadaptasi.

Skenario 4: Memahami konsep API

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

Perintah pengguna:

"Bagaimana cara memperbarui inventaris untuk produk menggunakan Merchant API?"

Layanan MCP menampilkan konteks dari dokumentasi resource produk dan panduan yang relevan. Asisten Anda kemudian dapat menjelaskan cara menggunakan metode accounts.productInputs.insert dan menyediakan 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. Asisten Anda kemudian dapat menjelaskan opsi utama yang tersedia, seperti menggunakan akun layanan untuk interaksi server ke server atau client ID OAuth 2.0 saat bertindak atas nama pengguna.

Skenario 5: Beradaptasi 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 pengelompokan HTTP generik bawaan.

Perintah pengguna:

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

Layanan MCP mengambil konteks dari Refactor code for permintaan serentak yang menjelaskan bahwa metode custombatch khusus tidak ada di Merchant API. Sebagai gantinya, dokumentasi ini memberikan dokumentasi tentang penggunaan pengelompokan HTTP dengan Content-Type dari multipart. Asisten Anda kemudian 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 multibagian. Hal ini mengubah tugas migrasi yang berpotensi membingungkan menjadi proses yang dipandu.

Skenario 6: Menerjemahkan kueri pelaporan

Anda dapat meminta agen untuk menerjemahkan kueri pelaporan dari Content API for Shopping ke Merchant API.

Perintah pengguna:

"Migrasikan kueri pelaporan ini dari Content API ke Merchant API: SELECT metrics.impressions, metrics.clicks, metrics.ctr FROM MerchantPerformanceView WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'"

Layanan MCP mengambil dokumentasi referensi pelaporan, panduan developer, dan panduan migrasi terbaru. Berdasarkan informasi ini, Gemini akan mengubah kueri ke struktur baru dan memperbarui kolom ke nama dan nilai barunya.

Keahlian Agen Merchant API

Spesifikasi Agent Skills adalah standar terbuka yang diadopsi di berbagai alat pengembangan AI. Gunakan Agent Skills untuk meningkatkan pengalaman developer dan mengoptimalkan migrasi dari Content API for Shopping dan membangun integrasi baru. Merchant API Agent Skills mengemas pengetahuan dan alat khusus domain untuk meningkatkan kemampuan agen AI dan memberikan bantuan ahli on-demand untuk kueri dokumentasi, pembuatan kode, dan pemecahan masalah.

Merchant API Agent Skills kompatibel dengan berbagai alat command line dan IDE yang didukung AI seperti Antigravity dan Claude Code.

Cara kerjanya

Merchant API Agent Skills menyediakan paket keahlian khusus yang dibangun berdasarkan standar Agent Skills terbuka. Kemampuan agen kami, mapi-developer-assistant, bertindak sebagai lapisan cerdas antara alat developer AI Anda dan Server MCP Dokumen Developer Merchant API yang mendasarinya. Model ini menyematkan keahlian domain dan panduan prosedural, dengan properti berikut:

  • Konfigurasi Nol: Mengelola koneksi Server MCP secara otomatis, sehingga tidak perlu menyiapkan endpoint secara manual.
  • Alur Kerja Pakar: Menyempurnakan perintah pengguna menjadi kueri yang dioptimalkan untuk mengambil informasi yang paling relevan secara efektif.
  • Pengelolaan Konteks & Efisiensi Token: Menggunakan "Pengungkapan Progresif" untuk memuat informasi sesuai permintaan dan mempertahankan jendela konteks AI.
  • Pemformatan Output yang Ditingkatkan: Memberikan petunjuk untuk memformat dan menyusun output agar menghasilkan respons yang dapat ditindaklanjuti, mudah dibaca, dan konsisten.

Contoh alur kerja:

  1. Anda mengajukan pertanyaan tentang Merchant API di alat developer AI.
  2. Merchant API Agent Skill menganalisis niat Anda, merumuskan kueri yang tepat, dan menerapkan pengetahuan proseduralnya ke permintaan tersebut.
  3. Keterampilan Agen mengirimkan permintaan konteks ke Server MCP Dokumen Developer Merchant API yang berada di merchantapi.googleapis.com/devdocs/mcp/.
  4. Layanan MCP menelusuri koleksi dokumentasi, panduan, dan contoh kode Merchant API resmi yang diindeks.
  5. Agen AI Anda memanfaatkan informasi ini untuk memberikan respons yang disintesis dan dapat ditindaklanjuti.

Memulai

README Kemampuan Agen Merchant API memberikan panduan langkah demi langkah tentang:

  • Prasyarat untuk alat seperti alat command line Antigravity.
  • Mengaktifkan dukungan Kemampuan Agen di alat yang Anda pilih.
  • Menginstal skill mapi-developer-assistant dari repositori GitHub seperti yang dipandu oleh README.
  • Memverifikasi penginstalan.
  • Perintah pengelolaan skill dasar.

Untuk mengetahui petunjuk penginstalan dan penyiapan mendetail untuk berbagai alat AI, termasuk alat command line Antigravity, Claude Code, dan lainnya, ikuti panduan dari file README.

Contoh perintah

Setelah diinstal dan diaktifkan di alat developer AI, keahlian mapi-developer-assistant biasanya akan otomatis diaktifkan saat Anda mengajukan pertanyaan terkait Merchant API.

"Bagaimana cara menyisipkan produk menggunakan Merchant API di Python?"

"Apa Merchant API yang setara dengan metode accountstatuses.get Content API?"

"Tunjukkan contoh Java untuk menangani autentikasi dengan Merchant API."

"Saya mendapatkan '400 Bad Request' dengan error validasi saat memanggil productInputs.insert. Bagaimana cara memperbaikinya?"

"Apa perbedaan antara ProductInput dan Product di Merchant API?"

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: