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 häufigen Aufgaben von Gruppenmitgliedern finden Sie im Entwicklerleitfaden.

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. Bei Mitgliederressourcen ist der Wert admin#directory#member.
email

string

Die E-Mail-Adresse des Mitglieds. Ein Mitglied kann ein Nutzer oder eine andere Gruppe sein. Diese Eigenschaft 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 an der E-Mail-Adresse automatisch in der API berücksichtigt.
role

string

Die Rolle des Mitglieds in einer Gruppe. Die API gibt einen Fehler für Zyklen in Gruppenmitgliedschaften zurück. Wenn group1 beispielsweise Mitglied von group2 ist, kann group2 kein 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 ist. Weitere Informationen finden Sie unter Google Groups for Business aktivieren und deaktivieren. Eine MANAGER-Rolle hat dieselben Berechtigungen wie eine OWNER-Rolle, mit der Ausnahme, dass ein Mitglied nicht zum OWNER ernannt oder die Gruppe nicht gelöscht werden kann. Eine Gruppe kann mehrere MANAGER Mitglieder haben.
  • MEMBER: Mit dieser Rolle können Gruppen abonniert, Diskussionsarchive aufgerufen und die Mitgliederliste der Gruppe eingesehen werden. Weitere Informationen zu Mitgliederrollen finden Sie unter Mitgliedern Rollen zuweisen.
  • OWNER: Mit dieser Rolle können Nachrichten an die Gruppe gesendet, Mitglieder hinzugefügt oder entfernt, Mitgliedsrollen geändert, die Gruppeneinstellungen geändert und die Gruppe gelöscht werden. 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. Stattdessen wird die Kundennummer zurückgegeben.
  • EXTERNAL: Das Mitglied ist ein Nutzer oder eine Gruppe außerhalb der Domain. (Derzeit nicht verwendet)
  • GROUP: Das Mitglied gehört zu einer anderen Gruppe.
  • USER: Das Mitglied ist ein Nutzer.
status

string

Status des Mitglieds (unveränderlich)
delivery_settings

string

Definiert die Einstellungen für die Zustellung von E-Mails an das Mitglied. Dieses Feld wird nur von den Methoden insert, update und get unterstützt.

Akzeptable Werte sind:

  • ALL_MAIL: Alle Nachrichten werden sofort zugestellt, sobald sie eingehen.
  • DAILY: Maximal eine Nachricht pro Tag.
  • DIGEST: Bis zu 25 Nachrichten in einer E-Mail zusammengefasst.
  • DISABLED: Abo entfernen
  • NONE: Keine Nachrichten.
id

string

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

Methoden

delete

 Entfernt ein Mitglied aus einer Gruppe.

get

 Ruft die Eigenschaften eines Gruppenmitglieds ab.

hasMember

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

insert

 Fügen Sie der angegebenen Gruppe einen Nutzer hinzu.

list

 Ruft eine paginated 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.