يسرد الأحداث من مساحة Google Chat. بالنسبة إلى كل حدث، تحتوي payload على أحدث إصدار من مورد Chat. مثلاً، إذا أدرجت أحداثًا حول أعضاء المساحة الجدد، يعرض الخادم موارد Membership
التي تحتوي على أحدث تفاصيل الاشتراك. إذا تمت إزالة الأعضاء الجدد خلال الفترة المطلوبة، ستحتوي حمولة الحدث على مورد Membership
فارغ.
يتطلب مصادقة المستخدم. لإدراج الأحداث، يجب أن يكون المستخدم الذي تمت مصادقته عضوًا في المساحة.
للحصول على مثال، راجِع مقالة إدراج الأحداث من مساحة في Google Chat.
طلب HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
parent |
مطلوبة. اسم المورد في مساحة Google Chat التي وقعت فيها الأحداث التنسيق: |
معلمات طلب البحث
المَعلمات | |
---|---|
pageSize |
اختياريّ. الحد الأقصى لعدد أحداث المساحة التي تم عرضها. وقد تعرِض الخدمة أقل من هذه القيمة. تعرض القيم السالبة خطأ |
pageToken |
رمز مميّز للصفحة تم تلقّيه من مكالمة سابقة لأحداث المساحة في قائمة يُرجى توفير هذا الحقل لاسترداد الصفحة التالية. عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة لسرد أحداث المساحة مع الطلب الذي يوفّر الرمز المميّز للصفحة. وقد يؤدي تمرير قيم مختلفة إلى المعلَمات الأخرى إلى نتائج غير متوقعة. |
filter |
مطلوبة. فلتر طلبات البحث يجب تحديد نوع حدث واحد على الأقل ( يمكنك اختياريًا الفلترة أيضًا حسب وقت البدء (
لتحديد وقت البدء أو الانتهاء، استخدِم عامل التشغيل يساوي على سبيل المثال، تعد طلبات البحث التالية صالحة:
طلبات البحث التالية غير صالحة:
رفض الخادم طلبات البحث غير الصالحة مع ظهور خطأ |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة رد لإدراج أحداث المساحة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"spaceEvents": [
{
object ( |
الحقول | |
---|---|
spaceEvents[] |
يتم عرض النتائج بترتيب زمني (أول حدث أولاً). |
nextPageToken |
الرمز المميّز للمتابعة المستخدَم لاسترجاع المزيد من الأحداث. إذا تم حذف هذا الحقل، لن تكون هناك صفحات لاحقة. |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.readonly
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.readonly
https://www.googleapis.com/auth/chat.messages.reactions
https://www.googleapis.com/auth/chat.messages.reactions.readonly
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.