Mitgliedschaften für Google Groups verwalten

Sobald eine Gruppe vorhanden ist, können Sie Mitgliedschaften für die Gruppe erstellen. Auf dieser Seite wird erläutert, wie Sie einige grundlegende Mitgliedschaftsvorgänge mit der Cloud Identity Groups API ausführen. Weitere Informationen zum Erstellen von Google-Gruppen finden Sie unter Google Groups-Gruppen erstellen und suchen.

Hinweis

Richten Sie die Authentifizierung ein und installieren Sie die Clientbibliotheken. Wie Sie dabei vorgehen, erfahren Sie unter Cloud Identity Groups-API einrichten.

Mitgliedschaft in eine Google Groups-Gruppe aufnehmen

REST

Wenn Sie einer Google Groups-Gruppe ein Mitglied hinzufügen möchten, rufen Sie groups.memberships.create() mit der ID der übergeordneten Gruppe und einer Mitgliedschaft auf. Ressource. expiryDetail ist ein optionales Feld, das hinzugefügt werden kann, um eine Ablaufzeit für die Mitgliedschaft festzulegen.

Beispiel für einen Anfragetext

{
  "preferredMemberKey": {
    "id": "techwriter@example.com"
  },
  "roles": [
    {
      "expiryDetail": {
        "expireTime": "2021-10-02T15:01:23Z"
      },
      "name": "MEMBER"
    }
  ]
}

Python

Der folgende Code zeigt, wie Sie einer Gruppe eine Mitgliedschaft hinzufügen können. expiryDetail ist ein optionales Feld, das hinzugefügt werden kann, um eine Ablaufzeit für die Mitgliedschaft festzulegen. Der Wert von preferredMemberKey ist die E-Mail-Adresse des Mitglieds.

def create_google_group_membership(service, identity_source_id, group_id, member_key):
  param = "&groupKey.id=" + group_id + "&groupKey.namespace=identitysources/" + identity_source_id
  try:
    lookupGroupNameRequest = service.groups().lookup()
    lookupGroupNameRequest.uri += param
    # Given a group ID and namespace, retrieve the ID for parent group
    lookupGroupNameResponse = lookupGroupNameRequest.execute()
    groupName = lookupGroupNameResponse.get("name")
    # Create a membership object with a memberKey and a single role of type MEMBER
    membership = {
      "preferredMemberKey": member_key,
      "roles" : {
        "name" : "MEMBER",
        "expiryDetail": {
          "expireTime": "2021-10-02T15:01:23Z"
        }
      }
    }
    # Create a membership using the ID for the parent group and a membership object
    response = service.groups().memberships().create(parent=groupName, body=membership).execute()
    print response
  except Exception, e:
    print e

Mitgliedschaften einer Google Groups-Gruppe auflisten

REST

Wenn Sie die Mitgliedschaften in einer Google-Gruppe auflisten möchten, rufen Sie groups.memberships.list() mit der ID der übergeordneten Gruppe und einer Mitgliedschaftsressource auf.

Python

Der folgende Code listet die Mitgliedschaften einer Gruppe auf:

def list_google_group_memberships(service, group_id):
  param = "&groupKey.id=" + group_id
  try:
    lookup_group_name_request = service.groups().lookup()
    lookup_group_name_request.uri += param
    lookup_group_name_response = lookup_group_name_request.execute()
    group_name = lookup_group_name_response.get("name")
    # List memberships
    response = service.groups().memberships().list(parent=group_name).execute()
    print response
  except Exception, e:
    print e