Gruppenbereiche in Google Chat als Google Workspace-Administrator verwalten

Auf dieser Seite finden Sie eine Übersicht darüber, wie Google Workspace-Administratoren die Google Chat API verwenden können, um Google Chat-Gruppenbereiche in ihrer Organisation zu verwalten.

Zum Verwalten von Chat-Gruppenbereichen können Google Workspace-Administratoren das Tool zur Gruppenbereichsverwaltung in der Admin-Konsole verwenden oder die Google Chat API aufrufen. Mit der Chat API können Administratoren Google Chat-Apps erstellen, mit denen sie Gruppenbereiche in großem Umfang verwalten und häufige oder wiederholbare Aufgaben automatisieren können.

Möglichkeiten für Administratoren mit der Chat API

Administratoren können Verwaltungsaufgaben basierend auf ihren zugewiesenen Administratorrollen ausführen.

Als Google Workspace-Administrator können Sie mit der Chat API eine Reihe von Verwaltungsaufgaben ausführen, z. B.:

Authentifizierung und Autorisierung als Google Workspace-Administrator

Wenn Administratoren die Chat API für Verwaltungsaufgaben verwenden, können sie Anfragen authentifizieren und autorisieren, indem sie Administratorberechtigungen aufrufen oder die domainweite Delegierung der Berechtigung für das Dienstkonto einer Anwendung konfigurieren.

In der folgenden Tabelle werden die Möglichkeiten beschrieben, wie sich Administratoren bei der Verwendung der Chat API authentifizieren können.

Nutzerauthentifizierung Wer ruft die API-Methode auf? Was sehen Nutzer in Chat?
Administratorberechtigungen Administrator mit useAdminAccess=true

„Der Administrator der Organisation hat [eine Aktion] ausgeführt.“

Beispiel: „Der Administrator der Organisation hat Kiran B zum Administrator des Gruppenbereichs ernannt.“

Der Name oder die Nutzer-ID des Administrators oder der Name der Chat-App wird nicht angegeben.
Domainweite Delegierung Dienstkonto im Namen eines Nutzers

„[Nutzer] hat [eine Aktion] über [App-Name] ausgeführt.“

Beispiel: „Sasha T hat den Gruppenbereich in „Diskussion zum Release-Projekt“ umbenannt.“

Der Nutzer, der vom Dienstkonto imitiert wird, wird als derjenige identifiziert, der die Aktion ausgeführt hat.

Chat API für Ihre Organisation verwenden

In den Beispielen in diesem Abschnitt wird gezeigt, wie Administratoren die Chat API verwenden, wenn sie die Gruppenbereiche und Mitglieder ihrer Organisation mit Administratorberechtigungen verwalten.

Die folgenden Chat API-Methoden ermöglichen Administratorberechtigungen mit useAdminAccess=true.

Gruppenbereich-Mitgliedschaften von Nutzern verwalten

In den folgenden Szenarien wird beschrieben, wie Sie als Google Workspace-Administrator die Gruppenbereich-Mitgliedschaft von Nutzern in Ihrer Organisation mit der Chat API verwalten können.

Nutzer zu Gruppenbereichen hinzufügen

Mit spaces.members.create, können Administratoren einen Nutzer zu einem beliebigen Gruppenbereich in einer Organisation hinzufügen.

In Verbindung mit spaces.search, können Administratoren einen Nutzer zu einer Reihe von Gruppenbereichen hinzufügen, die durch ihre Suchanfrage bestimmt werden. Dies kann bei der Einarbeitung neuer Mitarbeiter in eine Organisation hilfreich sein, da Administratoren so einen Routineprozess automatisieren können.

Nutzer suchen und aus Gruppenbereichen entfernen

Mit spaces.members.get, können Administratoren feststellen, ob ein Nutzer (innerhalb oder außerhalb der Organisation) Mitglied eines Gruppenbereichs in der Organisation ist.

