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

يشرح هذا الدليل كيفية استخدام الأسلوب 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);
}

main().catch(console.error);

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

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