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

Auf dieser Seite wird erläutert, wie Sie mit der Google Chat API einen Google Chat-Gruppenbereich für bestimmte Nutzer in einer Google Workspace-Organisation freigeben, damit diese den Gruppenbereich finden und ihm beitreten können.

Wenn Sie festlegen möchten, welche Nutzer in Ihrer Organisation einen Gruppenbereich finden und ihm beitreten können, erstellen Sie Zielgruppen. Eine Zielgruppe ist eine Gruppe von Personen, z. B. bestimmte Abteilungen oder die gesamte Organisation, für die Sie einen Chat-Gruppenbereich freigeben können, um die Bekanntheit und Freigabefähigkeit des Gruppenbereichs zu verbessern. Mit Zielgruppen können Sie auch Gruppenbereichsmitgliedschaften verwalten und anpassen, ohne einzelne Nutzer zu einem Gruppenbereich einladen zu müssen. Weitere Informationen finden Sie unter Zielgruppen.

Sie können nur benannte Gruppenbereiche für Zielgruppen auffindbar machen. Andere Gruppenbereichstypen wie 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 zu Menü > Verzeichnis > Zielgruppen.

    Klicken Sie auf Zielgruppen.

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

  3. Suchen Sie die Zielgruppen-ID 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 für Ihre Zielgruppe ist.

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

Zielgruppe in der Google Chat API-Anfrage angeben

Verwenden Sie die create() oder setup() Methode für die Space Ressource, um einen Gruppenbereich für eine bestimmte Zielgruppe zu erstellen. Verwenden Sie die update() Methode für die Space Ressource, um einen vorhandenen Gruppenbereich auffindbar zu machen. Da nur benannte Gruppenbereiche für Zielgruppen freigegeben werden können, muss der Gruppenbereichstyp (im Feld spaceType dargestellt) SPACE sein.

Wenn ein Gruppenbereich für Ihre Zielgruppe auffindbar sein soll, fügen Sie das AccessSettings Objekt in die Space Ressource als Teil Ihrer Google Chat API-Anfrage ein. Geben Sie im Objekt das Feld audience an:

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

Ersetzen Sie TARGET_AUDIENCE_ID durch die ID der Zielgruppe, die Sie im vorherigen Abschnitt abgerufen haben. Wenn Sie die Standardeinstellungen für die Freigabe von Google Chat-Gruppenbereichen für Ihre Google Workspace-Organisation verwenden möchten, ersetzen Sie durch default.

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