MCP Tools Reference: paydeveloper.googleapis.com

الأداة: list_google_pay_integrations

تعرض هذه الطريقة الحالة الحالية وتفاصيل الإعدادات لجميع عمليات الدمج في Google Pay المرتبطة بمعرّف تاجر معيّن. تقدّم هذه الميزة ملاحظات فورية حول حالة عمليات الدمج ومراجعات المستندات.

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة list_google_pay_integrations MCP.

طلب Curl 
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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

رسالة طلب إدراج عمليات الدمج مع Google Pay لتاجر معيّن

ListGooglePayIntegrationsRequest

تمثيل JSON 
{
  "merchantId": string
}
الحقول
merchantId

string

الحقل مطلوب. معرّف التاجر الذي سيتم عرض عمليات الدمج الخاصة به.

مخطط الناتج

رسالة الردّ لعرض عمليات الدمج في Google Pay

ListGooglePayIntegrationsResponse

تمثيل JSON 
{
  "googlePayIntegrations": [
    {
      object (GooglePayIntegration)
    }
  ]
}
الحقول
googlePayIntegrations[]

object (GooglePayIntegration)

عمليات الدمج التي أجراها التاجر مع Google Pay

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)

النتائج فقط. حالة دمج التاجر في Google Pay
createTime

string (Timestamp format)

النتائج فقط. وقت إنشاء مرجع الدمج

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف 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 في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
integrationType

enum (IntegrationType)

الحقل مطلوب. نوع عملية دمج Google Pay.
integrationDocuments[]

object (IntegrationDocument)

الحقل مطلوب. الإدخال فقط مستندات دمج Google Pay
حقل الربط item عنصر الدمج يجب ضبط أحد هذه الخيارات. يمكن أن يكون التعليق item إحدى القيم التالية فقط:
webDomain

string

نطاق الويب الخاص بالتاجر
androidAppPackage

string

اسم حزمة تطبيق Android الخاص بالتاجر

الطابع الزمني

تمثيل JSON 
{
  "seconds": string,
  "nanos": integer
}
الحقول
seconds

string (int64 format)

تمثّل هذه السمة عدد ثواني التوقيت العالمي المنسَّق (UTC) المنقضية منذ بداية حقبة يونكس 1970-01-01T00:00:00Z. يجب أن تكون القيمة بين ‎-62135596800 و253402300799 شاملة (وهي تتوافق مع 0001-01-01T00:00:00Z إلى 9999-12-31T23:59:59Z).
nanos

integer

تشير هذه السمة إلى أجزاء الثانية غير السالبة بدقة النانو ثانية هذا الحقل هو جزء من المدة بوحدة النانو ثانية، وليس بديلاً عن الثواني. يجب أن تتضمّن قيم الثواني السالبة مع الكسور قيمًا غير سالبة للنانو ثانية يتم احتسابها للأمام في الوقت. يجب أن تتراوح القيمة بين 0 و999,999,999، بما في ذلك طرفي النطاق.

IntegrationDocument

تمثيل 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 للمستند.

IntegrationState

حالة دمج Google Pay في نطاق ويب خاص بتاجر أو تطبيق Android

عمليات التعداد
INTEGRATION_STATE_UNSPECIFIED لم يتم تحديد حالة الدمج.
NOT_STARTED تكون هذه الحالة عندما يكون تطبيق Android مرتبطًا بالمطوّر (على "متجر Play") ولم يبدأ المطوّر أي عملية دمج له.
INCOMPLETE لم يرسل المطوّر طلب دمج التطبيق للمراجعة بعد، كما أنّ عملية الدمج غير مكتملة (مثل عدم توفّر المستندات الداعمة).
READY_FOR_REVIEW لم يرسل المطوّر عملية الدمج للمراجعة بعد، ولكنّها جاهزة للمراجعة (على سبيل المثال، تم تحميل المستندات الداعمة).
UNDER_REVIEW طلب تفعيل عملية الدمج في انتظار مراجعة المشرف.
NEED_INFO تحتاج عملية الدمج إلى مزيد من المعلومات من مشرف gTech أثناء المراجعة.
ACTIVE عملية الدمج مفعَّلة حاليًا.
DELETED حذف التاجر عملية الدمج
REJECTED تم رفض عملية الدمج.

IntegrationType

نوع عملية دمج Google Pay

عمليات التعداد
INTEGRATION_TYPE_UNSPECIFIED نوع الدمج غير محدّد.
DIRECT_INTEGRATION نوع عملية الدمج هو الدمج المباشر.
PAYMENT_SERVICE_PROVIDER نوع عملية الدمج هو مقدّم خدمة الدفع.

DocumentType

تمثّل هذه السمة نوع المستند.

عمليات التعداد
DOCUMENT_TYPE_UNSPECIFIED لم يتم تحديد نوع المستند.
ITEM_SELECTION_SCREENSHOT عندما يتصفّح المستخدم منتجًا أو خدمة
PRE_PURCHASE_SCREENSHOT عندما يكون المستخدم مستعدًا لإجراء عملية شراء.
PAYMENT_METHOD_SCREENSHOT عندما يختار المستخدم Google Pay كطريقة دفع
PAYMENT_INFO_SCREENSHOT عندما تظهر للمستخدم معلومات الدفع التي حفظها في Google Pay ملاحظة: لن يسمح لك Android بأخذ لقطة شاشة لهذه الشاشة، لذا التقط صورة للشاشة باستخدام جهاز آخر.
POST_PURCHASE_SCREENSHOT عندما يُكمل المستخدم عملية شراء بنجاح
PCI_ATTESTATION_DOCUMENT مستند إثبات الالتزام بمعايير قطاع بطاقات الدفع بتنسيق PDF

MimeType

نوع MIME الخاص بالمستند.

عمليات التعداد
MIME_TYPE_UNSPECIFIED لم يتم تحديد نوع MIME.
JPEG نوع MIME هو JPEG.
PNG نوع MIME هو PNG.
WEBP نوع MIME هو WEBP.
PDF نوع MIME هو PDF.

التعليقات التوضيحية للأدوات

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