In Verbindung mit spaces.search, können Administratoren alle Gruppenbereiche finden, in denen der Nutzer Mitglied ist, und ihn dann mit spaces.members.delete aus den Gruppenbereichen entfernen. Dies kann hilfreich sein, wenn Mitarbeiter innerhalb einer Organisation das Team wechseln oder wenn Mitarbeiter, die nicht mehr in der Organisation tätig sind, entfernt werden sollen. Administratoren können so einen Routineprozess automatisieren.

Nutzer zum Administrator eines Gruppenbereichs ernennen

Mit spaces.members.patch, können Administratoren die Rolle eines Mitglieds ändern, indem sie die MembershipRole zwischen den folgenden Optionen aktualisieren:

  • ROLE_MEMBER: Ein Mitglied des Gruppenbereichs. In der Chat-UI wird diese Rolle als Mitglied bezeichnet.
  • ROLE_ASSISTANT_MANAGER: Ein Administrator des Gruppenbereichs. In der Chat-UI wird diese Rolle als Administrator bezeichnet.
  • ROLE_MANAGER: Ein Eigentümer des Gruppenbereichs. In der Chat-UI wird diese Rolle als Eigentümer bezeichnet.

In Verbindung mit spaces.search, können Administratoren Gruppenbereiche finden, die keinen Administrator oder Eigentümer haben, und dann ein vorhandenes Mitglied mit spaces.members.patch zum Administrator oder Eigentümer ernennen.

Externe Mitglieder eines Gruppenbereichs finden

Mit spaces.members.list, können Administratoren eine Liste der Mitglieder eines Gruppenbereichs abrufen, die Nutzerprofile aus der People API oder Directory API der Organisation abrufen und die Ergebnisse dann nach Mitgliedern einer externen Domain oder Organisation filtern. Weitere Informationen finden Sie unter Wie werden Nutzer in Google Chat identifiziert?.

Gruppenbereiche prüfen und verwalten

In den folgenden Szenarien wird beschrieben, wie Sie als Google Workspace-Administrator die Gruppenbereiche in Ihrer Organisation mit der Chat API prüfen und verwalten können.

Inaktive Gruppenbereiche suchen und löschen

Nicht verwendete Chat-Gruppenbereiche können wertvollen Speicherplatz belegen und die Benutzeroberfläche unübersichtlich machen. Administratoren können mit spaces.search die inaktiven Gruppenbereiche suchen und sie dann mit spaces.delete löschen. Weitere Informationen und ein Codebeispiel finden Sie unter Inaktive Chat-Gruppenbereiche suchen und löschen.

Gruppenbereiche in der Organisation prüfen

Mit spaces.search, können Administratoren eine Liste aller Gruppenbereiche in einer Organisation mit detaillierten Informationen zu den Einstellungen und Metadaten der einzelnen Gruppenbereiche abrufen, z. B. Erstellungsdatum, Datum der letzten Aktivität, Anzahl der Mitglieder, Status der Verlaufseinstellung und Möglichkeit, externe Gäste einzuladen.

Liste der Gruppenbereiche basierend auf Suchkriterien exportieren

Mit spaces.search, können Administratoren eine Liste von Gruppenbereichen abrufen, die die in der query angegebenen Kriterien erfüllen, und die Ergebnisse zur Analyse in eine CSV-Datei exportieren.

Mitglieder eines Gruppenbereichs anhand von Suchkriterien finden

Mit spaces.members.list, können Administratoren eine Liste der Mitglieder eines beliebigen Gruppenbereichs in der Organisation abrufen und die Ergebnisse anhand bestimmter Kriterien analysieren.

Administratoren eines Gruppenbereichs finden

Mit spaces.members.list, können Administratoren eine Liste der Mitglieder eines Gruppenbereichs abrufen, die nach MembershipState=ROLE_MANAGER gefiltert ist.

Wenn Sie alle Administratoren von Gruppenbereichen in Ihrer Organisation in allen Gruppenbereichen finden möchten, können Sie sie mit spaces.search auflisten. Verwenden Sie dann für jeden Gruppenbereich in der Liste spaces.members.list, um die Administratoren abzurufen.