جزئیات یک رویداد فضایی Google Chat را دریافت کنید

این راهنما نحوه استفاده از متد get() را در منبع SpaceEvent در Google Chat API برای دریافت جزئیات یک رویداد از فضای چت Google توضیح می‌دهد.

منبع 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 را با جزئیات مربوط به رویداد برمی گرداند.