التطوير باستخدام Google Chat

تقدّم هذه الصفحة نظرة عامة على Google Chat API وتطبيقات Google Chat.

نظرة عامة على Google Chat API

يتألف Chat API من خدمات gRPC أو موارد وأساليب REST التي تمنح إذن الوصول إلى Chat، بما في ذلك المساحات وأعضاء المساحات والرسائل والتفاعلات مع الرسائل ومرفقات الرسائل وأحداث المساحات وحالات القراءة لدى المستخدمين.

المفاهيم

يحدّد القسم التالي الخدمات والموارد والطرق الخاصة بـ Chat API:

المساحات

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

مرجع المورد:

للاطّلاع على أمثلة على الاستخدام، يُرجى الرجوع إلى:

الأعضاء

الأعضاء هم المستخدمون وتطبيقات Chat التي انضمّت إلى مساحة أو تمت دعوتها إليها.

مرجع المورد:

للاطّلاع على أمثلة على الاستخدام، يُرجى الرجوع إلى:

الرسائل

تتضمّن الرسائل النصوص والبطاقات التي يتم نشرها في المساحات. يمكن أن تتضمّن الرسائل ملفات مرفقة. يمكن للمستخدمين التفاعل مع الرسائل من خلال إضافة رموز إيموجي إليها.

مرجع المورد:

للاطّلاع على أمثلة على الاستخدام، يُرجى الرجوع إلى:

التفاعلات

التفاعلات هي رموز الإيموجي التي يستخدمها الأشخاص للتفاعل مع رسالة، مثل 👍 و🚲 و🌞.

مرجع المورد:

للاطّلاع على أمثلة على الاستخدام، يُرجى الرجوع إلى:

رموز إيموجي مخصصة

تمثّل رموز الإيموجي المخصّصة رموز الإيموجي التي تم إنشاؤها ومشاركتها داخل المؤسسة في Google Chat. يمكن تضمين رموز الإيموجي المخصّصة في محتوى الرسالة أو استخدامها للتفاعل مع الرسالة.

مرجع المورد:

الوسائط والمرفقات

تمثّل الوسائط ملفًا تم تحميله إلى Google Chat، مثل الصور والفيديوهات والمستندات.

مرجع مورد الوسائط (غير متوفّر في استدعاء الإجراء عن بُعد):

المرفقات هي مثيلات للوسائط (الملفات) المرفقة بالرسائل.

مرجع المورد:

للاطّلاع على أمثلة على الاستخدام، يُرجى الرجوع إلى:

أحداث المساحة

تمثّل أحداث المساحة التغييرات التي تطرأ على مساحة أو مواردها الفرعية، بما في ذلك الأعضاء والرسائل والتفاعلات.

مرجع المورد:

للاطّلاع على أمثلة على الاستخدام، يُرجى الرجوع إلى:

حالات قراءة المستخدمين

حالات القراءة لدى المستخدم هي موارد فردية تمثّل تفاصيل حول آخر رسالة قرأها مستخدم محدّد في مساحة Google Chat أو سلسلة رسائل.

مرجع مورد حالة القراءة في المساحة:

مرجع مورد حالة قراءة سلسلة المحادثات:

للاطّلاع على أمثلة على الاستخدام، يُرجى الرجوع إلى:

إعدادات الإشعارات في مساحة المستخدم

إعدادات إشعارات مساحة المستخدم هي موارد فردية تمثّل إعدادات إشعارات مستخدم محدّد في مساحة Google Chat.

مرجع المورد:

المصادقة

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

لمزيد من المعلومات حول المصادقة في Chat، يُرجى الاطّلاع على نظرة عامة على المصادقة.

مكتبات العملاء

الطريقة المقترَحة لمعظم المطوّرين لاستدعاء Google Chat API هي استخدام مكتبات Cloud Client Libraries المتوافقة رسميًا مع لغتك المفضّلة، مثل Python أو Java أو Node.js.

إذا كنت تكتب الرموز البرمجية باستخدام "برمجة تطبيقات Google"، استخدِم خدمة Chat المتقدّمة بدلاً من تثبيت مكتبة برامج العميل.

إنشاء تطبيقات Chat

تتيح لك واجهة برمجة تطبيقات Chat إنشاء تطبيقات Google Chat التي تنقل خدماتك ومواردك مباشرةً إلى Google Chat. يمكنك إنشاء تطبيقات Chat لتنفيذ أيّ من الإجراءات التالية:

  • استرداد المعلومات استنادًا إلى طلبات البحث المنظَّمة أو النصية الحرة التي أدخلها المستخدم
  • إنشاء تقارير حوادث أو عناصر أخرى باستخدام المعلومات التي يقدّمها المستخدم
  • تحسين التعاون بين أعضاء الفريق، مثل توفير "ذاكرة الفريق" أو جدولة الموارد

يمكنك تصميم تطبيق Chat باستخدام عدة أنماط مختلفة للبنية، بما في ذلك ما يلي:

  • التطبيقات التفاعلية: تستجيب هذه التطبيقات لتفاعل المستخدمين، مثل الإشارات إلى مستخدمين آخرين أو استخدام الأوامر التي تبدأ بشرطة مائلة، وتعرض المعلومات أو ترشد المستخدمين خلال سير عمل باستخدام البطاقات ومربّعات الحوار.
  • تطبيقات سطر الأوامر أو خطافات الويب: إرسال رسائل استباقية، مثل المنبّهات أو الإشعارات، من نظام آخر إلى مساحة لا يمكن للمستخدمين التفاعل مباشرةً مع هذا النوع من التطبيقات.
  • التطبيقات المستندة إلى الأحداث: يمكنك الاشتراك في الأنشطة في مساحة Chat والتفاعل معها، مثل انضمام عضو جديد. واستجابةً لحدث معيّن، يمكن للتطبيق إرسال رسالة أو تنفيذ إجراء آخر.

لمعرفة تفاصيل حول تصميم تطبيق Chat، يُرجى الاطّلاع على المقالة اختيار بنية تطبيق Google Chat.

هل تريد الاطّلاع على واجهة برمجة تطبيقات Google Chat أثناء استخدامها؟
تقدّم قناة "مطوّرو Google Workspace" فيديوهات تتضمّن نصائح وحِيلاً وأحدث الميزات.