Groups Settings API – Übersicht

Die Groups Settings API aktualisiert und ruft Einstellungen für eine vorhandene Google-Gruppe ab. Mit der API können Sie Folgendes tun:

  • Ändern Sie die Einstellungen einer Gruppe für den Zugriff auf interne und externe Gruppen.
  • Benachrichtigungen der Gruppe bearbeiten.
  • Konfigurieren Sie die Archivierung von Diskussionen und die Nachrichtenmoderation.
  • Passen Sie die Nutzergruppen Ihres Kontos an.

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

Datenmodell der Groups Settings API

Die Groups Settings API basiert auf einer Groups-Ressource, die darstellt, wie Nutzer in einem Konto mit Gruppen anderer Personen kommunizieren und zusammenarbeiten. Jede Gruppe wird durch ihre E-Mail-Adresse identifiziert.

Das API-Datenmodell basiert auf der Sammlung „Groups“ der Gruppen des Kontos. Jede Gruppe hat individuelle Konfigurationseinstellungen.

Groups Settings API-Vorgänge

Sie können Gruppeneinstellungsmethoden 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. Für einen Gruppen-URI ist dies GET.
update Aktualisiert die Einstellungen einer Gruppe für das Konto eines Kunden. Alle Aktualisierungsvorgänge müssen von einem authentifizierten Nutzer autorisiert werden. Für einen Gruppen-URI ist dies PUT.

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-/Schreibfunktionen.

JSON ist ein gängiges Internetformat, das eine Methode zur Darstellung beliebiger Datenstrukturen bietet. Laut json.org ist JSON ein Textformat, das vollständig sprachunabhängig ist, aber Konventionen verwendet, die Programmierer der C-Sprachfamilie vertraut sind, einschließlich C, C++, C#, Java, JavaScript, Perl und Python.

Wenn Sie das Datenformat der API ändern möchten, fügen Sie den Abfragestring alt in den URI der 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