MCP Tools Reference: paydeveloper.googleapis.com

Alat: update_merchant

Memperbarui kolom tertentu dari penjual yang ada. Kolom yang didukung mencakup display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email, dan customer_support_phone.

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

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": "update_merchant",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Pesan permintaan untuk UpdateMerchant.

UpdateMerchantFacadeRequest

Representasi JSON 
{
  "merchantId": string,

  // Union field _display_name can be only one of the following:
  "displayName": string
  // End of list of possible types for union field _display_name.

  // Union field _mcc can be only one of the following:
  "mcc": enum (Mcc)
  // End of list of possible types for union field _mcc.

  // Union field _corporate_website_url can be only one of the following:
  "corporateWebsiteUrl": string
  // End of list of possible types for union field _corporate_website_url.

  // Union field _customer_support_website_url can be only one of the following:
  "customerSupportWebsiteUrl": string
  // End of list of possible types for union field _customer_support_website_url.

  // Union field _customer_support_email can be only one of the following:
  "customerSupportEmail": string
  // End of list of possible types for union field _customer_support_email.

  // Union field _customer_support_phone can be only one of the following:
  "customerSupportPhone": string
  // End of list of possible types for union field _customer_support_phone.
}
Kolom
merchantId

string

Wajib. ID penjual yang akan diperbarui.

Kolom union _display_name.

_display_name hanya dapat berupa salah satu dari hal berikut:
displayName

string

Nama tampilan penjual.

Kolom union _mcc.

_mcc hanya dapat berupa salah satu dari hal berikut:
mcc

enum (Mcc)

Kode Kategori Pedagang (MCC) dari pedagang tersebut.

Kolom union _corporate_website_url.

_corporate_website_url hanya dapat berupa salah satu dari hal berikut:
corporateWebsiteUrl

string

Situs perusahaan penjual.

Kolom union _customer_support_website_url.

_customer_support_website_url hanya dapat berupa salah satu dari hal berikut:
customerSupportWebsiteUrl

string

Situs dukungan pelanggan penjual.

Kolom union _customer_support_email.

_customer_support_email hanya dapat berupa salah satu dari hal berikut:
customerSupportEmail

string

Email dukungan pelanggan penjual.

Kolom union _customer_support_phone.

_customer_support_phone hanya dapat berupa salah satu dari hal berikut:
customerSupportPhone

string

Telepon dukungan pelanggan 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 Game
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)

Skema Output

Pesan respons untuk UpdateMerchant.

UpdateMerchantResponse

Representasi JSON 
{
  "state": enum (State)
}
Kolom
state

enum (State)

Status pedagang yang telah diperbarui.

Negara bagian/Provinsi

Keadaan seorang pedagang.

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: ❌