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