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 yang aman dan standar bagi LLM, agen, dan asisten coding untuk membangun dan mengatur pengalaman agentic baru serta alur kerja otomatis yang didasarkan pada data Merchant Center.

Secara khusus, API ini memungkinkan akses yang sah ke data Merchant Center Anda serta laporan dan insight yang dihasilkan 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 pengaktifan untuk peningkatan otomatis
• Membuat dan mengambil sumber data

Kontrol keselamatan dan akses

Layanan Akses MCP Merchant API dirancang dengan prioritas pada keamanan:

• Autentikasi: Eksekusi alat diatur oleh autentikasi Merchant API standar, yang memerlukan kredensial OAuth 2.0 atau akun layanan. Sebaiknya gunakan kredensial dengan hak akses yang paling ketat.
• Keamanan Eksekusi: Meskipun visibilitas alat tidak dibatasi untuk penemuan berbasis agen, eksekusi alat dibatasi untuk kredensial API spesifik Anda.
• Pengamanan: Alat dibatasi secara ketat untuk operasi hanya baca 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 akun pengujian atau akun non-live sebelum menggunakan alat ini di lingkungan produksi aktif.

Kuota bersama

Layanan Akses MCP Merchant API berbagi 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 pada masa mendatang. Sebaiknya konfigurasikan 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 secara agentic:

• Mengambil konteks pelaporan dan status mendetail untuk produk tertentu menggunakan nama resource yang tepat.
• Mencantumkan dan menelusuri beberapa produk.
• Metrik performa kueri, status produk, dan insight tentang produk populer, insight harga, visibilitas kompetitif, dan analisis Afiliasi YouTube Shopping.
• Identifikasi masalah tingkat akun yang memengaruhi visibilitas produk atau partisipasi program.
• Mencantumkan, membuat, mengambil, dan memeriksa status upload sumber data.
• Mencantumkan alasan gabungan penolakan produk di seluruh inventaris Anda.
• Tinjau setelan penyempurnaan otomatis untuk item, gambar, dan pengiriman.
• Periksa wilayah aktif, persyaratan yang tidak 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, mcp.json atau settings.json).

Konfigurasi klien

Penyiapan konfigurasi:

{
    "mcpServers": {
        "merchant-api-access": {
            "serverUrl": "https://merchantapi.googleapis.com/mcp",
            "headers": {
                "Authorization": "Bearer {ACCESS_TOKEN}",
                "x-goog-user-project": "{GOOGLE_CLOUD_PROJECT_ID}"
            }
        }
    }
}

claude mcp add --transport http merchant-api https://merchantapi.googleapis.com/mcp --scope local \
  --header "Authorization: Bearer {ACCESS_TOKEN}" \
  --header "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}"

curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "list_data_sources",
      "arguments": {
        "parent": "accounts/{ACCOUNT_ID}"
      }
    }
  }'

Ganti kode berikut:

• ACCOUNT_ID: ID Merchant Center Anda
• ACCESS_TOKEN: token otorisasi untuk melakukan panggilan API
• GOOGLE_CLOUD_PROJECT_ID: ID project Google Cloud yang terkait dengan akun Merchant Center Anda

Contoh skenario penggunaan

Untuk menggambarkan cara Anda dapat 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 mengapa produk tertentu tidak muncul di hasil Penelusuran Google.

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 keikutsertaan untuk peningkatan otomatis

Anda ingin memverifikasi apakah peningkatan pengiriman otomatis Anda aktif.

Perintah pengguna:

"Apakah peningkatan kualitas 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 peningkatan gambar, item, dan pengiriman.
3. Agen mengonfirmasi bahwa peningkatan pengiriman sudah aktif, atau menjelaskan cara mengaktifkannya jika tidak aktif.

Skenario 3: Membuat laporan dan insight performa

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

Perintah pengguna:

"Show me my top 5 performing products by clicks last week" (Tampilkan 5 produk berperforma terbaik saya 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 langsung dan menampilkan baris.
4. Agen akan memformat hasil menjadi tabel Markdown yang rapi untuk Anda.

Skenario 4: Membuat dan mengambil sumber data

Anda ingin menambahkan sumber data baru untuk mengupload pembaruan 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: