این راهنما نحوه استفاده از متد patch()
را در منبع SpaceNotificationSetting
در Google Chat API برای بهروزرسانی تنظیمات اعلان فضای کاربر توضیح میدهد.
منبع SpaceNotificationSetting
یک منبع تکی است که جزئیات مربوط به تنظیمات اعلان فضای مشخص شده کاربر را نشان می دهد.
پیش نیازها
- یک حساب 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
باشد.
-
مثال زیر تنظیمات اعلان فضای کاربر تماس گیرنده را به روز می کند:
برای اجرای این نمونه، SPACE_NAME
با شناسه name
فضا جایگزین کنید. شما می توانید شناسه را با فراخوانی متد ListSpaces()
یا از URL فضا بدست آورید.
Google Chat API تنظیمات اعلان فضای مشخص شده را به روز می کند و نمونه ای از SpaceNotificationSetting
را برمی گرداند.