يوضّح هذا القسم كيف يمكن لتطبيق Google Chat الاتصال. Chat API، التي تسمح لتطبيقات Chat بتنفيذ إجراءات، مثل: إنشاء مساحة وإضافة مستخدمين إليها ونشر رسالة بدون أن يُطلب منك ذلك حدث التفاعل مع تطبيق Chat
المصادقة
يتطلب الاتصال بواجهة برمجة تطبيقات Chat بشكل غير متزامن المصادقة. على كل تتطلب طريقة Chat API أيًا مما يلي: مصادقة المستخدم (لتنفيذ الإجراءات أو الوصول البيانات نيابةً عن المستخدم) أو مصادقة التطبيقات (لتنفيذ الإجراءات أو الوصول إلى البيانات كتطبيق Chat) بعض الإشعارات مصادقة المستخدم ومصادقة التطبيقات.
لمزيد من المعلومات حول المصادقة في Chat، يُرجى الاطّلاع على نظرة عامة على المصادقة.
موارد واجهة برمجة التطبيقات وطرقها
تمنح موارد REST وطرقها إمكانية الوصول غير المتزامن إلى Chat. المساحات وأعضاء المساحة والرسائل والتفاعلات مع الرسائل ومرفقات الرسائل
- المساحات
المساحات هي أماكن يمكن للمستخدمين والتطبيقات من خلالها إجراء محادثات ومشاركة الملفات. هناك عبارة عن عدة أنواع من المساحات. الرسائل المباشرة هي محادثات بين شخصين. بين مستخدمَين أو مستخدم وتطبيق Chat. مجموعة والمحادثات هي محادثات بين ثلاثة مستخدمين أو أكثر تطبيقات Chat المساحات المُعنونة هي أماكن ثابتة يرسل من خلالها المستخدمون والرسائل ومشاركة الملفات والتعاون.
تشير رسالة الأشكال البيانية مرجع
spaces
يمثل مساحة.تتيح ميزة "مساحات" الطرق التالية:
- إنشاء مساحة، هو مكان يمكن فيه للأشخاص والتطبيقات التحدّث عن الملفات ومشاركتها.
- إعداد مساحة لإنشاء المساحة وإضافة المستخدمين والتطبيقات في Chat إليها مساحة.
- الحصول على مساحة للاطّلاع على التفاصيل حول المساحة.
- مساحات العمل للاطّلاع على قائمة المساحات المقسّمة والقابلة للفلترة
- تعديل مساحة لتغيير السمات الخاصة بأي مساحة، مثل الاسم المعروض المرئي للمستخدم ووصفها وإرشاداتها.
- حذف مساحة عندما لا تعود هناك حاجة إليه.
- العثور على رسالة مباشرة لعرض رسالة مباشرة بين مستخدمَين أو رسالة مباشرة بين مستخدم ومتصل تطبيقات Chat
- الأعضاء
الأعضاء هم المستخدمون والتطبيقات في Chat التي انضمّت أو انضمت تمت دعوتهم للانضمام إلى مساحة
تشير رسالة الأشكال البيانية مرجع
spaces.members
ويمثل عضوًا.يتيح الأعضاء استخدام الطرق التالية:
- إنشاء عضوية إضافة مستخدم أو تطبيق إلى مساحة
- الاشتراك للاطّلاع على تفاصيل حول العضوية
- عضويات في القائمة للاطّلاع على قائمة العضويات القابلة للفلترة والمقسّمة إلى صفحات في المساحة.
- تعديل اشتراك تغيير السمات المتعلقة بعضوية، مثل تغيير عضو في مساحة إلى أو مدير مساحة أو تغيير مدير مساحة إلى عضو في المساحة
- حذف اشتراك إزالة مستخدم أو تطبيق من مساحة.
- الرسائل
تشمل الرسائل نص أو بطاقة المراسلات المنشورة في المساحات. يمكن أن تحتوي الرسائل على ملفات مرفقة بها. يمكن للمستخدمين التفاعل مع الرسائل من خلال إضافة رموز تعبيرية إليها.
تشير رسالة الأشكال البيانية مرجع
spaces.messages
يمثل رسالة.يتيح تطبيق "الرسائل" الطرق التالية:
- إنشاء رسالة لنشر نص أو رسالة بطاقة. يمكنك أيضًا بدء سلسلة رسائل أو الرد عليها
- تلقّي رسالة للحصول على تفاصيل حول رسالة، مثل وقت إرسالها أو مضمونها.
- إدراج الرسائل للاطّلاع على قائمة رسائل مقسّمة إلى صفحات قابلة للفلترة في مساحة
- تعديل رسالة تغيير سمات الرسائل، مثل ما تتضمنه الرسالة. يمكنك أيضًا إلحاق نص إلى رسالة بطاقة، أو بطاقة إلى رسالة نصية.
- حذف رسالة عندما لا تعود هناك حاجة إليه.
- التفاعلات
تمثّل التفاعلات الرموز التعبيرية التي يستخدمها المستخدمون للتفاعل مع رسالة، مثلاً 👍 و🚲 و😅.
تشير رسالة الأشكال البيانية مرجع
spaces.messages.reactions
يمثل تفاعلاً.تدعم التفاعلات الطرق التالية:
- إنشاء تفاعل لإلحاق رمز تعبيري برسالة.
- سرد التفاعلات لعرض قائمة بالتفاعلات مع رسالة مقسَّمة إلى صفحات وقابلة للفلترة.
- حذف تفاعل لإزالة رمز تعبيري من الرسالة.
- الوسائط والمرفقات
الوسائط هي ملف يتم تحميله إلى Google Chat، مثل الصور والفيديوهات المستندات.
تشير رسالة الأشكال البيانية مرجع
media
يمثل الوسائط المرفقة بالرسائل.المرفقات هي مثيلات للوسائط (الملفات) المرفقة بالرسائل.
تشير رسالة الأشكال البيانية مرجع
spaces.messages.attachments
يمثل مرفقًا. يتضمن المرفق الوسائط والعناصر المرتبطة البيانات الوصفية المرفقة بالرسالة.تتيح الوسائط والمرفقات الطرق التالية:
- تحميل وسائط كمرفق بتحميل الوسائط إلى Google Chat وإرفاقها برسالة
- تنزيل الوسائط كمرفق لتنزيل الوسائط من Google Chat كملف ثنائي.
- الحصول على مرفق لاسترداد البيانات الوصفية حول مرفق رسالة.
- أحداث المساحة
تمثل أحداث المساحة التغييرات التي تطرأ على المساحة أو الموارد الفرعية، بما في ذلك أعضاؤها ورسائلها وتفاعلاتها.
مرجع
spaces.spaceEvent
يمثل حدثًا في الفضاء.تتيح أحداث المساحة استخدام الطرق التالية:
- الحصول على حدث مساحة لعرض تفاصيل حول حدث وقع في إحدى المساحات.
- سرد أحداث المساحة للحصول على قائمة بالأحداث التي حدثت في مساحة.
- حالات قراءة المستخدم
حالات قراءة المستخدم هي موارد مفردة تمثل تفاصيل حول آخر رسالة مقروءة للمستخدِم المحدّد في مساحة Google Chat أو رسالة .
مرجع
users.spaces
يمثل حالة القراءة للمستخدم في المساحة.مرجع
users.spaces.threads
يمثل حالة القراءة للمستخدم في سلسلة رسائل.تتوافق حالات قراءة المستخدم مع الطرق التالية:
- الحصول على حالة القراءة في المساحة لعرض تفاصيل حول حالة القراءة للمستخدم داخل مساحة
- تعديل حالة قراءة المساحة لتعديل حالة القراءة للمستخدم داخل مساحة
- الحصول على حالة قراءة سلسلة المحادثات لعرض تفاصيل حول حالة قراءة المستخدم ضمن سلسلة محادثات.