MCP Tools Reference: paydeveloper.googleapis.com

Araç: set_principal_role

Bir satıcıdaki asıl kullanıcının rolünü ayarlar veya belirtilen role sahip yeni bir asıl kullanıcı ekler. Müdüre e-postayla davetiye gönderilir ve erişiminin etkinleşmesi için davetiyeyi kabul etmesi gerekir. Bu işlem için satıcının yönetici erişimi gerekir.

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

Giriş Şeması

Bir satıcıya ana hesap ekleme veya ana hesabı güncelleme için istek mesajı.

SetPrincipalRoleRequest

JSON gösterimi 
{
  "merchantId": string,
  "email": string,
  "role": enum (PrincipalRole)
}
Alanlar
merchantId

string

Zorunlu. Ana hesabın ekleneceği veya güncelleneceği satıcı kimliği.
email

string

Zorunlu. Eklenecek veya güncellenecek yöneticinin e-posta adresi.
role

enum (PrincipalRole)

Zorunlu. Ana hesaba atanacak rol.

PrincipalRole

Bir satıcıda asile (kullanıcı) verilebilen bir rol.

Sıralamalar
PRINCIPAL_ROLE_UNSPECIFIED Rol belirtilmemiş.
ADMIN Kullanıcıları yönetme dahil olmak üzere satıcıya tam erişim.
DEVELOPER Satıcıyla entegrasyon yapan geliştiriciler için tasarlanmıştır.

Çıkış şeması

Bir satıcıya sorumlu ekleme veya sorumlu güncelleme için yanıt mesajı.

SetPrincipalRoleResponse

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

enum (State)

Ekleme veya güncelleme işleminden sonraki asıl durum.

Eyalet

Bir asılın satıcıya erişim durumu.

Sıralamalar
STATE_UNSPECIFIED Erişim durumu belirtilmemiş.
ACTIVE Yetkili, etkin ve kabul edilmiş bir erişime sahip olmalıdır.
PENDING Okul müdürü davet edildi ancak daveti henüz kabul etmedi.
EXPIRED Okul yöneticisinin davetinin süresi doldu.

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