تحديد وحلّ مشاكل تطبيق Google Chat

يوضِّح هذا القسم المشاكل الشائعة التي قد تواجهها أثناء إنشاء تطبيقات Chat واختبارها.

عدم ظهور رسالة البطاقة أو مربّع الحوار أو معاينة الرابط أو عدم عملها على النحو المتوقّع

للحصول على مساعدة في تحديد مشاكل البطاقات وحلّها، يُرجى الاطّلاع على تحديد المشاكل في البطاقات وحلّها.

التطبيق لا يستجيب

في حال مراسلة تطبيق Chat وظهرت رسالة "التطبيق لا يستجيب": تحقَّق من إعدادات تطبيق Chat:

  1. في وحدة تحكُّم Google Cloud، انقر على القائمة > مزيد من المنتجات > Google Workspace > مكتبة المنتجات > Google Chat API > إدارة > الإعداد.

    الانتقال إلى Chat API

  2. ضمن حالة التطبيق، تأكَّد من اختيار مباشر - متاح للمستخدمين.

  3. ضمن الميزات التفاعلية، تأكَّد من أنّ الإعدادات مناسبة لوظائف تطبيقك. إذا كان تطبيقك في Chat يتفاعل مع المستخدمين، تأكَّد من تفعيل تفعيل الميزات التفاعلية:

    1. في حال كان تطبيقك يستجيب للرسائل، تأكّد من اختيار تلقّي الرسائل بين شخصين.
    2. ضمن إعدادات الربط، تأكَّد من ضبط عنوان URL للتطبيق أو رقم تعريف النشر لمشروع "برمجة التطبيقات" أو اسم موضوع Cloud Pub/Sub أو وكيل Dialogflow بشكلٍ صحيح ومن نشره.
    3. ضمن مستوى الرؤية، تأكَّد من إمكانية وصول المستخدمين المناسبين إلى التطبيق باستخدام عنوان البريد الإلكتروني أو مجموعة في نطاق Google Workspace. في حال نشر التطبيق باستخدام حزمة تطوير البرامج (SDK) في Google Workspace Marketplace، لن تكون إعدادات مستوى الوصول ضرورية لأنّ إعدادات Google Workspace Marketplace لها الأولوية.

  4. إذا تم نشر التطبيق باستخدام حزمة تطوير البرامج (SDK) في Google Workspace Marketplace، راجِع إعدادات Google Workspace Marketplace.

  5. انقر على حفظ.

  6. جرِّب مراسلة التطبيق مرة أخرى.

لا تتوفّر واجهة Google Chat API إلا لمستخدمي Google Workspace.

عند ضبط تطبيق Chat، قد تتلقّى الخطأ Google Chat API is only available to Google Workspace users. هذه الرسالة أن حساب Google الذي استخدمته لتهيئة إنّ واجهة Chat API ليست جزءًا من مؤسسة في Google Workspace. لإنشاء في تطبيق Chat أو في Chat API، عليك استخدام Google Workspace الحساب.

تجدر الإشارة إلى أنه يمكن لمستخدمي Google Chat استخدام تطبيقات Chat بدون Google Workspace. مزيد من المعلومات حول كيفية عثور المستخدمين على تطبيقك وتثبيته التطبيقات في Chat، يُرجى الاطّلاع على النشر تطبيقات Google Chat

يمكن استبعاد المستخدمين من المساحات.

إذا منع مشرف Google Workspace المستخدمين من تفعيل سجلّ Chat أو إيقافه، قد لا يتمكّن المستخدمون في بعض الأحيان من الانضمام إلى مساحة أو البقاء فيها بسبب تعارض بين إعداد على مستوى المستخدم يفرض تفعيل سجلّ المحادثات أو إيقافه ومساحة تكتسب الإعداد المفروض على مستوى المؤسسة.

على سبيل المثال، إذا تم فرض "تفعيل" على إعداد "سجلّ المحادثات" لدى المستخدم. إذا تم فرض "إيقاف" إعداد "سجلّ المحادثات" على مساحة، قد لا يتمكّن هذا المستخدم من الانضمام إلى المساحة. بالإضافة إلى ذلك، قد تتم إزالة هذا المستخدم من المساحة إذا كان قد انضم قبل التعارض، ثم ينشر رسالة في المساحة بعد التعارض.

في هذا السيناريو، بالإضافة إلى السيناريوهات الأخرى التي يحدث فيها تعارض بين إعدادات السجلّ، قد لا تتمكّن واجهة Chat API من إنشاء اشتراك، أو قد يؤدي إنشاء رسالة بمصادقة المستخدم إلى إزالة المستخدم الذي تمت مصادقته باستخدام إعداد سجلّ Chat متعارض من المساحة.

لمزيد من المعلومات، يمكنك الاطّلاع على مقالة يمكن استبعاد المستخدمين من المساحات في مركز مساعدة مشرف Google Workspace.

تحديد وحلّ المشاكل المتعلّقة بخدمة Chat Advanced في "برمجة تطبيقات Google"

