این راهنما نحوه استفاده از متد patch() را در منبع SpaceNotificationSetting در Google Chat API برای بهروزرسانی تنظیمات اعلان فضای کاربر توضیح میدهد.
منبع SpaceNotificationSetting یک منبع تکی است که جزئیات مربوط به تنظیمات اعلان فضای مشخص شده کاربر را نشان می دهد.
پیش نیازها
Node.js
- یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه Google Cloud ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
- Node.js Cloud Client Library را نصب کنید.
- شناسه مشتری 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 را برمی گرداند.