MCP Tools Reference: paydeveloper.googleapis.com

Araç: list_merchants

Kimliği doğrulanmış hesapla ilişkili tüm Google Pay satıcılarının kapsamlı bir listesini alır. Yöneticiler, kullanıcının satıcıdaki rolüne bağlı olarak ayrıntılı satıcı bilgilerinin tamamını görüntüleyebilirken geliştiriciler yalnızca temel satıcı bilgilerini görüntüleyebilir.

Aşağıdaki kod örneğinde, list_merchants MCP aracını çağırmak için curl simgesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
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
}'

Giriş Şeması

Listeleme satıcıları için mesaj isteği.

ListMerchantsRequest

JSON gösterimi 
{
  "view": enum (MerchantView)
}
Alanlar
view

enum (MerchantView)

İsteğe bağlı. Her satıcı için döndürülecek ayrıntı düzeyini belirtir.

MerchantView

Her satıcı için döndürülecek ayrıntı düzeyi.

Sıralamalar
MERCHANT_VIEW_UNSPECIFIED Varsayılan / ayarlanmamış değer. API, varsayılan olarak BASIC görünümüne ayarlanır.
MERCHANT_VIEW_BASIC Satıcı hakkında temel bilgileri ekleyin.
MERCHANT_VIEW_FULL Satıcıyla ilgili tüm ayrıntıları ekleyin.

Çıkış şeması

Listeleme satıcıları için yanıt mesajı.

ListMerchantsResponse

JSON gösterimi 
{
  "merchants": [
    {
      object (Merchant)
    }
  ]
}
Alanlar
merchants[]

object (Merchant)

Kullanıcının erişebildiği satıcılar.

Satıcı

JSON gösterimi 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
Alanlar
merchantId

string

Yalnızca çıkış. Satıcının benzersiz tanımlayıcısı.
displayName

string

Zorunlu. Satıcının görünen adı.
regionCode

string

Zorunlu. Satıcının işletmesinin bulunduğu konumun bölge kodu. Biçim, Unicode CLDR bölge kodlarıdır (ör. "US"). Hindistan ("IN") desteklenmez.
mcc

enum (Mcc)

Zorunlu. Satıcının satıcı kategorisi kodu (MCC).
corporateWebsiteUrl

string

Zorunlu. Satıcının kurumsal web sitesi.
customerSupportWebsiteUrl

string

Zorunlu. Satıcının müşteri desteği web sitesi.
customerSupportEmail

string

Zorunlu. Satıcının müşteri desteği e-posta adresi.
customerSupportPhone

string

Zorunlu. Satıcının müşteri desteği telefon numarası.
state

enum (State)

Yalnızca çıkış. Satıcının bulunduğu eyalet.

Mcc

Satıcının satıcı kategorisi kodu (MCC).