راجِع صفحة "برمجة تطبيقات Google" حول خدمة Chat المتقدّمة

لا يمكن للمستخدمين إضافة تطبيق Chat إلى مساحة

في حال ظهور رسالة الخطأ للمستخدمين This organization's administrator must allow users to install this Chat app عند محاولة إضافة تطبيق Chat إلى مساحة، سيظهر هذا الخطأ إلى أحد الأسباب التالية:

  • أوقفت المؤسسة التطبيقات في Chat.
  • لم تضف المؤسسة هذه القيمة المحدّدة إضافة تطبيق Chat إلى القائمة المسموح بها للمؤسسة

إذا ظهرت للمستخدم رسالة الخطأ هذه عند محاولة التفاعل مع تطبيق Chat، قد يكون بسبب المؤسسة التي تمنح وحدة تنظيمية فرعية، دون تفعيلها الوحدة التنظيمية الرئيسية.

للحصول على معلومات حول كيفية حل هذه المشكلة، يمكنك الاطّلاع على السماح للمستخدمين بتنزيل تطبيقات Chat

تحديد مشاكل Cloud Function وحلّها

في حال تنفيذ تطبيق Chat باستخدام دوال Cloud إذا كان التطبيق لا يعمل، تساعدك الأقسام التالية في تحديد المشكلة وحلّها.

مراجعة سجلات Cloud Function

كخطوة أولى، يُرجى التحقّق من سجلّات Cloud Functions بحثًا عن الأخطاء.

  1. في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة "وظائف السحابة الإلكترونية":

    الانتقال إلى وظائف السحابة الإلكترونية

  2. لفتح السجلّات، ابحث عن السحابة الإلكترونية في تطبيق Chat. الدالة، ثم انقر على عرض الإجراءات > عرض السجلات.

يفتح مستكشف السجلات ويشغِّل طلب بحث يعرض سجلات دوال السحابة، بما في ذلك الأخطاء.

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

التحقّق من أخطاء دوال السحابة

بخلاف السجلات، قد تقوم Cloud Function أيضًا بالإبلاغ عن الأخطاء التي حدثت أثناء الجري.

  1. في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة "وظائف السحابة الإلكترونية":

    الانتقال إلى وظائف السحابة الإلكترونية

  2. انقر على دالة Cloud في تطبيق Chat.

  3. في صفحة "تفاصيل الدالة"، يتم إدراج الأخطاء ضمن الأخطاء.

  4. لتحديد الخطأ وإصلاحه، انقر عليه.

إصلاح الأخطاء الشائعة في دوال السحابة

تحدث الأخطاء التالية أحيانًا عند إنشاء تطبيق Chat مع دوال Cloud

الدالة ChatApp في المنطقة REGION_NAME من المشروع PROJECT_NAME متوفّرة حاليًا.

عند نشر دالة Cloud، قد يظهر لك الخطأ Function ChatApp in region REGION_NAME in project PROJECT_NAME already exists. تعني هذه الرسالة أن دالة السحابة الإلكترونية الأخرى لها الاسم نفسه الذي تقوم بنشره. تغيير الاسم نشر الدالة مرة أخرى. التحقّق من أنّ تطبيق Chat يستخدم عنوان URL المشغِّل في لوظيفة السحابة الإلكترونية، وليس عنوان URL المشغِّل لدالة السحابة الإلكترونية الموجودة مسبقًا.

مستخدم واحد أو أكثر مذكور في السياسة لا ينتمي إلى عميل مسموح به

عند نشر دالة Cloud، قد تظهر لك رسالة الخطأ The operation cannot be completed on the function: "One or more users named in the policy do not belong to a permitted customer." إذا ظهر لك هذا الخطأ، ثم تم إرسال رسالة إلى تطبيق Chat، ستظهر لك رسالة خطأ تفيد بأنّ التطبيق لا يستجيب لأنّ Google يتعذّر على تطبيق Chat الوصول إلى الخادم الذي يستضيف دالّة السحابة الإلكترونية. تعني هذه الرسالة أن مستخدم باسم "allUsers" ليس لديه إذن لاستدعاء دالة السحابة الإلكترونية. منح "allUsers" "مُستدعي Cloud Functions" المستخدم يعني أن السحابة تكون الوظيفة التي تُشغِّل التطبيق متاحة للجميع ويمكن الوصول إليها بدون المصادقة. لمعرفة كيفية تعيين دور، راجع منح دور واحد:

قد يعني هذا الخطأ أنّ مشروع Google Cloud مقيَّد بالنطاق. بالنسبة مزيد من المعلومات حول قيود تقييد المجال، راجع تقييد الهويات حسب النطاق.

لحل هذه المشكلة، تأكَّد من أن Cloud Function تسمح بعدم المصادقة. ذات الصلة. لمعرفة كيفية السماح بالاستدعاءات غير المعتمدة لقائمة لدالة السحابة الإلكترونية، راجِع السماح بالوصول العلني (غير المُصدَّق عليه).