المتطلبات الأساسية لاستخدام التطبيقات المرتبطة

قبل البدء، تأكَّد من توفّر ما يلي:

  • خادم MCP تم نشره مع نقطة نهاية HTTPS آمنة

    يجب أن يكون خادم MCP متاحًا للجميع عبر بروتوكول HTTPS باستخدام بروتوكول النقل Streamable HTTP (على سبيل المثال، https://api.yourdomain.com/v1/mcp).

    يمكنك الرجوع إلى دليل المطوّرين حول خادم MCP في "منصة التطبيقات المرتبطة" للاطّلاع على تفاصيل التنفيذ.

  • التأكّد من أنّ خادمك يمكنه تلقّي الطلبات من Google

    إذا كان الخادم يفرض قيودًا على الوصول الخارجي حسب عنوان IP المصدر، أدرِج عناوين IP التالية في القائمة المسموح بها:

    • 108.177.64.0/20
    • 142.250.88.0/22
    • 172.217.80.0/20
    • 192.178.20.0/22
    • 192.179.0.0/20
    • 74.125.232.0/24
    • 136.121.40.0/21

    يمكن أن تتغيّر نطاقات عناوين IP الصادرة من Google بمرور الوقت، لذا ننصحك بقراءتها من قوائم Google المنشورة وتحديث القائمة المسموح بها بانتظام:

  • الوصول إلى حساب مطوّر مسجَّل في وحدة التحكّم الشاملة من Google

    بعد تسجيل الدخول، تأكَّد من حصولك على أحد أذونات "ربط التطبيقات" التالية في وحدة التحكّم الشاملة من Google:

    • عرض التطبيقات المرتبطة
    • إنشاء التطبيقات المرتبطة وإدارتها

    يجب أيضًا أن يوافق صاحب الحساب أو المشرف على "بنود خدمة ربط التطبيقات". عند وصول مؤسستك لأول مرة إلى التطبيقات المرتبطة في وحدة التحكّم الشاملة من Google، يجب على صاحب الحساب أو المشرف تسجيل الدخول وقبول اتفاقية البرنامج قبل أن يتمكن أعضاء الفريق المدعوون من المتابعة.

    إذا كنت تعتقد أنّ لديك إذن الوصول ولكن لا يمكنك إنشاء تطبيقات مرتبطة، اطلب من صاحب الحساب أو المشرف منح حساب المستخدم الخاص بك إذن "عرض التطبيقات المرتبطة" أو "إنشاء التطبيقات المرتبطة وإدارتها" في صفحة المستخدمون والأذونات.

  • إمكانية استضافة ملف إثبات ملكية .well-known على نطاق خادم MCP

    لإثبات ملكية النطاق، يجب أن يكون بإمكانك عرض ملف رمز مميّز للتحقّق بتنسيق JSON مباشرةً (باستخدام HTTP 200 OK وبدون عمليات إعادة توجيه) على https://<your-domain>/.well-known/google-connected-apps.

  • مراجعة فئات التطبيقات المرتبطة المتاحة

    ترتبط فئة تطبيقك المرتبط بإمكانات محدّدة يجب أن يوفّرها لضمان تقديم تجربة مستخدم عالية الجودة. بعد اختيار فئة لتطبيق مرتبط، لا يمكن تغييرها. مزيد من المعلومات

  • خادم MCP تم نشره مع عنوان URL صالح لنقطة النهاية

    لمزيد من التفاصيل، يُرجى الرجوع إلى دليل المطوّرين حول خادم MCP للتطبيقات المرتبطة.

  • البيانات الوصفية المتاحة للجميع ومواد العرض الخاصة بالعلامة التجارية لتطبيقك المرتبط

    • اسم التطبيق المرتبط: هو الاسم المعروض لتطبيقك المرتبط والذي يظهر للمستخدمين في جميع منتجات Google، ويُستخدم عندما يشير المستخدمون إلى تطبيقك باستخدام الرمز @.
    • الوصف: ملخّص موجز من جملة واحدة (أقل من 30 كلمة) للإجراءات التي يمكن أن ينفّذها تطبيقك المرتبط للمستخدمين، مثل "تتبُّع عمليات الشراء الأخيرة والتحقّق من حالة التسليم والاطّلاع على سجلّ الطلبات".
    • الرمز: رمز تطبيق بأبعاد 512 × 512 بكسل بتنسيق JPEG أو PNG، وبحدّ أقصى لحجم الملف يبلغ 1 ميغابايت (1,024 كيلوبايت).
    • الإمكانات: يجب تحديد 3 مهام قيّمة على الأقل يمكن لتطبيقك المرتبط تنفيذها، مثل "البحث في سجلّ الطلبات" أو "التحقّق من حالة التسليم المباشرة"، بالإضافة إلى الإمكانات التلقائية المحدّدة حسب فئة تطبيقك. ستظهر هذه المعلومات للمستخدمين لمساعدتهم في اتخاذ قرار بشأن ربط التطبيق. لا تدرِج أرقامًا في بداية إمكاناتك.
    • أمثلة على الطلبات: يجب تقديم 3 نماذج على الأقل من الطلبات التي تساعد المستخدمين في فهم ما يمكنهم طلبه. ابدأ طلبَين مثاليَّين على الأقل باسم تطبيقك المرتبط. اذكر اسم تطبيقك بشكل طبيعي في طلب واحد على الأقل (أي بدون البدء باسم تطبيقك). لا تدرِج أرقامًا في بداية الطلبات النموذجية.
    • عنوان URL لبنود الخدمة: عنوان URL متاح للجميع يؤدي إلى بنود الخدمة الخاصة بتطبيقك المرتبط.
    • عنوان URL لسياسة الخصوصية: عنوان URL متاح للجميع يؤدي إلى سياسة الخصوصية الخاصة بتطبيقك المرتبط.
    • عنوان URL للموقع الإلكتروني (اختياري): موقع إلكتروني لتطبيقك المرتبط.