MCP Tools Reference: paydeveloper.googleapis.com

Alat: list_merchants

Mengambil daftar lengkap semua penjual Google Pay yang terkait dengan akun terautentikasi. Bergantung pada peran pengguna di penjual, admin dapat melihat informasi penjual yang mendetail dan lengkap, sedangkan developer hanya dapat melihat informasi penjual dasar.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP list_merchants.

Permintaan Curl 
curl --location 'https://paydeveloper.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_merchants",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Permintaan pesan untuk mendaftarkan pedagang.

ListMerchantsRequest

Representasi JSON 
{
  "view": enum (MerchantView)
}
Kolom
view

enum (MerchantView)

Opsional. Menentukan tingkat detail yang akan ditampilkan untuk setiap penjual.

MerchantView

Tingkat detail yang akan ditampilkan untuk setiap penjual.

Enum
MERCHANT_VIEW_UNSPECIFIED Nilai default / tidak ditetapkan. API akan menggunakan tampilan DASAR secara default.
MERCHANT_VIEW_BASIC Sertakan informasi dasar tentang penjual.
MERCHANT_VIEW_FULL Sertakan semua detail tentang penjual.

Skema Output

Pesan respons untuk mencantumkan penjual.

ListMerchantsResponse

Representasi JSON 
{
  "merchants": [
    {
      object (Merchant)
    }
  ]
}
Kolom
merchants[]

object (Merchant)

Para pedagang yang dapat diakses oleh pengguna.

Penjual

Representasi JSON 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
Kolom
merchantId

string

Hanya output. Pengidentifikasi unik pedagang.
displayName

string

Wajib. Nama tampilan penjual.
regionCode

string

Wajib. Kode wilayah lokasi bisnis penjual. Formatnya adalah kode wilayah CLDR Unicode, misalnya, "US". India ("IN") tidak didukung.
mcc

enum (Mcc)

Wajib. Kode Kategori Penjual (MCC) penjual.
corporateWebsiteUrl

string

Wajib. Situs perusahaan penjual.
customerSupportWebsiteUrl

string

Wajib. Situs dukungan pelanggan penjual.
customerSupportEmail

string

Wajib. Email dukungan pelanggan penjual.
customerSupportPhone

string

Wajib. Nomor telepon dukungan pelanggan penjual.
state

enum (State)

Hanya output. Status penjual.

Mcc

Kode Kategori Penjual (MCC) penjual.

Enum
OTHERS Lainnya
MISC_FOOD_STORES Toko Makanan Lainnya – Minimarket dan Pasar Khusus
MISC_APPAREL Toko Pakaian dan Aksesori Lainnya
ARTISTS_SUPPLY Toko Perlengkapan Seni dan Kerajinan
AUTOMOTIVE_PARTS Toko Suku Cadang, Aksesori Otomotif
HEALTH_AND_BEAUTY Toko Kesehatan dan Kecantikan
BOOKS_PERIODICALS Buku, Majalah, dan Koran
CAMERA_STORES Toko Peralatan Fotografi dan Kamera
COMPUTERS_EQUIPMENT Komputer, Peralatan Periferal Komputer, Software
COMPUTER_SOFTWARE Toko Software Komputer
ELECTRONICS_SALES Penjualan Elektronik
GIFT_SHOPS Toko Kartu, Toko Hadiah, Toko Barang Unik, dan Toko Suvenir
EATING_PLACES Tempat Makan dan Restoran
MISC_GENERAL_MERCHANDISE Barang Dagangan Umum Lainnya
HOME_SUPPLY Toko Gudang Perlengkapan Rumah
COMPUTER_NETWORK_SERVICES Layanan Jaringan Komputer
DIGITAL_GOODS_MEDIA Produk Digital: Buku, Film, Musik
DIGITAL_GOODS_GAMES Produk Digital: Game
DIGITAL_GOODS_APPLICATIONS Barang Digital: Aplikasi (Tidak Termasuk Game)
POLITICAL_ORGANIZATIONS Organisasi Politik
CHARITABLE_ORGANIZATIONS Organisasi Amal dan Layanan Sosial
DRUG_STORES Toko Obat dan Apotek
REAL_ESTATE_RENTALS Agen dan Pengelola Properti - Penyewaan
MISC_PERSONAL_SERVICES Layanan Pribadi Lainnya, Tidak Diklasifikasikan di Tempat Lain
SPORTING_GOODS Toko Peralatan Olahraga
STATIONERY_OFFICE_SUPPLIES Alat Tulis, Perlengkapan Kantor, Kertas Cetak dan Kertas Tulis
THEATRICAL_TICKET_AGENCIES Agen Penjualan Tiket Teater
TIMESHARES Timeshare
TOURIST_ATTRACTIONS Objek Wisata dan Pameran
HOBBY_TOY_GAME_SHOPS Toko Hobi, Mainan, dan Permainan
PET_SHOPS Toko Hewan Peliharaan, Toko Makanan dan Perlengkapan Hewan Peliharaan
OTHER_LODGING Penginapan Lainnya–Hotel, Motel, Resor
TELECOMMUNICATION_SERVICES Layanan Telekomunikasi
TRANSPORTATION_SERVICES Layanan Transportasi
OTHER_AIRLINES Maskapai Penerbangan Lainnya
TRAVEL_AGENCIES Agen Perjalanan dan Operator Tur
GOVERNMENT_OWNED_LOTTERIES_US Lotre yang Dimiliki Pemerintah (Khusus Wilayah AS)
GOVERNMENT_LICENSED_CASINOS_US Kasino Online Berlisensi Pemerintah (Perjudian Online) (Khusus Wilayah Amerika Serikat)
BETTING Taruhan (termasuk Tiket Lotre, Chip Game Kasino, Taruhan di Luar Arena Pacuan Kuda, dan Taruhan)
GOVERNMENT_OWNED_LOTTERIES_NON_US Lotre yang Dimiliki Pemerintah (Wilayah non-Amerika Serikat)

Negara bagian/Provinsi

Status penjual.

Enum
STATE_UNSPECIFIED Status penjual tidak ditentukan.
VERIFIED Penjual telah diverifikasi dan disetujui.
IN_REVIEW Hasil edit profil penjual sedang dalam peninjauan.
REJECTED Pengeditan profil penjual ditolak.
INCOMPLETE_SIGNUP Profil penjual belum lengkap.
SANCTIONS_HIT Profil penjual terkena sanksi.
READY_FOR_REVIEW Profil penjual sudah lengkap dan siap ditinjau.
DISABLED Profil penjual dinonaktifkan/tidak aktif.

Anotasi Alat

Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi petunjuk ini dapat digunakan untuk memutuskan kapan perintah konfirmasi dapat dikirim ke pengguna.

Selain string judul, petunjuk boolean berikut ditentukan sebagai berikut:

  • readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.
  • destructiveHint: Jika benar (true), alat dapat melakukan tindakan merusak. Jika salah (false), alat hanya dapat melakukan tindakan tambahan. Default: true.
  • idempotentHint: Jika benar (true), memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.
  • openWorldHint: Jika benar, alat dapat berinteraksi dengan 'dunia terbuka' entitas eksternal. Jika salah (false), alat hanya dapat berinteraksi dengan entitas internal. Misalnya, alat penelusuran web akan menjadi open world, sedangkan alat memori tidak akan menjadi open world.

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