REST Resource: members

Ressource: Mitglied

Ein Google Groups-Mitglied kann ein Nutzer oder eine andere Gruppe sein. Dieses Mitglied kann sich innerhalb oder außerhalb der Domains Ihres Kontos befinden. Weitere Informationen zu gängigen Aufgaben für Gruppenmitglieder finden Sie im Entwicklerhandbuch.

JSON-Darstellung
{
  "kind": string,
  "email": string,
  "role": string,
  "etag": string,
  "type": string,
  "status": string,
  "delivery_settings": string,
  "id": string
}
Felder
kind

string

Der Typ der API-Ressource. Für Mitgliederressourcen ist der Wert admin#directory#member.

email

string

E-Mail-Adresse des Mitglieds Ein Mitglied kann ein Nutzer oder eine andere Gruppe sein. Diese Property ist erforderlich, wenn ein Mitglied zu einer Gruppe hinzugefügt wird. Die email muss eindeutig sein und darf kein Alias einer anderen Gruppe sein. Wenn die E-Mail-Adresse geändert wird, werden diese Änderungen in der API automatisch übernommen.

role

string

Die Rolle des Mitglieds in einer Gruppe. Die API gibt für Zyklen in Gruppenmitgliedschaften einen Fehler zurück. Beispiel: Wenn group1 Mitglied von group2 ist, kann group2 nicht Mitglied von group1 sein. Weitere Informationen zur Rolle eines Mitglieds finden Sie unter Mitgliedern Gruppenrollen zuweisen.

Akzeptable Werte sind:

  • MANAGER: Diese Rolle ist nur verfügbar, wenn Google Groups for Business über die Admin-Konsole aktiviert wird. Weitere Informationen finden Sie im Hilfeartikel Google Groups for Business aktivieren oder deaktivieren. Eine MANAGER-Rolle kann alle Aufgaben einer OWNER-Rolle ausführen, ein Mitglied jedoch nicht zu einer OWNER machen oder die Gruppe löschen. Eine Gruppe kann mehrere MANAGER-Mitglieder haben.
  • MEMBER: Diese Rolle kann eine Gruppe abonnieren, Diskussionsarchive aufrufen und die Mitgliederliste der Gruppe ansehen. Weitere Informationen zu Mitgliederrollen finden Sie unter Mitgliedern Rollen zuweisen.
  • OWNER: Nutzer mit dieser Rolle können Nachrichten an die Gruppe senden, Mitglieder hinzufügen oder entfernen, Mitgliederrollen und Gruppeneinstellungen ändern und die Gruppe löschen. Ein OWNER muss Mitglied der Gruppe sein. Eine Gruppe kann mehrere OWNER haben.
etag

string

Das ETag der Ressource.

type

string

Der Typ des Gruppenmitglieds.

Akzeptable Werte sind:

  • CUSTOMER: Das Mitglied repräsentiert alle Nutzer in einer Domain. Es wird keine E-Mail-Adresse zurückgegeben und die zurückgegebene ID ist die Kundennummer.
  • EXTERNAL: Das Mitglied ist ein Nutzer oder eine Gruppe außerhalb der Domain. (Zurzeit nicht verwendet)
  • GROUP: Das Mitglied ist eine andere Gruppe.
  • USER: Das Mitglied ist ein Nutzer.
status

string

Status des Mitglieds (unveränderlich)

delivery_settings

string

Definiert die Einstellungen für die E-Mail-Zustellung des Mitglieds. Dieses Feld wird nur von den Methoden insert, update und get unterstützt.

Akzeptable Werte sind:

  • ALL_MAIL: Alle Nachrichten, die unmittelbar nach dem Eintreffen zugestellt werden.
  • DAILY: Maximal eine Nachricht pro Tag.
  • DIGEST: Bis zu 25 Nachrichten in einer Nachricht gruppiert.
  • DISABLED: Abo entfernen.
  • NONE: Keine Nachrichten.
id

string

Die eindeutige ID des Gruppenmitglieds. Ein Mitglied id kann als memberKey eines Mitgliedsanfrage-URI verwendet werden.

Methoden

delete

Entfernt ein Mitglied aus einer Gruppe.

get

Ruft die Attribute eines Gruppenmitglieds ab.

hasMember

Prüft, ob der angegebene Nutzer Mitglied der Gruppe ist.

insert

Fügt der angegebenen Gruppe einen Nutzer hinzu.

list

Ruft eine paginierte Liste aller Mitglieder in einer Gruppe ab.

patch

Aktualisiert die Mitgliedschaftseigenschaften eines Nutzers in der angegebenen Gruppe.

update

Aktualisiert die Mitgliedschaft eines Nutzers in der angegebenen Gruppe.