يتطلّب كل تطبيق من تطبيقات Google Chat التي تنشئها مشروعًا على Google Cloud مع تفعيل واجهة برمجة التطبيقات Chat API وضبطها. توضّح لك هذه الصفحة كيفية ضبط Chat API.
المتطلبات الأساسية
- حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
- أنشئ مشروعًا على Google Cloud.
- إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- تفعيل Google Chat API
اختيار اسم معروض وصورة رمزية ووصف لتطبيق Chat
للاتصال بواجهة برمجة تطبيقات Chat، عليك إعداد تطبيق Google Chat يتضمّن المعلومات التالية:
| الحقل | الوصف | التنسيق |
|---|---|---|
| اسم التطبيق | الاسم المعروض لتطبيق Chat | ما يصل إلى 25 حرفًا أبجديًا رقميًا |
| عنوان URL للأفاتار | الصورة التي تظهر كأفاتار تطبيق Chat | عنوان URL يستخدم بروتوكول HTTPS ويشير إلى صورة رسومات مربّعة (بتنسيق PNG أو JPEG). الحجم المُقترَح هو 256 × 256 بكسل أو أكثر. |
| الوصف | وصف موجز لهدف تطبيق Chat | ما يصل إلى 40 حرفًا أبجديًا رقميًا |
يتم عرض اسم تطبيق Chat وصورته الرمزية ووصف التطبيق للمستخدمين في واجهة مستخدم Chat. بالنسبة إلى بعض طلبات المحتوى في Chat API، يستخدم Chat هذه المعلومات لتحديد مصدر الإجراءات التي يتّخذها تطبيق Chat في Chat.
على سبيل المثال، إذا طلبت الطريقة spaces.create()، يُدرِج Chat اسم تطبيق Chat في وصف مُنشئ المساحة، كما هو موضّح في الصورة التالية:
spaces.create() لإنشاء
مساحة بالنيابة عن مستخدم
للتفاعل مع تطبيقات Chat، يمكن للمستخدمين أيضًا الاطّلاع على هذه المعلومات أو استخدامها بالطرق التالية:
- يمكنك استدعاء تطبيق Chat من خلال الإشارة إليه باستخدام علامة @.
- ابحث عن رسالة مباشرة وابدأها باستخدام تطبيق Chat. في قائمة التطبيقات، تعرض الرسائل المباشرة اسم تطبيق Chat وصورته الرمزية.
- من شريط الإنشاء، يمكن للمستخدمين تصفُّح تطبيقات Chat والاطّلاع على اسمهم وصورتهم الرمزية ووصفهم.
ضبط تطبيق Chat في Google Cloud Console
بعد الحصول على تفاصيل تطبيق Chat، افتح مشروعك على Cloud وضبط Chat API:
في وحدة تحكّم Google Cloud، انتقِل إلى صفحة Chat API وانقر على صفحة الإعدادات:
ضمن معلومات التطبيق، املأ حقلَي اسم التطبيق وعنوان URL للصورة الرمزية والوصف.
ضمن "الميزات التفاعلية"، انقر على مفتاح التبديل تفعيل الميزات التفاعلية لإيقاف الميزات التفاعلية لتطبيق Chat. ويمكنك إعدادها لاحقًا. للتعرّف على كيفية ضبط الميزات التفاعلية وإنشائها، اطّلِع على مقالة تلقّي تفاعلات المستخدمين والاستجابة لها.
اختياري: ضمن السجلّات، ضَع علامة في مربّع الاختيار تسجيل الأخطاء في "سجلّات Google" ل استخدام "سجلّات Google Cloud". لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الاطّلاع على سجلّات أخطاء طلب البحث في تطبيقات Chat.
انقر على حفظ.
منح مستخدمين آخرين الإذن بضبط Chat API
يمكنك منح مستخدمين معيّنين إذن الوصول إلى صفحة ضبط تطبيق Chat من خلال منحهم دور "مالك تطبيقات Chat" أو دور "عارض تطبيقات Chat" دور "إدارة الوصول في Google Cloud Identity" (IAM). لا يمكن للمستخدمين الذين لديهم هذه الأدوار الانتقال إلى صفحة ملف تعريف العميل في تطبيقات 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.
مواضيع ذات صلة
- اختيار بنية تطبيق Chat
- لضبط تطبيق Chat لاستخدام الميزات التفاعلية، اطّلِع على مقالة تلقّي تفاعلات المستخدمين والردّ عليها.