ضبط Google Chat API

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

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

اختَر اسمًا معروضًا وصورة رمزية ووصفًا لتطبيق Chat.

لاستدعاء Chat API، عليك إعداد تطبيق 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

عند الحصول على تفاصيل تطبيق Chat، افتح مشروع على Google Cloud وإعداد Chat API:

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

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

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

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

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

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

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

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

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

حيث PROJECT_ID هو رقم تعريف مشروع مشروع على Google Cloud يستضيف تطبيق Chat