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
- Ein Google Workspace-Konto mit Zugriff auf Google Chat. Das Konto muss die Super Admin-Rolle für Ihre Google Workspace-Organisation haben.
- Eine Zielgruppe, auf die in Google Chat zugegriffen werden kann. Informationen zum Erstellen einer Zielgruppe finden Sie unter Zielgruppe erstellen. Informationen dazu, wie Sie eine vorhandene Zielgruppe für Chatbereiche verfügbar machen, finden Sie unter Zugriff auf Gruppenbereiche für Google Chat einrichten.
Zielgruppen-ID abrufen
So rufen Sie die ID einer Zielgruppe ab:
Gehen Sie in der Admin-Konsole zu Menü > Verzeichnis > Zielgruppen.
Klicken Sie in der Tabelle Zielgruppen auf das Feld Name der Zielgruppe.
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
, wobeiTARGET_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:
Weitere Informationen
- Zielgruppe erstellen
- Freigabe in Google Chat einrichten
- Gruppenbereiche mit unterschiedlichen Zugriffsebenen erstellen