MCP Tools Reference: paydeveloper.googleapis.com

ابزار: list_google_pay_integrations

وضعیت فعلی و جزئیات پیکربندی را برای همه ادغام‌های Google Pay مرتبط با یک شناسه فروشنده خاص برمی‌گرداند. این ابزار بازخورد فوری در مورد وضعیت ادغام و بررسی اسناد ارائه می‌دهد. علاوه بر این، شما باید به کاربر اطلاع دهید که ادغام می‌تواند در کنسول Google Pay & Wallet ( https://pay.google.com/business/console/) ایجاد/به‌روزرسانی شود.

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

درخواست کرل 
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_google_pay_integrations",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

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

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

درخواست ادغام با گوگل پی (GooglePay)

نمایش JSON 
{
  "merchantId": string
}
فیلدها
merchantId

string

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

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

پیام پاسخ برای فهرست کردن ادغام‌های Google Pay.

پاسخ به ListGooglePayIntegrationsResponse

نمایش JSON 
{
  "googlePayIntegrations": [
    {
      object (GooglePayIntegration)
    }
  ]
}
فیلدها
googlePayIntegrations[]

object ( GooglePayIntegration )

ادغام‌های گوگل پیِ فروشنده.

ادغام با گوگل پی

نمایش JSON 
{
  "integrationState": enum (IntegrationState),
  "createTime": string,
  "updateTime": string,
  "integrationType": enum (IntegrationType),
  "integrationDocuments": [
    {
      object (IntegrationDocument)
    }
  ],

  // Union field item can be only one of the following:
  "webDomain": string,
  "androidAppPackage": string
  // End of list of possible types for union field item.
}
فیلدها
integrationState

enum ( IntegrationState )

فقط خروجی. وضعیت ادغام فروشگاه با گوگل پی.

createTime

string ( Timestamp format)

فقط خروجی. زمانی که منبع یکپارچه‌سازی ایجاد شد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

updateTime

string ( Timestamp format)

فقط خروجی. آخرین باری که منبع ادغام به‌روزرسانی شده است.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

integrationType

enum ( IntegrationType )

الزامی. نوع ادغام با گوگل پی.

integrationDocuments[]

object ( IntegrationDocument )

الزامی. فقط ورودی. اسناد ادغام با Google Pay.

item Union. آیتم ادغام. یکی از این موارد باید تنظیم شود. item فقط می‌تواند یکی از موارد زیر باشد:
webDomain

string

دامنه وب تاجر.

androidAppPackage

string

نام بسته برنامه اندروید فروشنده.

مهر زمانی

نمایش JSON 
{
  "seconds": string,
  "nanos": integer
}
فیلدها
seconds

string ( int64 format)

ثانیه‌های زمان UTC را از زمان یونیکس ۱۹۷۰-۰۱-۰۱T۰۰:۰۰:۰۰Z نشان می‌دهد. باید بین -۶۲۱۳۵۵۹۶۸۰۰ و ۲۵۳۴۰۲۳۰۰۷۹۹ باشد (که معادل ۰۰۰۱-۰۱-۰۱T۰۰:۰۰:۰۰Z تا ۹۹۹۹-۱۲-۳۱T۲۳:۵۹:۵۹Z است).

nanos

integer

کسرهای غیرمنفی ثانیه با وضوح نانوثانیه. این فیلد بخش نانوثانیه از مدت زمان است، نه جایگزینی برای ثانیه. مقادیر منفی ثانیه با کسرها باید همچنان دارای مقادیر نانوثانیه غیرمنفی باشند که در زمان به جلو شمارش می‌شوند. باید بین ۰ تا ۹۹۹۹۹۹۹۹۹۹ باشد.

سند ادغام

نمایش JSON 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
فیلدها
name

string

الزامی. نام سند.

data

string ( bytes format)

الزامی. داده‌های سند.

یک رشته کدگذاری شده با base64.

documentType

enum ( DocumentType )

الزامی. نوع سند.

mimeType

enum ( MimeType )

الزامی. نوع MIME سند.

حالت ادغام

وضعیت ادغام Google Pay در یک دامنه وب فروشگاه یا برنامه اندروید.

انوم‌ها
INTEGRATION_STATE_UNSPECIFIED وضعیت ادغام مشخص نشده است.
NOT_STARTED این وضعیت برای زمانی است که برنامه اندروید با توسعه‌دهنده (در فروشگاه Play) مرتبط است و توسعه‌دهنده هیچ فرآیند ادغامی را برای آن آغاز نکرده است.
INCOMPLETE توسعه‌دهنده هنوز ادغام را برای بررسی ارسال نکرده است و همچنین کامل نیست (مثلاً اسناد پشتیبان موجود نیست).
READY_FOR_REVIEW توسعه‌دهنده هنوز ادغام را برای بررسی ارسال نکرده است، اما آماده بررسی است (مثلاً اسناد پشتیبان آپلود شده‌اند).
UNDER_REVIEW درخواست فعال‌سازی ادغام در انتظار بررسی توسط مدیر است.
NEED_INFO این ادغام نیاز به اطلاعات بیشتری توسط مدیر gTech در طول بررسی دارد.
ACTIVE این ادغام در حال حاضر فعال است.
DELETED ادغام توسط فروشنده حذف می‌شود.
REJECTED ادغام رد می‌شود.

نوع ادغام

نوع ادغام ادغام Google Pay.

انوم‌ها
INTEGRATION_TYPE_UNSPECIFIED نوع ادغام مشخص نشده است.
DIRECT_INTEGRATION نوع ادغام، ادغام مستقیم است.
PAYMENT_SERVICE_PROVIDER نوع ادغام، ارائه دهنده خدمات پرداخت است.

نوع سند

نوع سند.

انوم‌ها
DOCUMENT_TYPE_UNSPECIFIED نوع سند مشخص نیست.
ITEM_SELECTION_SCREENSHOT وقتی کاربری در حال مرور یک کالا یا سرویس است.
PRE_PURCHASE_SCREENSHOT وقتی کاربر در نهایت آماده خرید است.
PAYMENT_METHOD_SCREENSHOT وقتی کاربر Google Pay را به عنوان روش پرداخت خود انتخاب می‌کند.
PAYMENT_INFO_SCREENSHOT وقتی اطلاعات پرداختی که کاربر در Google Pay ذخیره کرده است به او نشان داده می‌شود. نکته: اندروید به شما اجازه نمی‌دهد از این صفحه عکس بگیرید، بنابراین با استفاده از دستگاه دیگری از صفحه عکس بگیرید.
POST_PURCHASE_SCREENSHOT وقتی کاربر خرید موفقی انجام داده باشد.
PCI_ATTESTATION_DOCUMENT سند تأیید PCI در قالب PDF.

نوع مایم

نوع mime یک سند.

انوم‌ها
MIME_TYPE_UNSPECIFIED نوع mime مشخص نشده است.
JPEG نوع MIME آن JPEG است.
PNG نوع mime آن PNG است.
WEBP نوع مایم WEBP است.
PDF نوع mime آن PDF است.

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

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

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

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

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