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

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

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

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

Node.js

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

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

  • حدِّد 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.