الحصول على تفاصيل عن حدث في مساحة Google Chat

يشرح هذا الدليل كيفية استخدام get() على مصدر SpaceEvent الخاص بـ Google Chat API للحصول على تفاصيل حول حدث من مساحة Google Chat.

تشير رسالة الأشكال البيانية مرجع SpaceEvent تغييراً في مساحة أو مواردها الفرعية، مثل الرسائل وردود الفعل والعضويات. للاطّلاع على أنواع الأحداث المتوافقة، اطّلِع على مستندات مرجع حقل eventType لمورد SpaceEvent .

يمكنك طلب أحداث تصل مدتها إلى 28 يومًا قبل وقت الطلب. يحتوي الحدث على أحدث إصدار من المرجع الذي تغيّر. على سبيل المثال، إذا طلبت حدثًا حول رسالة جديدة ولكن تم تحديث الرسالة لاحقًا، يعرض الخادم مورد Message المُحدّث في حمولة الحدث.

لاستدعاء هذه الطريقة، يجب استخدام مصادقة المستخدم. للحصول على حدث، يجب أن يكون المستخدم الذي تمت مصادقته عضوًا في المساحة حيث يقع الحدث حدث.

المتطلبات الأساسية

Node.js

الحصول على تفاصيل حول حدث في الفضاء

للحصول على تفاصيل عن حدث مساحة في Google Chat، عليك تمرير ما يلي في الطلب:

  • حدِّد نطاق تفويض يتيح نوع الحدث في طلبك. كإحدى أفضل الممارسات، اختر النطاق الأكثر تقييدًا الذي لا يزال يسمح من خلال هذه التطبيقات.
  • استخدِم الطريقة GetSpaceEvent() ، مع تمرير name لحدث المساحة المطلوب الحصول عليه.

يحصل المثال التالي على حدث مساحة:

Node.js

chat/client-libraries/cloud/get-space-event-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

// Replace SCOPE_NAME here with an authorization scope based on the event type
const USER_AUTH_OAUTH_SCOPES = ['SCOPE_NAME'];

// This sample shows how to get space event with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME and SPACE_EVENT_NAME here
    name: 'spaces/SPACE_NAME/spaceEvents/SPACE_EVENT_NAME'
  };

  // Make the request
  const response = await chatClient.getSpaceEvent(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

لتشغيل هذا النموذج، استبدل ما يلي:

  • 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 يتضمّن تفاصيل عن الحدث.