Einen Google Chat-Bereich für bestimmte Nutzer in einer Google Workspace-Organisation sichtbar machen

Auf dieser Seite wird erläutert, wie Sie die Google Chat API verwenden, um einen Google Chat-Gruppenbereich für bestimmte Nutzer in einer Google Workspace-Organisation freizugeben, damit sie den Gruppenbereich finden, ihm beitreten und die Mitglieder des Gruppenbereichs sehen können.

Sie erstellen Zielgruppen, um festzulegen, welche Nutzer in Ihrer Organisation einen Gruppenbereich finden, ihm beitreten und seine Mitglieder sehen können. Eine Zielgruppe ist eine Personengruppe, z. B. bestimmte Abteilungen oder die gesamte Organisation, mit der Sie einen Chatbereich teilen können. So haben Sie eine detailliertere Kontrolle darüber, wer auf den Bereich und seine Informationen zugreifen kann. Mit Zielgruppen können Sie auch die Mitgliedschaft in Gruppenbereichen verwalten und anpassen, ohne einzelne Nutzer in einen Gruppenbereich einladen zu müssen. Weitere Informationen finden Sie unter Zielgruppen.

Sie können nur benannte Gruppenbereiche für Zielgruppen sichtbar machen. Andere Arten von Gruppenbereichen, z. B. Direktnachrichten oder Gruppenunterhaltungen, können nicht für Zielgruppen freigegeben werden.

Vorbereitung

Zielgruppen-ID abrufen

So rufen Sie die ID einer Zielgruppe ab:

  1. Rufen Sie in der Admin-Konsole das Menü  > „Verzeichnis“ > „Zielgruppen“ auf.

    Zu Zielgruppen

  2. Klicken Sie in der Tabelle Zielgruppen auf das Feld Name der Zielgruppe.

  3. Die Zielgruppen-ID finden Sie in der URL der Seite. Das URL-Format ist https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID, wobei TARGET_AUDIENCE_ID die alphanumerische ID Ihrer Zielgruppe ist.

Im nächsten Abschnitt verwenden Sie die Zielgruppen-ID, um einen Gruppenbereich mit offenem Zugang zu erstellen oder einen vorhandenen Gruppenbereich so zu aktualisieren, dass er für die Zielgruppe auffindbar ist.

Zielgruppen und detaillierte Berechtigungen angeben

Verwenden Sie zum Erstellen eines Bereichs mit bestimmten Zugriffsberechtigungen die Methode create oder setup für die Ressource Space. Verwenden Sie die Methode update, um die Berechtigungen für einen vorhandenen Gruppenbereich zu aktualisieren. Da nur benannte Bereiche für Zielgruppen freigegeben werden können, muss der Bereichstyp (im Feld spaceType) SPACE sein.

Wenn Sie festlegen möchten, wer einen Gruppenbereich finden, ihm beitreten oder seine Mitglieder ansehen kann, fügen Sie das Objekt AccessSettings in die Ressource Space ein. Geben Sie im Objekt mit dem Feld accessPermissionSettings eine oder mehrere der folgenden Berechtigungen an:

  • Auffindbar: Mit discoverSpaceSetting können Sie festlegen, wer den Namen und die Beschreibung eines Gruppenbereichs finden und in Google Chat danach suchen kann. Sie können mehrere Zielgruppen für die Ermittlung angeben.
  • Beitritt möglich: Mit joinSpaceSetting können Sie festlegen, wer einem Gruppenbereich ohne explizite Einladung beitreten und eine Vorschau der Nachrichten im Gruppenbereich ansehen kann. Nutzer, die einem Gruppenbereich beitreten können, müssen ihn auch finden können. Google Chat unterstützt für diese Berechtigung nur eine Zielgruppe.
  • Mitgliedschaft ansehen: Mit viewSpaceMembershipSetting können Sie festlegen, wer die Mitgliederliste in einem Gruppenbereich sehen darf. Wenn Sie aktualisieren, wer die Mitgliedschaft im Gruppenbereich sehen kann, muss accessSettings.accessPermissionSettings.viewSpaceMembershipSetting zusammen mit permissionSettings.viewSpaceMembership sowohl im updateMask als auch im Anfragetext angegeben werden. Wenn in viewSpaceMembershipSetting eine Zielgruppe konfiguriert ist, muss allen Mitgliedern viewSpaceMembership gewährt werden (managersAllowed, assistantManagersAllowed und membersAllowed auf true festgelegt).

