Benachrichtigungseinstellungen für Gruppenbereiche eines Nutzers aktualisieren

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

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

Vorbereitung

Node.js

Benachrichtigungseinstellungen für den Gruppenbereich des aufrufenden Nutzers aktualisieren

Wenn Sie die Benachrichtigungseinstellungen für einen Gruppenbereich eines Nutzers aktualisieren möchten, fügen Sie Folgendes in Ihre Anfrage ein:

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

Im folgenden Beispiel werden die Benachrichtigungseinstellungen für den Gruppenbereich 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);
}

await main();

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

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