يشرح هذا الدليل كيفية استخدام طريقة
patch()
في مورد SpaceNotificationSetting
ضمن Google Chat API لتعديل
إعدادات إشعارات مساحة المستخدم.
المورد
SpaceNotificationSetting
هو مورد فردي يمثّل تفاصيل حول إعدادات الإشعارات الخاصة بمساحة مستخدم محدّد.
المتطلبات الأساسية
Node.js
- حساب Google Workspace من إصدار Business أو Enterprise مع إذن الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل واجهة Google Chat API وأعِدّها باستخدام اسم ورمز ووصف لتطبيق Chat.
- ثبِّت مكتبة برامج Cloud الخاصة بنظام Node.js.
-
أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق على جهاز كمبيوتر. لتشغيل النموذج في هذا الدليل، احفظ بيانات الاعتماد كملف JSON باسم
credentials.json
في دليلك المحلي.
- اختَر نطاق تفويض يتيح مصادقة المستخدم.
تعديل إعدادات إشعارات المساحة الخاصة بالمستخدم الذي يجري المكالمة
لتعديل إعدادات إشعارات مساحة مستخدم، أدرِج ما يلي في طلبك:
- حدِّد
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
لتشغيل هذا النموذج، استبدِل SPACE_NAME
برقم التعريف من name
الخاص بالمساحة.
يمكنك الحصول على المعرّف من خلال استدعاء الطريقة
ListSpaces()
أو من عنوان URL الخاص بالمساحة.
تعدّل واجهة Google Chat API إعدادات إشعارات المساحة المحدّدة وتعرض نسخة من SpaceNotificationSetting
.