Benachrichtigungseinstellungen für Gruppenbereiche eines Nutzers aktualisieren

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

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

Vorbereitung

Node.js

Benachrichtigungseinstellungen für den anrufenden Nutzer aktualisieren

Wenn Sie die Benachrichtigungseinstellungen eines Nutzers für Gruppenbereiche aktualisieren möchten, geben Sie Folgendes in Ihrer Anfrage an:

  • Geben Sie den Autorisierungsbereich für chat.users.spacesettings an.
  • Rufe die Methode UpdateSpaceNotificationSetting() auf und übergebe die UpdateSpaceNotificationSetting-Anfrage mit den Änderungen an den Benachrichtigungseinstellungen. Die Anfrage enthält:
    • spaceNotificationSetting mit den folgenden Eigenschaften:
      • Mit dem Attribut name werden die Benachrichtigungseinstellungen für den Gruppenbereich angegeben, die aktualisiert werden sollen. Dazu gehören eine Nutzer-ID oder ein Alias und eine Gruppenbereichs-ID. Beim Aktualisieren der Benachrichtigungseinstellungen für Gruppenbereiche können nur die Benachrichtigungseinstellungen des anrufenden Nutzers aktualisiert werden. Dazu können Sie eine der folgenden Optionen festlegen:
        • Der Alias für me. Beispiel: users/me/spaces/SPACE/spaceNotificationSetting
        • Die Workspace-E-Mail-Adresse des anrufenden Nutzers. Beispiel: users/user@example.com/spaces/SPACE/spaceNotificationSetting
        • Die Nutzer-ID des anrufenden Nutzers. Beispiel: users/USER/spaces/SPACE/spaceNotificationSetting
      • Mit notificationSetting wird die Benachrichtigungsebene festgelegt, z. B. ALL oder OFF.
      • muteSetting: Hiermit wird die Stummschaltung aktiviert oder deaktiviert. Die Werte können MUTED oder UNMUTED sein.
    • updateMask: Hiermit werden die Aktualisierungsfelder festgelegt. Sie können notification_setting und mute_setting enthalten.

Im folgenden Beispiel wird die Benachrichtigungseinstellung für den anrufenden Nutzer 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);

Wenn Sie dieses Beispiel ausführen möchten, ersetzen Sie SPACE_NAME durch die ID aus der name des Gruppenbereichs. Sie können die ID durch Aufrufen der Methode ListSpaces() oder aus der URL des Gruppenbereichs abrufen.

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