Layanan Akses MCP Merchant API (Alfa)

Gunakan Layanan Akses Model Context Protocol (MCP) Merchant API untuk mendapatkan akses resmi ke data dan insight Merchant Center Anda guna membangun pengalaman agentic dan alur kerja otomatis baru.

Ringkasan

Layanan Akses MCP Merchant API menyediakan jembatan standar dan aman untuk LLM, agen, dan asisten coding guna membangun dan mengatur pengalaman agentic dan alur kerja otomatis baru berdasarkan data Merchant Center.

Secara khusus, layanan ini memungkinkan akses resmi ke data Merchant Center Anda serta laporan dan insight yang dibuat Google untuk melakukan operasi baca saja dan tulis terbatas guna menangani kasus penggunaan seperti:

  • Mendiagnosis dan memperbaiki penolakan produk
  • Membuat laporan dan insight performa
  • Meninjau pilihan untuk penyempurnaan otomatis
  • Membuat dan mengambil sumber data

Kontrol keamanan dan akses

Layanan Akses MCP Merchant API dirancang dengan mengutamakan keamanan:

  • Autentikasi: Eksekusi alat diatur oleh autentikasi Merchant API standar, yang memerlukan OAuth 2.0 atau kredensial akun layanan. Sebaiknya gunakan kredensial dengan hak akses paling ketat.
  • Keamanan Eksekusi: Meskipun visibilitas alat tidak dibatasi untuk penemuan agentic, eksekusi alat dibatasi untuk kredensial API tertentu.
  • Pengamanan: Alat dibatasi secara ketat untuk operasi baca saja dan alat tulis berisiko rendah (misalnya, pembuatan sumber data) sebagai pengamanan.

Pertimbangan penting

Layanan Akses MCP Merchant API adalah versi alfa; cakupan dan kemampuannya akan diperluas dan dapat berubah.

Sebelum memulai, tinjau batasan dan praktik terbaik berikut:

Perubahan dan rilis

Perubahan dapat terjadi tanpa pemberitahuan sebelumnya dan akan dipublikasikan dalam catatan rilis.

Pengujian yang aman

Sebaiknya lakukan eksperimen terlebih dahulu menggunakan a akun pengujian atau akun non-aktif sebelum menggunakan alat ini di lingkungan produksi aktif.

Kuota bersama

Layanan Akses MCP Merchant API menggunakan kumpulan kuota yang sama dengan panggilan Merchant API standar Anda. Agen yang berjalan dapat dengan cepat menghabiskan kuota, terutama untuk pengambilan sumber data. Sebaiknya gunakan akun pengujian untuk mencegah gangguan layanan produksi.

Pemfilteran dan keamanan alat

Kemampuan baru, terutama tindakan tulis, akan ditambahkan di masa mendatang. Sebaiknya konfigurasi klien Anda secara eksplisit untuk pemfilteran alat bawaan, bukan mengekspos seluruh kumpulan alat.

Ringkasan kemampuan yang tersedia

Anda dapat menggunakan Layanan Akses MCP Merchant API untuk melakukan tindakan berikut dengan cara agentic:

  • Mengambil konteks status dan pelaporan mendetail untuk produk tertentu menggunakan nama resource yang tepat.
  • Mencantumkan dan menelusuri beberapa produk.
  • Membuat kueri metrik performa, status produk, dan insight tentang produk populer, insight harga, visibilitas kompetitif, dan analisis Afiliasi YouTube Shopping.
  • Mengidentifikasi masalah tingkat akun yang memengaruhi visibilitas produk atau partisipasi program.
  • Mencantumkan, membuat, mengambil, dan memeriksa status upload sumber data.
  • Mencantumkan alasan gabungan untuk penolakan produk di seluruh inventaris Anda.
  • Meninjau setelan penyempurnaan otomatis untuk item, gambar, dan pengiriman.
  • Memeriksa wilayah aktif, persyaratan yang belum terpenuhi, dan status partisipasi untuk program Merchant Center tertentu.

Memulai

Untuk menghubungkan IDE, asisten coding, atau agen Anda ke Layanan Akses MCP Merchant API, perbarui setelan klien MCP Anda. Misalnya, perbarui file mcp.json untuk Google Agent Studio, Claude Desktop, Antigravity, Visual Studio Code, atau framework agen kustom Anda.

Penyiapan Layanan Akses MCP Merchant API lokal memerlukan akun layanan. Pengguna standar OAuth tidak didukung untuk eksekusi lokal tanpa UI ini. Anda harus membuat akun layanan, mendownload file kunci pribadi JSON-nya, dan memberikan jalur ke file tersebut beserta ID Merchant Center spesifik Anda sebagai argumen.

Untuk mengetahui petunjuk mendetail tentang cara membuat dan mendownload akun layanan, lihat panduan Akun Layanan.

Konfigurasi klien

Penyiapan konfigurasi:

Antigravity

Ikuti petunjuk dalam dokumentasi Antigravity.

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Claude Desktop

