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, mit der Sie einen Chatbereich teilen können, um die Bekanntheit und Freigabemöglichkeiten des Gruppenbereichs zu verbessern. Mithilfe von Zielgruppen können Sie auch die Mitgliedschaft in Gruppenbereichen verwalten und anpassen, anstatt 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 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. Klicken Sie in der Admin-Konsole auf das Dreistrich-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 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 sichtbaren Gruppenbereich zu erstellen oder einen vorhandenen Gruppenbereich so zu aktualisieren, dass er für die Zielgruppe sichtbar ist.

Zielgruppe in Ihrer Chat API-Anfrage angeben

Wenn Sie einen Gruppenbereich für eine bestimmte Zielgruppe erstellen möchten, verwenden Sie die Methode create() oder setup() für die Ressource Space. 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.

Wenn Sie einen Gruppenbereich für Ihre Zielgruppe sichtbar machen möchten, fügen Sie das AccessSettings -Objekt in der Space-Ressource in Ihre 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 „default“ durch „default“.

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