Aggiornare le impostazioni di notifica dello spazio di un utente

Questa guida spiega come utilizzare il metodo patch() nella risorsa SpaceNotificationSetting dell'API Google Chat per aggiornare le impostazioni di notifica di uno spazio di un utente.

La risorsa SpaceNotificationSetting è una risorsa singleton che rappresenta i dettagli delle impostazioni di notifica dello spazio di un utente specifico.

Prerequisiti

Node.js

Aggiornare le impostazioni di notifica dello spazio dell'utente che chiama

Per aggiornare l'impostazione di notifica di uno spazio di un utente, includi quanto segue nella richiesta:

  • Specifica l'ambito di autorizzazione chat.users.spacesettings.
  • Chiama il metodo UpdateSpaceNotificationSetting(), passando la richiesta UpdateSpaceNotificationSetting per contenere le modifiche alle impostazioni di notifica. La richiesta include:
    • spaceNotificationSetting con le seguenti proprietà:
      • La proprietà name specifica quali impostazioni di notifica dello spazio aggiornare, inclusi un ID utente o un alias e un ID spazio. L'aggiornamento delle impostazioni di notifica dello spazio supporta solo l'aggiornamento delle impostazioni di notifica dell'utente chiamante, che può essere specificato impostando uno dei seguenti valori:
        • L'alias me. Ad esempio, users/me/spaces/SPACE/spaceNotificationSetting.
        • L'indirizzo email Workspace dell'utente che chiama. Ad esempio, users/user@example.com/spaces/SPACE/spaceNotificationSetting.
        • L'ID utente dell'utente chiamante. Ad esempio, users/USER/spaces/SPACE/spaceNotificationSetting.
      • notificationSetting: imposta il livello di notifica, ad esempio ALL, OFF.
      • muteSetting: attiva o disattiva la disattivazione dell'audio. I valori possono essere MUTED o UNMUTED.
    • updateMask: imposta i campi di aggiornamento, può includere notification_setting, mute_setting.

L'esempio seguente aggiorna l'impostazione di notifica dello spazio dell'utente chiamante:

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);

Per eseguire questo esempio, sostituisci SPACE_NAME con l'ID dello spazio name. Puoi ottenere l'ID chiamando il metodo ListSpaces() o dall'URL dello spazio.

L'API Google Chat aggiorna le impostazioni di notifica dello spazio specificato e restituisce un'istanza di SpaceNotificationSetting.