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

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

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

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

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

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

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

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

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

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

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

مواضيع ذات صلة

• العمل مع الأحداث من Google Chat
• عرض الأحداث من مساحة على Google Chat