Mit der Groups Settings API können Sie die Einstellungen für eine vorhandene Google-Gruppe aktualisieren und abrufen. Über die API haben Sie folgende Möglichkeiten:
- Einstellungen für den Zugriff auf interne und externe Gruppen ändern
- Benachrichtigungen für die Gruppe bearbeiten
- Archivierung von Diskussionen und Nachrichtenmoderation konfigurieren
- Nutzergruppen für Ihr Konto anpassen
Weitere Informationen zur Verwendung von Google Groups und 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 in einem Konto 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 Abrufvorgänge müssen von einem authentifizierten Nutzer autorisiert werden. | GET für eine 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 eine 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 völlig sprachunabhängig ist, aber Konventionen verwendet, die Programmierern der C-Sprachfamilie bekannt sind, darunter C, C++, C#, Java, JavaScript, Perl und Python.
Sie können das Datenformat der API ändern, indem Sie den Abfragestring alt in die 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