Benachrichtigungseinstellungen für Gruppenbereiche eines Nutzers aktualisieren

In diesem Leitfaden wird beschrieben, wie Sie die Methode patch() für die Ressource SpaceNotificationSetting der Google Chat API verwenden, um die Benachrichtigungseinstellungen für Gruppenbereiche eines Nutzers zu aktualisieren.

Die SpaceNotificationSetting-Ressource ist eine Singleton-Ressource, die Details zu den Benachrichtigungseinstellungen eines bestimmten Nutzers für einen Bereich enthält.

Vorbereitung

Node.js

Benachrichtigungseinstellungen für den Gruppenbereich des anrufenden Nutzers aktualisieren

Wenn Sie die Benachrichtigungseinstellung eines Nutzers für einen Bereich aktualisieren möchten, fügen Sie Ihrer Anfrage Folgendes hinzu:

  • Geben Sie den chat.users.spacesettings-Autorisierungsbereich an.
  • Rufen Sie die Methode UpdateSpaceNotificationSetting() auf und übergeben Sie die UpdateSpaceNotificationSetting-Anfrage mit den Änderungen an den Benachrichtigungseinstellungen. Die Anfrage enthält:
    • spaceNotificationSetting mit den folgenden Eigenschaften:
      • Mit dem Attribut name wird angegeben, welche Benachrichtigungseinstellungen für Bereiche aktualisiert werden sollen. Dazu gehören eine Nutzer-ID oder ein Alias und eine Bereichs-ID. Beim Aktualisieren der Benachrichtigungseinstellungen für Gruppenbereiche werden nur die Benachrichtigungseinstellungen des anrufenden Nutzers aktualisiert. Diese können durch Festlegen einer der folgenden Optionen angegeben werden:
        • Der Alias me. Beispiel: users/me/spaces/SPACE/spaceNotificationSetting
        • Die Google Workspace-E-Mail-Adresse des anrufenden Nutzers. Beispiel: users/user@example.com/spaces/SPACE/spaceNotificationSetting
        • Die Nutzer-ID des aufrufenden Nutzers. Beispiel: users/USER/spaces/SPACE/spaceNotificationSetting
      • Mit notificationSetting wird die Benachrichtigungsstufe festgelegt, z. B. ALL oder OFF.
      • Mit muteSetting wird die Stummschaltung aktiviert oder deaktiviert. Die Werte können MUTED oder UNMUTED sein.
    • updateMask: Legt die zu aktualisierenden Felder fest. Dies können notification_setting und mute_setting sein.

Im folgenden Beispiel wird die Benachrichtigungseinstellung für Gruppenbereiche des aufrufenden Nutzers aktualisiert:

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

Ersetzen Sie SPACE_NAME durch die ID aus der name des Bereichs, um dieses Beispiel auszuführen. Sie können die ID abrufen, indem Sie die Methode ListSpaces() aufrufen oder die URL des Bereichs verwenden.

Die Google Chat API aktualisiert die angegebenen Benachrichtigungseinstellungen für den Gruppenbereich und gibt eine Instanz von SpaceNotificationSetting zurück.