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-Bereich für bestimmte Nutzer in einer Google Workspace-Organisation freigeben, damit sie den Bereich finden und ihm beitreten können.

Um die Nutzer in Ihrer Organisation festzulegen, die einen Gruppenbereich finden und ihnen beitreten dürfen, erstellen Sie Zielgruppen. Eine Zielgruppe ist eine Gruppe von Personen – z. B. bestimmte Abteilungen oder die gesamte Organisation –, für die Sie einen Chatbereich freigeben können, um die Sichtbarkeit und Freigabe zu verbessern. Mit Zielgruppen können Sie auch Mitgliedschaften in Gruppenbereichen verwalten und anpassen, anstatt einzelne Nutzer in einen Gruppenbereich einladen zu müssen. Weitere Informationen finden Sie unter Informationen zu Zielgruppen.

Benannte Gruppenbereiche lassen sich nur für Zielgruppen sichtbar machen. Andere Gruppenbereichstypen wie Direktnachrichten oder Gruppenunterhaltungen können nicht für Zielgruppen freigegeben werden.

Voraussetzungen

Zielgruppen-ID abrufen

So rufen Sie die ID einer Zielgruppe ab:

  1. Gehen Sie in der Admin-Konsole zu Menü > Verzeichnis > Zielgruppen.

    „Zielgruppen“ aufrufen

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

  3. Suchen Sie die Zielgruppen-ID in der URL für die 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 erstellen Sie mithilfe der Zielgruppen-ID entweder einen Bereich mit offenem Zugang oder aktualisieren einen vorhandenen Bereich, damit er für die Zielgruppe auffindbar ist.

Zielgruppe in der Chat API-Anfrage angeben

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

Damit ein Gruppenbereich für Ihre Zielgruppe gefunden werden kann, nehmen Sie das Objekt AccessSettings in die Ressource Space als Teil Ihrer Chat API-Anfrage auf. 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 Chatbereichen für Ihre Google Workspace-Organisation verwenden möchten, ersetzen Sie diese durch default.

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