ضبط Google Chat API

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

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

ضبط Chat API

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

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

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

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

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

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

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

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

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

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

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

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