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

Auf dieser Seite wird beschrieben, wie Sie die Google Chat API verwenden, um einen Google Chat-Bereich für bestimmte Nutzer in einer Google Workspace-Organisation freizugeben, damit sie den Bereich finden und ihm beitreten können.

Sie erstellen Zielgruppen, um festzulegen, welche Nutzer in Ihrer Organisation einen Gruppenbereich finden und ihm beitreten können. Eine Zielgruppe ist eine Gruppe von Personen, z. B. bestimmte Abteilungen oder die gesamte Organisation, mit denen Sie einen Chatbereich teilen können, um die Bekanntheit und Freigabefähigkeit des Bereichs zu verbessern. Mit Zielgruppen können Sie auch Mitgliedschaften in Gruppenbereichen verwalten und anpassen, ohne einzelne Nutzer in einen Gruppenbereich einladen zu müssen. Weitere Informationen finden Sie unter Zielgruppen.

Sie können benannte Gruppenbereiche nur 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. Gehen Sie in der Admin-Konsole zum Menü  > „Verzeichnis“ > „Zielgruppen“.

    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 lautet 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 entweder einen auffindbaren Gruppenbereich zu erstellen oder einen vorhandenen Gruppenbereich so zu aktualisieren, dass er für die Zielgruppe auffindbar ist.

Zielgruppen und detaillierte Berechtigungen angeben

Wenn Sie einen Bereich mit bestimmten Zugriffsberechtigungen erstellen möchten, verwenden Sie die Methode create oder setup für die Ressource Space. Verwenden Sie die Methode update, um die Berechtigungen für einen vorhandenen Bereich zu aktualisieren. Da nur benannte Gruppenbereiche für Zielgruppen freigegeben werden können, muss der Gruppenbereichstyp (im Feld spaceType) SPACE sein.

Wenn Sie angeben möchten, wer einen Gruppenbereich finden oder ihm beitreten kann, fügen Sie das Objekt AccessSettings in die Space-Ressource 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.

Im folgenden Beispiel sehen Sie, wie Sie einen Gruppenbereich für zwei Zielgruppen sichtbar machen und ihn für nur eine Zielgruppe zugänglich machen:

  "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" } }
        ]
      }
    }
  }

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 anzugeben.

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

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

Ersetzen Sie TARGET_AUDIENCE_ID durch die ID der Zielgruppe, die Sie in 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, spiegelt das AccessSettings-Objekt in der Antwort die detaillierten Berechtigungen wider, die für den Gruppenbereich festgelegt sind.

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 Ermittlung (discoverSpaceSetting). Wenn die Ermittlung für eine oder mehrere Zielgruppen gewährt wird, ist dieses Feld DISCOVERABLE. Andernfalls ist es PRIVATE.
  • audience: Wird speziell auf die Berechtigungen für die Mitgliedschaft (joinSpaceSetting) abgebildet. 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, aber ein direkter Beitritt ist nicht 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: