MCP Tools Reference: paydeveloper.googleapis.com

ابزار: set_principal_role

نقش یک مدیر (کاربر) را برای یک تاجر تعیین می‌کند، یا یک مدیر جدید با نقش مشخص شده اضافه می‌کند. برای مدیر یک ایمیل دعوت ارسال می‌شود و او باید قبل از فعال شدن دسترسی‌اش، آن را بپذیرد. این عملیات نیاز به دسترسی ادمین برای تاجر دارد.

نمونه کد زیر نحوه استفاده از curl برای فراخوانی ابزار set_principal_role MCP را نشان می‌دهد.

درخواست کرل 
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
}'

طرحواره ورودی

درخواست پیام برای اضافه کردن یا به‌روزرسانی مبلغ اصلی روی یک فروشنده.

درخواست نقش اصلی را تنظیم کنید

نمایش JSON 
{
  "merchantId": string,
  "email": string,
  "role": enum (PrincipalRole)
}
فیلدها
merchantId

string

الزامی. شناسه فروشنده، که برای افزودن یا به‌روزرسانی اصل پول استفاده می‌شود.

email

string

الزامی. آدرس ایمیل مدیر برای اضافه کردن یا به‌روزرسانی.

role

enum ( PrincipalRole )

الزامی. نقشی که باید به مدیر اعطا شود.

نقش اصلی

نقشی که می‌تواند به یک مدیر (کاربر) در یک تاجر اعطا شود.

انوم‌ها
PRINCIPAL_ROLE_UNSPECIFIED نقش نامشخص است.
ADMIN دسترسی کامل به فروشنده، از جمله مدیریت کاربران.
DEVELOPER دسترسی در نظر گرفته شده برای توسعه‌دهندگانی که با فروشنده ادغام می‌شوند.

طرحواره خروجی

پیام پاسخ برای اضافه کردن یا به‌روزرسانی مبلغ اصلی روی یک تاجر.

تنظیم پاسخ نقش اصلی

نمایش JSON 
{
  "state": enum (State)
}
فیلدها
state

enum ( State )

وضعیت مدیر پس از اضافه کردن یا به‌روزرسانی.

ایالت

وضعیت دسترسی یک مدیر به یک تاجر.

انوم‌ها
STATE_UNSPECIFIED وضعیت دسترسی مشخص نیست.
ACTIVE مدیر دسترسی فعال و پذیرفته‌شده‌ای دارد.
PENDING از مدیر مدرسه دعوت شده اما هنوز دعوت را نپذیرفته است.
EXPIRED دعوتنامه مدیر منقضی شده است.

حاشیه‌نویسی ابزار

حاشیه‌نویسی‌های ابزار برای توصیف ریسک اولیه‌ی یک ابزار مشخص به کلاینت‌های MCP ارسال می‌شوند. اکثر کلاینت‌ها این نکات را غیرقابل اعتماد می‌دانند، اما می‌توان از آنها برای تصمیم‌گیری در مورد زمان ارسال پیام تأیید به کاربر استفاده کرد.

همراه با رشته عنوان، نکات بولی زیر به صورت زیر تعریف می‌شوند:

  • readOnlyHint : اگر درست باشد، ابزار محیط خود را تغییر نمی‌دهد. پیش‌فرض: نادرست.
  • destructiveHint : اگر درست باشد، ابزار می‌تواند اقدامات مخرب انجام دهد. اگر نادرست باشد، ابزار فقط می‌تواند اقدامات افزایشی انجام دهد. پیش‌فرض: درست.
  • idempotentHint : اگر مقدار آن درست باشد، فراخوانی مکرر ابزار با آرگومان‌های یکسان، هیچ تأثیر اضافی بر محیط آن نخواهد داشت. پیش‌فرض: false.
  • openWorldHint : اگر درست باشد، ابزار می‌تواند با «دنیای باز» از موجودیت‌های خارجی تعامل داشته باشد. اگر نادرست باشد، ابزار فقط می‌تواند با موجودیت‌های داخلی تعامل داشته باشد. برای مثال، یک ابزار جستجوی وب جهان‌باز خواهد بود، در حالی که یک ابزار حافظه جهان‌باز نخواهد بود.

راهنمایی مخرب: ✅ | راهنمایی بی‌اثر: ❌ | راهنمایی فقط خواندنی: ❌ | راهنمایی جهان باز: ❌