MCP Tools Reference: paydeveloper.googleapis.com

Araç: update_merchant

Mevcut bir satıcının belirli alanlarını günceller. Desteklenen alanlar arasında display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email ve customer_support_phone bulunur.

Aşağıdaki kod örneğinde, update_merchant 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": "update_merchant",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

UpdateMerchant için istek mesajı.

UpdateMerchantFacadeRequest

JSON gösterimi
{
  "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.
}
Alanlar
merchantId

string

Zorunlu. Güncellenecek satıcının satıcı kimliği.

_display_name birleşik alanı.

_display_name aşağıdakilerden yalnızca biri olabilir:

displayName

string

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

_mcc birleşik alanı.

_mcc aşağıdakilerden yalnızca biri olabilir:

mcc

enum (Mcc)

Satıcının MCC'si (Satıcı Kategorisi Kodu).

_corporate_website_url birleşik alanı.

_corporate_website_url aşağıdakilerden yalnızca biri olabilir:

corporateWebsiteUrl

string

Satıcının kurumsal web sitesi.

_customer_support_website_url birleşik alanı.

_customer_support_website_url aşağıdakilerden yalnızca biri olabilir:

customerSupportWebsiteUrl

string

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

_customer_support_email birleşik alanı.

_customer_support_email aşağıdakilerden yalnızca biri olabilir:

customerSupportEmail

string

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

_customer_support_phone birleşik alanı.

_customer_support_phone aşağıdakilerden yalnızca biri olabilir:

customerSupportPhone

string

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

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)

Çıkış şeması

UpdateMerchant için yanıt mesajı.

UpdateMerchantResponse

JSON gösterimi
{
  "state": enum (State)
}
Alanlar
state

enum (State)

Güncellenen satıcının durumu.

Eyalet

Satıcının durumu.

Sıralamalar
STATE_UNSPECIFIED Tüccarın bulunduğu ülke belirtilmemiştir.
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.

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