MCP Tools Reference: paydeveloper.googleapis.com

الأداة: create_google_pay_integration

تنشئ هذه الطريقة عملية دمج Google Pay لتاجر معيّن. تتطلّب هذه العملية أن يكون المستخدم قد وافق على بنود خدمة Business Console وبنود خدمة Google Pay API. لست بحاجة إلى التحقّق من هذه الأخطاء بشكل استباقي. إذا لم يتم قبولها، سيتعذّر تنفيذ طلب الأداة وستتضمّن رسالة الخطأ عناوين URL المحدّدة لبنود الخدمة التي يجب قبولها. في حال حدوث ذلك، اعرض عناوين URL على المستخدم ليقبلها، واطلب منه إعادة المحاولة بعد قبولها. اتّبِع التسلسل التالي للتفاعل مع المستخدم قبل استدعاء الأداة: 1. أولاً، اطلب من المستخدم تحديد عنصر الدمج (لا يتوفّر حاليًا سوى دمج الويب). - اطلب عنوان URL للموقع الإلكتروني. # - إذا كان عنصر الدمج هو دمج التطبيق، اطلب اسم حزمة تطبيق Android. 2. بعد ذلك، اطلب من المستخدم تحديد نوع الدمج: - اطلب من المستخدم اختيار "بوابة الدفع" إذا كان يستخدم أحد مقدّمي خدمات الدفع المتوافقين (https://developers.google.com/pay/api#participating-processors)، وإلا عليه اختيار "مباشر". 3- بالنسبة إلى جميع أنواع عمليات الدمج (المباشرة أو عبر البوابة): - اطلب من المستخدم تحميل لقطات شاشة (بحجم 1 ميغابايت كحد أقصى) لمسار الشراء بعد دمج واجهة برمجة تطبيقات Google Pay. يجب مراجعة مسار الشراء والموافقة عليه قبل منحهم إذنًا بالإصدار العلني. أمثلة: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - يجب أن تطلب من المستخدم تقديم 5 لقطات شاشة داعمة. اطلبها واحدة تلو الأخرى لضمان الربط الصحيح. استخدِم أوصاف التعداد سهلة الاستخدام فقط عند طرح الأسئلة. 4. إذا كان نوع الدمج هو "مباشر": - يجب أيضًا أن تطلب من المستخدم تقديم مستند شهادة الامتثال لمعيار أمان بيانات بطاقات الدفع بتنسيق PDF. استخدِم وصف التعداد السهل الاستخدام فقط عند طرح الأسئلة. 5- بالنسبة إلى كل ملف يتم تقديمه، اطلب من المستخدم تقديم مسار المستند أو اسمه إذا كان في الدليل الحالي. اربطه بـ DocumentType الصحيح واضبط حقل الاسم على اسم وصفي (مثل item_selection.png أو pci_attestation.pdf) في الطلب. لا تستخدِم هذه الأداة إلا بعد محاولة جمع المستندات المطلوبة لنوع عملية الدمج المحدّد.

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة create_google_pay_integration 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": "create_google_pay_integration",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

رسالة الطلب الخاصة بوظيفة CreateGooglePayIntegration

CreateGooglePayIntegrationRequest

تمثيل JSON 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
الحقول
merchantId

string

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

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.

مخطط الناتج

رسالة الرد على CreateGooglePayIntegration

CreateGooglePayIntegrationResponse

تمثيل JSON 
{
  "integrationState": enum (IntegrationState)
}
الحقول
integrationState

enum (IntegrationState)

حالة دمج Google Pay.

IntegrationState

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

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

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

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