يوضّح هذا القسم كيفية استدعاء تطبيق Google Chat لواجهة برمجة التطبيقات Chat API، التي تتيح لتطبيقات Chat تنفيذ إجراءات مثل إنشاء مساحة وإضافة مستخدمين إليها ونشر رسالة.
المصادقة
يتطلب الاتصال بواجهة برمجة التطبيقات Chat API المصادقة. تتطلّب كل طريقة في Chat API إما مصادقة المستخدم (لتنفيذ الإجراءات أو الوصول إلى البيانات نيابةً عن المستخدم) أو مصادقة التطبيق (لتنفيذ الإجراءات أو الوصول إلى البيانات بصفتك تطبيق Chat). تتيح بعض methods مصادقة المستخدم ومصادقة التطبيق.
لمزيد من المعلومات عن المصادقة في 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 أو سلسلة رسائل.
مرجع مورد حالة قراءة المساحة:
مرجع مورد حالة قراءة سلسلة المحادثات:
لمعرفة أمثلة على الاستخدام، يُرجى الاطّلاع على:
- إعدادات الإشعارات في مساحة المستخدم (إصدار تجريبي للمطوّرين)
إعدادات إشعارات المستخدمين في المساحة هي موارد فردية تمثّل إعدادات إشعارات مستخدم محدّدة في مساحة Google Chat.
مرجع المورد:
مواضيع ذات صلة
- استكشِف نماذج تطبيقات Google Chat لبدء استخدام Chat API.
بالإضافة إلى طلب بيانات من Chat API، يمكن لتطبيقات Chat أيضًا تنفيذ ما يلي:
- تلقّي أحداث التفاعل في تطبيق Chat والردّ عليها، مثل الرسائل المُرسَلة إلى تطبيق Google Chat، في الوقت الفعلي
- الاشتراك في أحداث Google Chat لاتخاذ إجراء أو الردّ عند حدوث أنشطة أو تغييرات معيّنة في Chat، مثل الرسائل الجديدة و تغييرات العضوية