Mit der Groups Settings API werden Einstellungen für eine vorhandene Google-Gruppe aktualisiert und abgerufen. Über die API haben Sie folgende Möglichkeiten:
- Einstellungen einer Gruppe für den internen und externen Gruppenzugriff ändern
- Gruppenbenachrichtigungen bearbeiten
- Diskussionsarchivierung und Nachrichtenmoderation konfigurieren
- Nutzergruppen Ihres Kontos anpassen
Weitere Informationen zur Verwendung von Google-Gruppen oder zur Verwaltung anderer Arten von Gruppen finden Sie in der Cloud Identity-Dokumentation.
Datenmodell der Groups Settings API
Die Groups Settings API arbeitet mit einer Groups-Ressource, die darstellt, wie Nutzer innerhalb eines Kontos mit Gruppen anderer Nutzer kommunizieren und zusammenarbeiten.
Jede Gruppe wird durch die E-Mail-Adresse der Gruppe identifiziert.
Das API-Datenmodell basiert auf der Groups-Sammlung der Gruppen des Kontos.
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 |
Aktualisiert die Einstellungen einer Gruppe für das Konto eines Kunden. 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, mit dem beliebige Datenstrukturen dargestellt werden können. Laut json.org ist JSON ein Textformat, das vollständig sprachunabhängig ist, aber Konventionen verwendet, die Programmierern der C-Sprachfamilie, einschließlich C, C++, C#, Java, JavaScript, Perl und Python, vertraut sind.
Sie können das Datenformat der API ändern, indem Sie den Abfragestring alt in den URI Ihrer Anfrage einfügen. 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