Sıralamalar
OTHERS Diğer
MISC_FOOD_STORES Çeşitli Gıda Mağazaları – Marketler ve Özel Marketler
MISC_APPAREL Çeşitli Giyim ve Aksesuar Mağazaları
ARTISTS_SUPPLY Sanatçı Malzemeleri ve El Sanatları Mağazaları
AUTOMOTIVE_PARTS Otomotiv Parçaları, Aksesuar Mağazaları
HEALTH_AND_BEAUTY Sağlık ve Güzellik Merkezi
BOOKS_PERIODICALS Kitaplar, Süreli Yayınlar ve Gazeteler
CAMERA_STORES Kamera ve Fotoğraf Malzemeleri Mağazaları
COMPUTERS_EQUIPMENT Bilgisayarlar, Bilgisayar Çevre Birimleri, Yazılımlar
COMPUTER_SOFTWARE Bilgisayar Yazılımı Mağazaları
ELECTRONICS_SALES Elektronik Satışları
GIFT_SHOPS Kart mağazaları, hediye, yenilik ve hediyelik eşya mağazaları
EATING_PLACES Yemek Yenebilecek Yerler ve Restoranlar
MISC_GENERAL_MERCHANDISE Muhtelif Genel Ürünler
HOME_SUPPLY Ev malzemeleri toptan satış mağazaları
COMPUTER_NETWORK_SERVICES Bilgisayar Ağı Hizmetleri
DIGITAL_GOODS_MEDIA Dijital Ürünler: Kitaplar, Filmler, Müzik
DIGITAL_GOODS_GAMES Dijital Ürünler: Oyunlar
DIGITAL_GOODS_APPLICATIONS Dijital Ürünler: Uygulamalar (Oyunlar Hariç)
POLITICAL_ORGANIZATIONS Siyasi kuruluşlar
CHARITABLE_ORGANIZATIONS Hayır ve Sosyal Hizmet Kuruluşları
DRUG_STORES Eczaneler
REAL_ESTATE_RENTALS Emlakçı ve Yönetici - Kiralama
MISC_PERSONAL_SERVICES Diğer Kişisel Hizmetler, Başka Yerde Sınıflandırılmamış
SPORTING_GOODS Spor Ürünleri Mağazaları
STATIONERY_OFFICE_SUPPLIES Kırtasiye, Ofis Malzemeleri, Baskı ve Yazı Kağıdı
THEATRICAL_TICKET_AGENCIES Tiyatro Bilet Acenteleri
TIMESHARES Devre Mülkler
TOURIST_ATTRACTIONS Turistik Yerler ve Sergiler
HOBBY_TOY_GAME_SHOPS Hobi, Oyuncak ve Oyun Mağazaları
PET_SHOPS Evcil hayvan mağazaları, evcil hayvan mamaları ve bakım ürünleri mağazaları
OTHER_LODGING Diğer Konaklama Yerleri (Oteller, Moteller, Tatil Köyleri)
TELECOMMUNICATION_SERVICES Telekomünikasyon Hizmetleri
TRANSPORTATION_SERVICES Ulaşım Hizmetleri
OTHER_AIRLINES Diğer hava yolları
TRAVEL_AGENCIES Seyahat Acenteleri ve Tur Operatörleri
GOVERNMENT_OWNED_LOTTERIES_US Devlete Ait Piyangolar (yalnızca ABD bölgesi)
GOVERNMENT_LICENSED_CASINOS_US Resmi lisanslı online kumarhaneler (online kumar) (yalnızca ABD bölgesi)
BETTING Bahis (piyango biletleri, kumarhane oyun çipleri, hipodrom dışı bahisler ve iddialar dahil)
GOVERNMENT_OWNED_LOTTERIES_NON_US Devlete ait piyangolar (ABD dışındaki bölgeler)

Eyalet

Satıcının durumu.

Sıralamalar
STATE_UNSPECIFIED Satıcının bulunduğu eyalet belirtilmemiş.
VERIFIED Satıcı doğrulandı ve onaylandı.
IN_REVIEW Satıcı profili düzenlemesi inceleniyor.
REJECTED Satıcı profili düzenlemesi reddedilir.
INCOMPLETE_SIGNUP Satıcı profili tamamlanmamış.
SANCTIONS_HIT Satıcı profili yaptırımlara tabi.
READY_FOR_REVIEW Satıcı profili tamamlandı ve incelenmeye hazır.
DISABLED Satıcı profili devre dışı/etkin değil.

Araç Ek Açıklamaları

Araç açıklamaları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilmeyen olarak değerlendirir ancak onay isteminin kullanıcıya ne zaman gönderileceğine karar vermek için kullanılabilirler.

Başlık dizesinin yanı sıra aşağıdaki Boole ipuçları şu şekilde tanımlanır:

  • readOnlyHint: Doğruysa araç, ortamını değiştirmez. Varsayılan: false.
  • destructiveHint: Doğruysa araç, yıkıcı işlemler gerçekleştirebilir. Yanlış ise araç yalnızca ekleme işlemleri gerçekleştirebilir. Varsayılan: true.
  • idempotentHint: Doğruysa aynı bağımsız değişkenlerle aracı tekrar tekrar çağırmanın ortamı üzerinde ek bir etkisi olmaz. Varsayılan: false.
  • openWorldHint: Doğruysa araç, harici öğelerden oluşan bir "açık dünya" ile etkileşim kurabilir. Yanlışsa araç yalnızca dahili öğelerle etkileşim kurabilir. Örneğin, bir web arama aracı açık dünya olurken bir bellek aracı açık dünya olmaz.

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