ضبط Google Chat API

يتطلب كل تطبيق من تطبيقات Google Chat التي تنشئها مشروعًا خاصًا به على Google Cloud مع تفعيل Chat API وإعداده. توضّح لك هذه الصفحة كيفية ضبط 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 في وصف مُنشئ المساحة، كما هو موضّح في الصورة التالية:

ينشئ تطبيق Google Chat مساحة للمستخدم.
الشكل 1. رسالة الإسناد التي تعرِضها Chat عند استخدام الطريقة spaces.create() لإنشاء مساحة بالنيابة عن مستخدم

للتفاعل مع تطبيقات Chat، يمكن للمستخدمين أيضًا الاطّلاع على هذه المعلومات أو استخدامها بالطرق التالية:

  • يمكنك استدعاء تطبيق Chat من خلال الإشارة إليه باستخدام علامة @.
  • ابحث عن رسالة مباشرة وابدأها باستخدام تطبيق Chat. في قائمة التطبيقات، تعرض الرسائل المباشرة اسم تطبيق Chat وصورته الرمزية.
  • من شريط الإنشاء، يمكن للمستخدمين تصفُّح تطبيقات Chat والاطّلاع على اسمهم وصورتهم الرمزية ووصفهم.

ضبط تطبيق Chat في Google Cloud Console

عند توفّر تفاصيل تطبيق Chat، افتح مشروعك على Google Cloud واضبط واجهة برمجة التطبيقات Chat API:

  1. في Google Cloud Console، انتقِل إلى صفحة Chat API وانقر على صفحة الإعداد:

    الانتقال إلى صفحة إعدادات Chat API

  2. ضمن معلومات التطبيق، املأ حقلَي اسم التطبيق وعنوان URL للصورة الرمزية والوصف.

  3. ضمن "الميزات التفاعلية"، انقر على مفتاح التبديل تفعيل الميزات التفاعلية لإيقاف الميزات التفاعلية لتطبيق Chat. ويمكنك إعدادها لاحقًا. للتعرّف على كيفية ضبط الميزات التفاعلية وإنشائها، اطّلِع على مقالة تلقّي تفاعلات المستخدمين والاستجابة لها.

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

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

منح مستخدمين آخرين الإذن بضبط 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.