ضبط Google Chat API

يتطلب كل تطبيق من تطبيقات Google Chat التي تنشئها مشروعًا خاصًا به على Google Cloud مع تفعيل Chat API وإعداده. توضّح لك هذه الصفحة كيفية ضبط Chat API.

المتطلّبات الأساسية

ضبط Chat API

  1. في وحدة تحكُّم Google Cloud، ابحث عن "Google Chat API" وانقر على Google Chat API، ثم انقر على إدارة.

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

  2. انقر على علامة التبويب الإعداد، وأدخِل المعلومات المطلوبة التالية:

    • اسم التطبيق: الاسم الذي يستخدمه المستخدمون عند التفاعل مع تطبيق Chat.
    • عنوان URL للصورة الرمزية: هو عنوان URL يستخدم HTTPS ويوجّه المستخدمين إلى صورة رسومات مربّعة (مثل PNG أو JPEG)، وبمقاس 128×128 على الأقل، وتظهر كصورة رمزية لتطبيق Chat.
    • الوصف: وهو وصف للغرض المقصود من تطبيق Chat ويظهر أسفل اسم تطبيق Chat.

  3. لتفعيل الميزات التفاعلية، انقر على مفتاح التبديل تفعيل الميزات التفاعلية الذي يسمح للمستخدمين بالتفاعل مع تطبيق Chat واستخدام الجدول التالي لإنهاء عملية الضبط:

    الحقل الوصف
    الوظائف مجموعة من الحقول التي تحدّد الطريقة التي يمكن أن يتفاعل بها تطبيق Chat مع المستخدمين:
    • تلقّي رسائل بين شخصين: يمكن للمستخدمين العثور على تطبيق Chat ومراسلته مباشرةً في Google Chat.
    • الانضمام إلى المساحات والمحادثات الجماعية: يمكن للمستخدمين إضافة تطبيق Chat إلى المساحات والمحادثات الجماعية.
    إعدادات الربط نقطة النهاية لتطبيق Chat، وهي واحدة مما يلي:
    • عنوان URL للتطبيق: نقطة نهاية HTTPS تستضيف تنفيذ تطبيق Chat.
    • مشروع "برمجة تطبيقات Google": رقم تعريف نشر لمشروع "برمجة تطبيقات Google" الذي ينفِّذ تطبيق Chat.
    • اسم موضوع Cloud Pub/Sub: موضوع النشر/الاشتراك الذي يشترك فيه تطبيق Chat كنقطة نهاية.
    • Dialogflow: لتسجيل تطبيق Chat من خلال عملية دمج Dialogflow. لمزيد من المعلومات، راجِع إنشاء تطبيق Google Chat من Dialogflow يفهم اللغة الطبيعية.
    الأوامر التي تبدأ بشرطة مائلة الأوامر التي يمكن إظهارها للمستخدمين ضمن Google Chat يسمح هذا الإعداد للمستخدمين بالاطّلاع على الإجراءات الأساسية لتطبيق Chat في Google Chat، واختيار إجراء محدّد يريدون التفاعل معه. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الردّ على الأوامر التي تبدأ بشرطة مائلة كتطبيق في Chat.
    معاينات الروابط أنماط عناوين URL التي يتعرّف عليها تطبيق Chat ويقدّم محتوى إضافيًا عندما يرسل المستخدمون الروابط. لمزيد من المعلومات، يُرجى الاطّلاع على روابط المعاينة.
    مستوى العرض يمكن لما يصل إلى 5 أفراد أو مجموعة واحدة أو أكثر من "مجموعات Google" عرض تطبيق Chat وتثبيته. استخدِم هذا الحقل لاختبار تطبيق Chat أو لمشاركة تطبيق Chat مع فريقك. لمزيد من المعلومات، يُرجى الاطّلاع على إعدادات إذن النشر والنشر في تطبيق Chat.

  4. لتسجيل الأخطاء في Cloud Logging عندما يعرض تطبيق Chat خطأً، ضَع علامة في مربّع الاختيار تسجيل الأخطاء في التسجيل. لمزيد من المعلومات، يُرجى الاطّلاع على سجلّات أخطاء طلب البحث لتطبيقات Chat.

  5. انقر على حفظ. عند حفظ إعدادات تطبيق Chat، يصبح تطبيق Chat متاحًا للمستخدمين المحدَّدين في مؤسستك على Google Workspace.

منح المستخدمين الآخرين الإذن بضبط تطبيق Chat

يمكنك منح مستخدمين محددين إذن الوصول إلى صفحة ضبط تطبيق Chat. استخدِم دورَي "إدارة الهوية وإمكانية الوصول" مالك تطبيقات Chat وعارض تطبيقات Chat. لا يمكن للمستخدمين الذين لديهم هذه الأدوار الانتقال إلى صفحة ضبط التطبيقات في Chat باستخدام لوحة بيانات واجهات برمجة التطبيقات والخدمات، ولكن يمكنهم الوصول إلى صفحة الضبط من خلال الانتقال إلى Google Cloud Console لمشروع Cloud المضيف لتطبيق Chat على النحو التالي:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

حيث PROJECT_ID هو رقم تعريف المشروع الخاص بمشروع Google Cloud الذي يستضيف تطبيق Chat.