يشرح هذا الدليل كيفية استخدام
get()
على مصدر SpaceEvent
الخاص بـ Google Chat API للحصول على تفاصيل حول
حدث من مساحة Google Chat.
تشير رسالة الأشكال البيانية
مرجع SpaceEvent
تغييراً في مساحة أو مواردها الفرعية، مثل الرسائل
وردود الفعل والعضويات. للاطّلاع على أنواع الأحداث المتوافقة، اطّلِع على مستندات مرجع
حقل eventType
لمورد SpaceEvent
.
يمكنك طلب أحداث تصل مدتها إلى 28 يومًا قبل وقت الطلب. يحتوي الحدث
على أحدث إصدار من المرجع الذي تغيّر. على سبيل المثال، إذا
طلبت حدثًا حول رسالة جديدة ولكن تم تحديث الرسالة لاحقًا،
يعرض الخادم مورد Message
المُحدّث في حمولة الحدث.
لاستدعاء هذه الطريقة، يجب استخدام مصادقة المستخدم. للحصول على حدث، يجب أن يكون المستخدم الذي تمت مصادقته عضوًا في المساحة حيث يقع الحدث حدث.
المتطلبات الأساسية
Node.js
- حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
- إعداد البيئة:
- أنشِئ مشروعًا على Google Cloud.
- ضبط شاشة موافقة OAuth
- تفعيل Google Chat API وضبطه باستخدام اسم ورمزه ووصفه لتطبيق Chat.
- تثبيت Node.js Cloud Client Library.
-
أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق متوافق مع الكمبيوتر المكتبي. لتنفيذ النموذج في هذه
هذا الدليل، فاحفظ بيانات الاعتماد كملف JSON اسمه
client_secrets.json
في الدليل المحلي.
- اختر نطاق تفويض يتيح مصادقة المستخدم.
الحصول على تفاصيل حول حدث في الفضاء
للحصول على تفاصيل عن حدث مساحة في Google Chat، عليك تمرير ما يلي في الطلب:
- حدِّد نطاق تفويض يتيح نوع الحدث في طلبك. كإحدى أفضل الممارسات، اختر النطاق الأكثر تقييدًا الذي لا يزال يسمح من خلال هذه التطبيقات.
- استخدِم الطريقة
GetSpaceEvent()
، مع تمريرname
لحدث المساحة المطلوب الحصول عليه.
يحصل المثال التالي على حدث مساحة:
Node.js
لتشغيل هذا النموذج، استبدل ما يلي:
SCOPE_NAME
: نطاق تفويض استنادًا إلى نوع الحدث على سبيل المثال، إذا كنت تتلقّى حدثًا في مساحة متعلقًا باشتراك جديد، استخدِم نطاقchat.memberships.readonly
بالتنسيقhttps://www.googleapis.com/auth/chat.memberships.readonly
. يمكنك الحصول على نوع الحدث منListSpaceEvents()
. لمعرفة كيفية استخدام هذه الطريقة، راجع سرد أحداث من مساحةSPACE_NAME
: رقم التعريف الوارد في المساحةname
يمكنك الحصول على المعرّف من خلال استدعاء الأسلوبListSpaces()
أو من عنوان URL للمساحة.SPACE_EVENT_NAME
: رقم التعريف من الحدث الفضائيname
يمكنك الحصول على المعرّف من الوسيطةListSpaceEvents()
. لمعرفة كيفية استخدام هذه الطريقة، راجع سرد أحداث من مساحة
تعرض Chat API مثيلًا من
SpaceEvent
يتضمّن تفاصيل عن الحدث.