به روز رسانی تنظیمات اعلان فضای کاربر، به روز رسانی تنظیمات اعلان فضای کاربر، به روز رسانی تنظیمات اعلان فضای کاربر، به روز رسانی تنظیمات اعلان فضای کاربر

این راهنما نحوه استفاده از متد patch() در منبع SpaceNotificationSetting از API چت گوگل را برای به‌روزرسانی تنظیمات اعلان فضای کاربر توضیح می‌دهد.

منبع SpaceNotificationSetting یک منبع تک‌لایه است که جزئیاتی در مورد تنظیمات اعلان فضای یک کاربر مشخص را نشان می‌دهد.

پیش‌نیازها

نود جی اس

تنظیمات اعلان فضای کاربر تماس‌گیرنده را به‌روزرسانی کنید

برای به‌روزرسانی تنظیمات اعلان فضای کاربر، موارد زیر را در درخواست خود لحاظ کنید:

  • دامنه مجوز chat.users.spacesettings را مشخص کنید.
  • متد UpdateSpaceNotificationSetting() را فراخوانی کنید و درخواست UpdateSpaceNotificationSetting را برای اعمال تغییرات در تنظیمات اعلان ارسال کنید. این درخواست شامل موارد زیر است:
    • spaceNotificationSetting با ویژگی‌های زیر:
      • ویژگی name مشخص می‌کند که کدام تنظیمات اعلان فضا باید به‌روزرسانی شود که شامل شناسه کاربری یا نام مستعار و شناسه فضا می‌شود. به‌روزرسانی تنظیمات اعلان فضا فقط از به‌روزرسانی تنظیمات اعلان کاربر فراخوانی‌کننده پشتیبانی می‌کند که می‌تواند با تنظیم یکی از موارد زیر مشخص شود:
        • نام مستعار me . برای مثال، users/me/spaces/ SPACE /spaceNotificationSetting ‎‏.
        • آدرس ایمیل فضای کاری کاربر فراخوانی‌کننده. برای مثال، users/user@example.com/spaces/ SPACE /spaceNotificationSetting .
        • شناسه کاربری کاربر فراخواننده. برای مثال، users/ USER /spaces/ SPACE /spaceNotificationSetting .
      • notificationSetting : سطح اعلان را تنظیم می‌کند، مانند ALL یا OFF .
      • muteSetting : بی‌صدا کردن را فعال یا غیرفعال می‌کند، مقادیر می‌توانند MUTED یا UNMUTED باشند.
    • updateMask : فیلدهای به‌روزرسانی را تنظیم می‌کند، که می‌تواند شامل notification_setting و mute_setting باشد.

مثال زیر تنظیمات اعلان فضای کاربر فراخواننده را به‌روزرسانی می‌کند:

نود جی اس

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 فضا به دست آورید.

API چت گوگل تنظیمات اعلان فضای مشخص شده را به‌روزرسانی می‌کند و نمونه‌ای از SpaceNotificationSetting را برمی‌گرداند.