MCP Tools Reference: paydeveloper.googleapis.com

Araç: list_principals

Belirli bir satıcıya erişimi olan ana hesapları (kullanıcılar) listeler. Bu işlem için satıcının yönetici erişimi gerekir.

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

Giriş Şeması

Satıcının yöneticilerini listeleme için istek mesajı.

ListPrincipalsRequest

JSON gösterimi 
{
  "merchantId": string
}
Alanlar
merchantId

string

Zorunlu. Yetkililerin listeleneceği satıcı kimliği.

Çıkış şeması

Bir satıcının yöneticilerini listelemeyle ilgili yanıt mesajı.

ListPrincipalsResponse

JSON gösterimi 
{
  "principals": [
    {
      object (Principal)
    }
  ]
}
Alanlar
principals[]

object (Principal)

Satıcıya erişimi olan yetkililer.

Ana hesap

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

string

Zorunlu. Müdürün e-posta adresi.
displayName

string

Yalnızca çıkış. Asıl sorumlunun görünen adı.
role

enum (PrincipalRole)

Ana hesabın satıcıdaki rolü.
state

enum (State)

Yalnızca çıkış. Asıl kullanıcının satıcıdaki erişim durumu.

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.

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.

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