Ikuti petunjuk dalam dokumentasi Claude Desktop.

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Contoh skenario penggunaan

Untuk mengilustrasikan cara memanfaatkan Layanan Akses MCP Merchant API untuk membangun pengalaman agentic dan alur kerja otomatis, pertimbangkan skenario berikut:

Skenario 1: Mendiagnosis dan memperbaiki penolakan produk

Anda ingin memahami alasan produk tertentu tidak muncul di hasil Google Penelusuran.

Perintah pengguna:

"Mengapa produk saya dengan ID penawaran 'offer123' tidak disetujui?"

Perilaku agen dengan MCP:

  1. Agen memanggil list_products atau get_product_by_name untuk menemukan status produk.
  2. Server MCP menampilkan status produk, termasuk daftar issues (misalnya, "Format harga salah" atau "Nilai pengiriman tidak ada").
  3. Agen menganalisis masalah dan menjelaskan penyebab utamanya kepada Anda, serta menyarankan cara memperbaikinya (misalnya, memperbarui informasi harga).

Skenario 2: Meninjau pilihan untuk penyempurnaan otomatis

Anda ingin memverifikasi apakah penyempurnaan pengiriman otomatis Anda aktif.

Perintah pengguna:

"Apakah penyempurnaan pengiriman otomatis saya diaktifkan?"

Perilaku agen dengan MCP:

  1. Agen memanggil get_automatic_improvements untuk mengambil setelan tingkat akun.
  2. Server MCP menampilkan konfigurasi yang menunjukkan status penyempurnaan gambar, item, dan pengiriman.
  3. Agen mengonfirmasi bahwa penyempurnaan pengiriman aktif, atau menjelaskan cara mengaktifkannya jika dinonaktifkan.

Skenario 3: Membuat laporan dan insight performa

Anda ingin memeriksa performa terbaru dengan cepat tanpa membuka UI Merchant Center.

Perintah pengguna:

"Tampilkan 5 produk saya yang berperforma terbaik berdasarkan klik minggu lalu."

Perilaku agen dengan MCP:

  1. Agen membuat kueri Merchant Center Query Language (MCQL) yang menargetkan tabel product_performance_view, mengurutkan berdasarkan clicks DESC, dan membatasi hingga 5.
  2. Agen memanggil report_search dengan kueri yang dibuat.
  3. Server MCP menjalankan kueri terhadap database pelaporan aktif dan menampilkan baris.
  4. Agen memformat hasil ke dalam tabel Markdown yang bersih untuk Anda.

Skenario 4: Membuat dan mengambil sumber data

Anda ingin menambahkan sumber data baru untuk mengupload update produk.

Perintah pengguna:

"Buat sumber data tambahan bernama 'price-updates' untuk akun penjual saya."

Perilaku agen dengan MCP:

  1. Agen memanggil create_data_source dengan setelan yang ditentukan untuk mendaftarkan feed baru.
  2. Server MCP membuat sumber data dan menampilkan nama resource uniknya.
  3. Agen memanggil fetch_data_source untuk memicu download dan pemrosesan file terkait.
  4. Agen memanggil get_file_upload untuk memantau progres upload dan mengonfirmasi status pemrosesan item yang berhasil.

Alat dan deskripsi MCP

Layanan Akses MCP Merchant API mengekspos alat berikut ke agen Anda:

Alat MCP Deskripsi
get_product_by_name Mendapatkan info produk untuk penjual tertentu menggunakan nama resource produk yang tepat. Menampilkan status produk mendetail yang berisi konteks pelaporan dan potensi masalah tingkat produk.
list_products Mencantumkan atau menelusuri beberapa produk untuk penjual tertentu. Menampilkan status produk mendetail yang berisi konteks pelaporan dan potensi masalah tingkat produk untuk beberapa produk.
report_search Membuat kueri tabel pelaporan untuk mengambil metrik performa produk, status produk, analisis harga, dan visibilitas kompetitif. Lihat panduan Laporan untuk mengetahui detailnya.
list_data_sources Mencantumkan sumber data yang tersedia untuk penjual tertentu.
get_data_source Mendapatkan detail sumber data tertentu.
create_data_source Membuat sumber data baru untuk penjual tertentu.
fetch_data_source Mengambil dan memproses file yang terkait dengan sumber data untuk penjual tertentu.
get_file_upload Mendapatkan status upload file terbaru untuk sumber data tertentu.
list_accounts Mencantumkan akun untuk pengguna tertentu.
list_account_issues Mencantumkan masalah tingkat akun untuk penjual tertentu guna mengidentifikasi masalah di seluruh akun.
list_programs Mencantumkan program untuk penjual tertentu, termasuk status partisipasi, wilayah aktif, dan persyaratan yang belum terpenuhi.
list_aggregate_product_statuses Mencantumkan masalah tingkat produk gabungan untuk memantau kesehatan keseluruhan data produk Anda.
get_automatic_improvements Mendapatkan setelan penyempurnaan otomatis, termasuk update item, penyempurnaan gambar, dan penyempurnaan pengiriman.