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 von Gruppenmitgliedern 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 lautet 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 Sie einer Gruppe ein Mitglied hinzufügen. Die email muss eindeutig sein und darf kein Alias einer anderen Gruppe sein. Wenn die E-Mail-Adresse geändert wird, werden die Änderungen in der API automatisch übernommen.
role

string

Die Rolle des Mitglieds in einer Gruppe. Die API gibt einen Fehler für Zyklen in Gruppenmitgliedschaften zurück. Wenn beispielsweise group1 Mitglied von group2 ist, kann group2 nicht Mitglied von group1 sein. Weitere Informationen zu den Rollen von Mitgliedern finden Sie im Hilfeartikel Mitgliedern Gruppenrollen zuweisen.

Akzeptable Werte sind:

  • MANAGER: Diese Rolle ist nur verfügbar, wenn Google Groups for Business über die Admin-Konsole aktiviert ist. Weitere Informationen finden Sie unter Google Groups for Business aktivieren oder deaktivieren. Eine MANAGER-Rolle hat dieselben Berechtigungen wie eine OWNER-Rolle, mit der Ausnahme, dass ein Mitglied als OWNER festgelegt oder die Gruppe gelöscht werden kann. Eine Gruppe kann mehrere MANAGER-Mitglieder haben.
  • MEMBER: Mit dieser Rolle können Gruppen abonniert, Diskussionsarchive und die Mitgliederliste der Gruppe angezeigt werden. Weitere Informationen zu Mitgliederrollen finden Sie unter Mitgliedern Gruppenrollen zuweisen.
  • OWNER: Diese Rolle kann Nachrichten an die Gruppe senden, Mitglieder hinzufügen oder entfernen, Mitgliederrollen ändern, Gruppeneinstellungen ändern und die Gruppe löschen. Ein OWNER muss Mitglied der Gruppe sein. Eine Gruppe kann mehrere OWNER haben.
etag

string

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. (wird derzeit 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

Legt die E-Mail-Zustellungseinstellungen des Mitglieds fest. Dieses Feld wird nur von den Methoden insert, update und get unterstützt.

Akzeptable Werte sind:

  • ALL_MAIL: alle Nachrichten, die direkt nach dem Eintreffen zugestellt werden
  • DAILY: Nicht mehr als eine Nachricht pro Tag.
  • DIGEST: Bis zu 25 Nachrichten, die in einer Nachricht zusammengefasst sind.
  • DISABLED: Abo entfernen.
  • NONE: Keine Nachrichten.
id

string

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

Methoden

delete

 Ein Mitglied wird aus einer Gruppe entfernt.

get

 Ruft die Eigenschaften 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 einer Gruppe ab.

patch

 Aktualisiert die Mitgliedschaftseigenschaften eines Nutzers in der angegebenen Gruppe.

update

 Aktualisiert die Mitgliedschaft eines Nutzers in der angegebenen Gruppe.