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

يوضّح هذا الدليل كيفية استخدام الأسلوب get() في مورد SpaceEvent لواجهة برمجة تطبيقات Google Chat للحصول على تفاصيل عن حدث من مساحة 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 يتضمّن تفاصيل عن الحدث.