تعديل إعدادات الإشعارات في مساحة أحد المستخدمين

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

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

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

Node.js

  • حساب على Google Workspace Business أو Enterprise يتيح الوصول إلى Google Chat

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

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

  • حدِّد نطاق تفويض chat.users.spacesettings.
  • استدعِ الطريقة UpdateSpaceNotificationSetting() ، مع تمرير طلب UpdateSpaceNotificationSetting الذي يحتوي على التغييرات في إعدادات الإشعارات. يتضمّن الطلب ما يلي:
    • spaceNotificationSetting مع الخصائص التالية:
      • تحدِّد السمة name إعدادات إشعارات المساحة التي تريد تعديلها، والتي تتضمّن رقم تعريف مستخدم أو اسمًا مستعارًا ورقم تعريف مساحة. لا يتيح تعديل إعدادات إشعارات المساحة إلا تعديل إعدادات الإشعارات الخاصة بالمستخدم الذي يجري الطلب، ويمكن تحديد ذلك من خلال ضبط أحد الخيارات التالية:
        • الاسم المستعار me مثلاً، users/me/spaces/SPACE/spaceNotificationSetting
        • عنوان البريد الإلكتروني في Workspace للمستخدم الذي يجري الطلب مثلاً، users/user@example.com/spaces/SPACE/spaceNotificationSetting
        • رقم تعريف المستخدم الذي يجري الطلب مثلاً، users/USER/spaces/SPACE/spaceNotificationSetting
      • notificationSetting: يضبط مستوى الإشعارات، مثل ALL أو OFF
      • muteSetting: يضبط ميزة تجاهل الإشعارات على "مفعّلة" أو "غير مفعّلة"، ويمكن أن تكون القيم MUTED أو UNMUTED
    • updateMask: يضبط حقول التعديل، ويمكن أن يتضمّن notification_setting وmute_setting

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

Node.js

chat/client-libraries/cloud/update-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 update 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 = {
    spaceNotificationSetting: {
      name: 'users/me/spaces/SPACE_NAME/spaceNotificationSetting',
      notificationSetting: 'ALL',
      muteSetting: 'UNMUTED',
    },
    updateMask: {paths: ['notification_setting', 'mute_setting']},
  };

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

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

await main();

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

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