Groups Settings API – Übersicht

Die Groups Settings API aktualisiert und ruft Einstellungen für eine vorhandene Google-Gruppe ab. Mit der API haben Sie folgende Möglichkeiten:

  • Sie können die Einstellungen einer Gruppe für den Zugriff auf interne und externe Gruppen ändern.
  • Bearbeiten Sie die Benachrichtigungen der Gruppe.
  • Konfigurieren Sie die Archivierung von Diskussionen und die Nachrichtenmoderation.
  • Nutzergruppen Ihres Kontos anpassen

Weitere Möglichkeiten zur Arbeit mit Google-Gruppen oder zum Verwalten anderer Gruppentypen finden Sie in der Cloud Identity-Dokumentation.

Datenmodell der Groups Settings API

Die Groups Settings API arbeitet mit einer Groups-Ressource, die angibt, wie Nutzer innerhalb eines Kontos mit Gruppen anderer Personen kommunizieren und zusammenarbeiten. Jede Gruppe wird anhand der E-Mail-Adresse der Gruppe identifiziert.

Das API-Datenmodell basiert auf der Groups-Sammlung der Kontogruppen. Jede Gruppe hat eigene Konfigurationseinstellungen.

Vorgänge der Groups Settings API

Sie können Methoden für Gruppeneinstellungen in der Groups Settings API aufrufen, wie in der folgenden Tabelle beschrieben:

Vorgang Beschreibung REST-HTTP-Zuordnungen
get Ruft die Einstellungen einer Gruppe für das Konto eines Kunden ab. Alle Get-Vorgänge müssen von einem authentifizierten Nutzer autorisiert werden. GET für einen Gruppen-URI.
update Hiermit werden die Einstellungen einer Gruppe für das Konto eines Kunden aktualisiert. Alle Aktualisierungsvorgänge müssen von einem authentifizierten Nutzer autorisiert werden. PUT für einen Gruppen-URI.

JSON- und Atom-Datenformate

Standardmäßig gibt die Groups Settings API Daten im JSON-Format zurück. Die Atom-Notation ist ein alternatives Datenformat. Sowohl das JSON- als auch das Atom-Datenformat unterstützen vollständige Lese- und Schreibfunktionen.

JSON ist ein gängiges Internetformat, das eine Methode zur Darstellung beliebiger Datenstrukturen bietet. Laut json.org ist JSON ein völlig sprachunabhängiges Textformat, das jedoch Konventionen verwendet, die Programmierern der C-Familie von Programmiersprachen wie C, C++, C#, Java, JavaScript, Perl und Python vertraut sind.

Wenn Sie das Datenformat der API ändern möchten, fügen Sie den Abfragestring alt in die URI Ihrer Anfrage ein. Beispiel:

JSON

GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=json

Atom

GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=atom