ضبط Google Chat API

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

لتنفيذ طلبات البيانات من واجهة برمجة التطبيقات للقراءة فقط باستخدام مصادقة المستخدم، مثل الحصول على المساحات وإدراج الرسائل، ما عليك سوى تفعيل واجهة برمجة التطبيقات وإنشاء عميل OAuth.

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

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

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

عند تفعيل Chat API، يمكنك ضبط التفاصيل الخاصة بتطبيق Chat والتي تظهر للمستخدمين في Chat، بما في ذلك الاسم المعروض والصورة الرمزية والوصف. لا تظهر هذه التفاصيل إلا في "المحادثة". لنشر تطبيق Chat على Marketplace، يجب أيضًا تحديد التفاصيل التي تظهر في بطاقة بيانات Marketplace الخاصة بتطبيق 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 Console

بعد الحصول على تفاصيل تطبيق Chat، افتح مشروعك على السحابة الإلكترونية واضبط إعدادات Chat API باتّباع الخطوات التالية:

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

    الانتقال إلى صفحة "إعدادات واجهة برمجة تطبيقات Chat"

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

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

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

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

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

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

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

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