Im folgenden Beispiel sehen Sie, wie Sie einen Gruppenbereich für zwei Zielgruppen sichtbar machen, ihn für nur eine Zielgruppe zugänglich machen und dafür sorgen, dass alle Mitglieder und angegebenen Zielgruppen die Mitgliederliste sehen können:

{
  "accessSettings": {
    "accessPermissionSettings": {
      "discoverSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      },
      "joinSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } }
        ]
      },
      "viewSpaceMembershipSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      }
    }
  },
  "permissionSettings": {
    "viewSpaceMembership": {
      "managersAllowed": true,
      "assistantManagersAllowed": true,
      "membersAllowed": true
    }
  }
}

Ersetzen Sie TARGET_AUDIENCE_ID_1 und TARGET_AUDIENCE_ID_2 durch die ID der Zielgruppe, die Sie unter Zielgruppen-ID abrufen erhalten haben. Wenn Sie die Standardeinstellungen für die Freigabe von Chat-Gruppenbereichen für Ihre Google Workspace-Organisation verwenden möchten, ersetzen Sie default.

Verwenden Sie zur Abwärtskompatibilität das Feld audience.

Aus Gründen der Abwärtskompatibilität können Sie weiterhin das Feld audience verwenden, um eine einzelne Zielgruppe anzugeben, die einem Bereich beitreten kann. Wir empfehlen jedoch stattdessen Zielgruppen und detaillierte Berechtigungen angeben.

Das Festlegen des Felds audience entspricht dem Angeben der Zielgruppe in joinSpaceSetting:

  "accessSettings": {
    "audience": "audiences/TARGET_AUDIENCE_ID"
  }

Ersetzen Sie TARGET_AUDIENCE_ID durch die ID der Zielgruppe, die Sie unter Zielgruppen-ID abrufen erhalten haben. Wenn Sie die Standardeinstellungen für die Freigabe von Chat-Gruppenbereichen für Ihre Google Workspace-Organisation verwenden möchten, ersetzen Sie default.

Zugriffseinstellungen in API-Antworten

Wenn Sie Gruppenbereiche abrufen oder auflisten, spiegelt das Objekt AccessSettings in der Antwort die für den Gruppenbereich festgelegten detaillierten Berechtigungen wider.

Die folgenden Felder in AccessSettings geben an, ob ein Bereich in der Suche gefunden werden kann und welche Berechtigungen zum Beitreten erforderlich sind:

  • accessState: Abgeleitet von den Berechtigungen für die Suche (discoverSpaceSetting). Wenn die Suche für eine oder mehrere Zielgruppen gewährt wird, ist dieses Feld DISCOVERABLE. Andernfalls ist es PRIVATE.
  • audience: Wird speziell den Berechtigungen für die Mitgliedschaft (joinSpaceSetting) zugeordnet. Wenn einer einzelnen Zielgruppe die Berechtigung für die Mitgliedschaft gewährt wird, enthält dieses Feld den Ressourcennamen dieser Zielgruppe.

Gruppenbereich mit offenem Zugang ohne Zielgruppe für den Beitritt

Ein Gruppenbereich ist möglicherweise für eine Zielgruppe sichtbar, der Beitritt ist aber nicht direkt möglich (z. B. wenn Nutzer explizit eingeladen werden müssen).

In diesem Fall hat das AccessSettings-Objekt die folgenden Werte:

  • accessState: DISCOVERABLE
  • audience: Ausgelassen oder null

Wenn accessState auf DISCOVERABLE festgelegt ist, aber audience nicht vorhanden ist, bedeutet das, dass der Gruppenbereich von den in discoverSpaceSetting angegebenen Zielgruppen gefunden werden kann, aber nur per Einladung beigetreten werden kann. Im Feld accessPermissionSettings.discoverSpaceSetting sehen Sie, welche Zielgruppen den Gruppenbereich finden können.

Weitere Informationen zu Zielgruppen finden Sie in den folgenden Leitfäden:

Weitere Informationen zum Erstellen oder Aktualisieren von Bereichen mit der Chat API finden Sie in den folgenden Anleitungen: