MCP Tools Reference: paydeveloper.googleapis.com

الأداة: list_google_pay_integrations

تعرض هذه الطريقة الحالة الحالية وتفاصيل الإعدادات لجميع عمليات الدمج في Google Pay المرتبطة بمعرّف تاجر معيّن. ويقدّم ملاحظات فورية حول حالة عمليات الدمج ومراجعات المستندات. بالإضافة إلى ذلك، يجب إبلاغ المستخدم بأنّه يمكن إنشاء عملية الدمج أو تعديلها في Google Pay & Wallet Console (https://pay.google.com/business/console/).

يوضّح نموذج الرمز التالي كيفية استخدام 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 MCP tool 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 مرتبطًا بالمطوّر (على "متجر Google 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.

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

يتم إرسال تعليقات توضيحية للأدوات إلى عملاء MCP لوصف المخاطر الأساسية لأداة معيّنة. تتعامل معظم البرامج مع هذه التلميحات على أنّها غير موثوق بها، ولكن يمكن استخدامها لتحديد الوقت الذي قد يتم فيه إرسال طلب تأكيد إلى المستخدم.

بالإضافة إلى سلسلة العنوان، يتم تحديد تلميحات القيم المنطقية التالية على النحو التالي:

  • ‫readOnlyHint: إذا كانت القيمة صحيحة، لن تعدّل الأداة بيئتها. القيمة التلقائية: false.
  • ‫destructiveHint: إذا كانت القيمة صحيحة، يمكن للأداة تنفيذ إجراءات مدمّرة. إذا كانت القيمة "خطأ"، يمكن للأداة تنفيذ إجراءات إضافية فقط. القيمة التلقائية: true
  • idempotentHint: إذا كانت القيمة صحيحة، لن يكون لاستدعاء الأداة بشكل متكرر باستخدام الوسيطات نفسها أي تأثير إضافي على بيئتها. القيمة التلقائية: false.
  • openWorldHint: إذا كانت القيمة صحيحة، يمكن للأداة التفاعل مع "عالم مفتوح" من الكيانات الخارجية. إذا كانت القيمة خطأ، يمكن للأداة التفاعل مع الكيانات الداخلية فقط. على سبيل المثال، ستكون أداة البحث على الويب عالمًا مفتوحًا، بينما لن تكون أداة الذاكرة عالمًا مفتوحًا.

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