يوضّح هذا القسم كيف يمكن لتطبيق Google Chat الاتصال. Chat API، التي تسمح لتطبيقات Chat بتنفيذ إجراءات، مثل: إنشاء مساحة وإضافة الأشخاص إليها ونشر رسالة.
المصادقة
يتطلب استدعاء واجهة برمجة تطبيقات Chat المصادقة. على كل تتطلب طريقة Chat API أيًا مما يلي: مصادقة المستخدم (لتنفيذ الإجراءات أو الوصول البيانات نيابةً عن المستخدم) أو مصادقة التطبيقات (لتنفيذ الإجراءات أو الوصول إلى البيانات كتطبيق Chat) بعض الإشعارات مصادقة المستخدم ومصادقة التطبيقات.
لمزيد من المعلومات حول المصادقة في Chat، يُرجى الاطّلاع على نظرة عامة على المصادقة.
مكتبات العملاء
الطريقة التي ننصح بها معظم المطوّرين لطلب بيانات من Google Chat API من خلال الدعم الرسمي مكتبات عميل Cloud بلغتك المفضلة، مثل Python أو Java أو Node.js.
إذا كنت تُجري الترميز باستخدام "برمجة تطبيقات Google"، استخدِم خدمة Chat المتقدّمة بدلاً من تثبيت مكتبة برامج.
مفاهيم Google Chat API
خدمات gRPC أو موارد REST وطرقها منح إذن الوصول إلى مساحات Chat أو أعضاء المساحة أو الرسائل أو الرسائل والتفاعلات ومرفقات الرسائل وأحداث المساحات وحالات قراءة المستخدم
- المساحات
المساحات هي أماكن يمكن للمستخدمين والتطبيقات من خلالها إجراء محادثات ومشاركة الملفات. هناك عبارة عن عدة أنواع من المساحات. الرسائل المباشرة هي محادثات بين شخصين. بين مستخدمَين أو مستخدم وتطبيق Chat. مجموعة والمحادثات هي محادثات بين ثلاثة مستخدمين أو أكثر تطبيقات Chat المساحات المُعنونة هي أماكن ثابتة يرسل من خلالها المستخدمون والرسائل ومشاركة الملفات والتعاون.
مرجع الموارد:
على سبيل المثال، يمكنك الاطّلاع على ما يلي:
- الأعضاء
الأعضاء هم المستخدمون والتطبيقات في Chat التي انضمّت أو انضمت تمت دعوتهم للانضمام إلى مساحة
مرجع الموارد:
على سبيل المثال، يمكنك الاطّلاع على ما يلي:
- الرسائل
تشمل الرسائل نص أو بطاقة المراسلات المنشورة في المساحات. يمكن أن تحتوي الرسائل على ملفات مرفقة بها. يمكن للمستخدمين التفاعل مع الرسائل من خلال إضافة رموز تعبيرية إليها.
مرجع الموارد:
على سبيل المثال، يمكنك الاطّلاع على ما يلي:
- التفاعلات
تمثّل التفاعلات الرموز التعبيرية التي يستخدمها المستخدمون للتفاعل مع رسالة، مثلاً 👍 و🚲 و😅.
مرجع الموارد:
على سبيل المثال، يمكنك الاطّلاع على ما يلي:
- الوسائط والمرفقات
الوسائط هي ملف يتم تحميله إلى Google Chat، مثل الصور والفيديوهات المستندات.
مرجع موارد الوسائط (غير متوفّر في استدعاء إجراء عن بُعد):
المرفقات هي مثيلات للوسائط (الملفات) المرفقة بالرسائل.
مرجع الموارد:
على سبيل المثال، يمكنك الاطّلاع على ما يلي:
- أحداث المساحة
تمثل أحداث المساحة التغييرات التي تطرأ على المساحة أو الموارد الفرعية، بما في ذلك أعضاؤها ورسائلها وتفاعلاتها.
مرجع الموارد:
على سبيل المثال، يمكنك الاطّلاع على ما يلي:
- حالات قراءة المستخدم
حالات قراءة المستخدم هي موارد مفردة تمثل تفاصيل حول آخر رسالة مقروءة للمستخدِم المحدّد في مساحة Google Chat أو رسالة .
مرجع موارد حالة قراءة المساحة:
مرجع حالة قراءة سلسلة المحادثات:
على سبيل المثال، يمكنك الاطّلاع على ما يلي:
مواضيع ذات صلة
- استكشاف نماذج تطبيقات Google Chat من أجل بدء استخدام Chat API
بالإضافة إلى استدعاء واجهة Chat API، يمكن لتطبيقات Chat أيضًا:
- تلقّي أحداث التفاعل مع تطبيقات Chat والردّ عليها، مثل الرسائل المرسلة إلى تطبيق Google Chat، في الوقت الفعلي.
- الاشتراك في أحداث Google Chat باتخاذ إجراء أو الاستجابة عند حدوث أنشطة أو تغييرات في Chat، مثل الرسائل الجديدة تغييرات العضوية.