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

Zielgruppe in der Chat API-Anfrage angeben

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

Damit ein Gruppenbereich für Ihre Zielgruppe auffindbar ist, fügen Sie das AccessSettings -Objekt in die Space-Ressource als Teil Ihrer 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 Chat-Gruppenbereichen für Ihre Google Workspace-Organisation verwenden möchten, ersetzen Sie default.

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