Auf dieser Seite erhalten Sie einen Überblick darüber, wie Google Workspace-Administratoren Google Chat-Gruppenbereiche in ihrer Organisation mithilfe der Google Chat API verwalten können.
Google Workspace-Administratoren können das Tool zum Verwalten von Gruppenbereichen in der 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 wiederkehrende Aufgaben automatisieren lassen.
Was Administratoren mit der Chat API tun können
Administratoren können je nach zugewiesener Administratorrolle Verwaltungsaufgaben 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 zu einem Gruppenbereich hinzufügen und Mitglieder aus einem Gruppenbereich entfernen
- Details zu einem Mitglied und einem Gruppenbereich abrufen
- Gruppenbereich aktualisieren oder löschen
- Mitgliedschaft eines Nutzers aktualisieren
Als Google Workspace-Administrator authentifizieren und autorisieren
Wenn Administratoren die Chat API für Verwaltungsaufgaben verwenden, können sie Anfragen authentifizieren und autorisieren, indem sie Administratorberechtigungen aufrufen oder eine domainweite Ermächtigung 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 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 gemacht.“ Der Name oder die Nutzer-ID des Administratornutzers oder der Name der Chat-App werden nicht angegeben. |
| Domainweite Delegierung | Dienstkonto im Namen eines Nutzers |
„[Nutzer] hat [eine Aktion] über [Name der App] ausgeführt.“ Beispiel: „Sascha T hat den Gruppenbereich in „Release Project Discussion“ umbenannt.“ Der Nutzer, dessen Identität vom Dienst gestohlen wird, wird als Ausführender der Aktion identifiziert. |
Chat API für Ihre Organisation verwenden
In den Beispielen in diesem Abschnitt wird gezeigt, wie Administratoren die Chat API verwenden, um Gruppenbereiche und Mitglieder ihrer Organisation mit Administratorberechtigungen zu verwalten.
Mit den folgenden Chat API-Methoden können Sie Administratorberechtigungen mit useAdminAccess=true aktivieren.
spaces.delete()spaces.get()spaces.patch()spaces.search()spaces.members.create()spaces.members.delete()spaces.members.get()spaces.members.list()spaces.members.patch()
Mitgliedschaften von Nutzern in Gruppenbereichen verwalten
In den folgenden Szenarien wird beschrieben, wie Sie als Google Workspace-Administrator die Mitgliedschaft von Nutzern in Ihrer Organisation in einem Gruppenbereich mit der Chat API verwalten können.
Nutzer zu Gruppenbereichen hinzufügen
Mit spaces.members.create() können Administratoren einem beliebigen Gruppenbereich in einer Organisation einen Nutzer hinzufügen.
In Kombination mit spaces.search() können Administratoren einen Nutzer einer Reihe von Gruppenbereichen hinzufügen, die anhand der Suchanfrage bestimmt werden. Das kann beim Onboarding neuer Mitarbeiter in einem Unternehmen nützlich sein, da Administratoren einen Routinevorgang automatisieren können.
Nutzer suchen und aus Gruppenbereichen entfernen
Mit spaces.members.get() können Administratoren feststellen, ob ein Nutzer (intern oder extern) Mitglied eines Gruppenbereichs in der Organisation ist.
In Kombination 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 eines Unternehmens das Team wechseln oder Mitarbeiter, die das Unternehmen verlassen, abgemeldet werden. So können Administratoren 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 spaces.members.patch() auch verwenden, um Mitglieder von ROLE_MANAGER zu ROLE_MEMBER zu verschieben.
In Kombination mit spaces.search() können Administratoren Gruppenbereiche finden, die keinen Administrator haben, und dann mit spaces.members.patch() ein vorhandenes Mitglied zum ROLE_MANAGER befördern.
Externe Mitglieder eines Gruppenbereichs finden
Mit spaces.members.list() können Administratoren eine Liste der Mitglieder in einem Gruppenbereich 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 So werden Nutzer im Chat identifiziert.
Gruppenbereiche prüfen und verwalten
In den folgenden Szenarien wird beschrieben, wie Sie als Google Workspace-Administrator Gruppenbereiche 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 überladen. 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 Google Chat-Gruppenbereiche finden 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 jedes Gruppenbereichs abrufen, z. B. Erstellungsdatum, Datum der letzten Aktivität, Anzahl der Mitglieder, Status der Einstellung für den Verlauf und Möglichkeit, externe Gäste einzuladen.
Liste der Gruppenbereiche anhand von Suchkriterien exportieren
Mit spaces.search() können Administratoren eine Liste der Gruppenbereiche abrufen, die die in 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 für jeden Gruppenbereich 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 für einen Gruppenbereich abrufen, die nach MembershipState=ROLE_MANAGER gefiltert ist.
Wenn Sie alle Space-Administratoren in Ihrer Organisation in allen Gruppenbereichen aufrufen möchten, können Sie spaces.search() verwenden, um sie alle aufzulisten. Rufen Sie dann mit spaces.members.list für jeden Gruppenbereich in der Liste die Administratoren ab.
Weitere Informationen
- Mit Administratorrechten authentifizieren und autorisieren
- Als Google Workspace-Administrator Google Chat-Gruppenbereiche mit der Google Chat API suchen und verwalten
spaces.search()-Methode