الحصول على إعدادات الإشعارات الخاصة بمساحة أحد المستخدمين

يشرح هذا الدليل كيفية استخدام طريقة get() في مورد SpaceNotificationSetting ضمن Google Chat API للحصول على إعدادات إشعارات مساحة المستخدم.

يمثّل المورد SpaceNotificationSetting موردًا فرديًا يعرض تفاصيل حول إعدادات الإشعارات الخاصة بمساحة مستخدم محدّد.

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

Node.js

الحصول على إعدادات إشعارات المساحة الخاصة بالمستخدم الذي يجري المكالمة

للحصول على تفاصيل حول إعدادات إشعارات مساحة مستخدم، يجب تضمين ما يلي في طلبك:

  • حدِّد chat.users.spacesettings نطاق التفويض.
  • استدعِ طريقة GetSpaceNotificationSetting() ، مع تمرير name لإعدادات إشعارات المساحة للحصول على الإعدادات التي تتضمّن معرّف مستخدم أو اسمًا مستعارًا ومعرّف مساحة. يمكنك الحصول على إعدادات الإشعارات الخاصة بالمستخدم الذي يجري المكالمة فقط. لتحديد الإعدادات، استخدِم أحد الخيارَين التاليَين:
    • الاسم المستعار me على سبيل المثال: users/me/spaces/SPACE_ID/spaceNotificationSetting.
    • عنوان البريد الإلكتروني للمستخدم المتصل على Google Workspace على سبيل المثال: users/user@example.com/spaces/SPACE_ID/spaceNotificationSetting.
    • رقم تعريف المستخدم الذي يجري المكالمة على سبيل المثال: users/USER/spaces/SPACE/spaceNotificationSetting.

يحصل المثال التالي على إعدادات إشعارات المساحة الخاصة بالمستخدم الذي يجري الاتصال:

Node.js

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

const USER_AUTH_OAUTH_SCOPES = [
  'https://www.googleapis.com/auth/chat.users.spacesettings',
];

// This sample shows how to get the space notification setting for the calling
// user
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(
    USER_AUTH_OAUTH_SCOPES,
  );

  // Initialize request argument(s), replace the SPACE_NAME with an actual space
  // name.
  const request = {
    name: 'users/me/spaces/SPACE_NAME/spaceNotificationSetting',
  };

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

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

await main();

لتشغيل هذا النموذج، استبدِل SPACE_ID برقم التعريف من مساحة name. يمكنك الحصول على المعرّف من خلال استدعاء الطريقة ListSpaces() أو من عنوان URL الخاص بالمساحة.

تحصل واجهة Google Chat API على إعدادات إشعارات المساحة المحدّدة وتعرض مثيلاً من SpaceNotificationSetting.