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.
Google Workspace-Administratoren können zum Verwalten von Chat-Bereichen das Tool zur Verwaltung von Bereichen in der Google Admin-Konsole verwenden oder die Google Chat API aufrufen. Mit der Chat API können Administratoren Google Chat-Apps erstellen, mit denen sich Gruppenbereiche in großem Umfang verwalten und häufige oder wiederholbare Aufgaben automatisieren lassen.
Was Administratoren mit der Chat API tun können
Ein Administrator kann Verwaltungsaufgaben basierend auf seinen zugewiesenen Administratorrollen ausführen.
Als Google Workspace-Administrator können Sie mit der Chat API eine Reihe von Verwaltungsaufgaben ausführen, z. B.:
- Gruppenbereiche anhand bestimmter Kriterien durchsuchen
- Mitglieder eines Gruppenbereichs auflisten
- Mitglieder einem Gruppenbereich hinzufügen und Mitglieder aus einem Gruppenbereich entfernen
- Details zu einem Mitglied und einem Bereich abrufen
- Gruppenbereich aktualisieren oder löschen
- Mitgliedschaft eines Nutzers aktualisieren
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 Ermächtigung für das Dienstkonto einer Anwendung konfigurieren.
In der folgenden Tabelle wird beschrieben, wie sich Administratoren bei der Verwendung der Chat API authentifizieren können.
| Nutzerauthentifizierung | Wer ruft die API-Methode auf? | Was Nutzer in Google Chat sehen |
|---|---|---|
| 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.“ Sie enthält nicht den Namen oder die Nutzer-ID des Administratornutzers oder den Namen der Chat-App. |
| Domainweite Delegierung | Dienstkonto im Namen eines Nutzers | „[Nutzer] hat [eine Aktion] über [App-Name] ausgeführt.“ Beispiel: „Sasha T hat den Gruppenbereich in ‚Release Project Discussion‘ umbenannt.“ Der Nutzer, dessen Identität vom Dienst übernommen wird, wird als derjenige identifiziert, der die Aktion ausgeführt hat. |
Chat API für Ihre Organisation verwenden
Die Beispiele in diesem Abschnitt zeigen, wie Administratoren die Chat API verwenden, um die Bereiche und Mitglieder ihrer Organisation mit Administratorberechtigungen zu verwalten.
Die folgenden Chat API-Methoden ermöglichen Administratorberechtigungen mit useAdminAccess=true.
spaces.delete()spaces.get()spaces.patch()spaces.search()spaces.members.create()spaces.members.delete()spaces.members.get()spaces.members.list()spaces.members.patch()
Space-Mitgliedschaften von Nutzern verwalten
In den folgenden Szenarien wird beschrieben, wie Sie als Google Workspace-Administrator die Mitgliedschaft von Nutzern in Bereichen 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 Nutzer einer Reihe von Gruppenbereichen hinzufügen, die durch ihre Suchanfrage bestimmt werden. Das kann nützlich sein, wenn neue Mitarbeiter in eine Organisation aufgenommen werden, 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. Das kann nützlich sein, wenn Mitarbeiter innerhalb einer Organisation in andere Teams wechseln oder wenn Mitarbeiter, die nicht mehr in der Organisation sind, aus dem System entfernt werden. Administratoren können so einen Routineprozess automatisieren.
Nutzer zum Administrator eines Gruppenbereichs machen
Mit spaces.members.patch() können Administratoren Mitglieder eines Gruppenbereichs von ROLE_MEMBER zu ROLE_MANAGER befördern. Administratoren können auch spaces.members.patch() verwenden, um Mitglieder von ROLE_MANAGER zu ROLE_MEMBER zu verschieben.
In Verbindung mit spaces.search() können Administratoren Gruppenbereiche ohne Administrator finden und dann ein vorhandenes Mitglied mit spaces.members.patch() zum ROLE_MANAGER ernennen.
Externe Mitglieder eines Gruppenbereichs finden
Mit spaces.members.list() können Administratoren eine Liste der Mitglieder eines Bereichs 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 im Chat identifiziert?.
Gruppenbereiche prüfen und verwalten
In den folgenden Szenarien wird beschrieben, wie Sie als Google Workspace-Administrator die Bereiche in Ihrer Organisation mit der Chat API prüfen und verwalten können.
Inaktive Gruppenbereiche suchen und löschen
Nicht verwendete Chatbereiche können wertvollen Speicherplatz belegen und die Benutzeroberfläche unübersichtlich machen. Administratoren können mit spaces.search() nach inaktiven Gruppenbereichen 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 Bereiche in einer Organisation mit detaillierten Informationen zu den Einstellungen und Metadaten der einzelnen Bereiche abrufen, z. B. Erstellungsdatum, Datum der letzten Aktivität, Anzahl der Mitglieder, Status der Verlaufseinstellung und Möglichkeit, externe Gäste einzuladen.
Liste von Bereichen anhand von Suchkriterien exportieren
Mit spaces.search() können Administratoren eine Liste von Bereichen abrufen, die den in query angegebenen Kriterien entsprechen, 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 für jeden Bereich 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 Space-Administratoren in Ihrer Organisation in allen Spaces finden möchten, können Sie spaces.search() verwenden, um sie alle aufzulisten. Verwenden Sie dann für jeden Bereich in der Liste spaces.members.list, um die Administratoren abzurufen.
Weitere Informationen
- Authentifizierung und Autorisierung mit Administratorberechtigungen
- Als Google Workspace-Administrator mit der Google Chat API nach Google Chat-Gruppenbereichen suchen und diese verwalten
spaces.search()-Methode