Google Groups erstellen und suchen

Auf dieser Seite wird erläutert, wie Sie einige grundlegende Vorgänge mit der Cloud Identity Groups API ausführen.

Hinweise

Führen Sie folgende Aufgaben aus, bevor Sie die Informationen auf dieser Seite umsetzen:

Google Groups-Gruppe erstellen

REST

Rufen Sie zum Erstellen einer Google Groups-Gruppe groups.create() mit einer Instanz der neuen Gruppe auf. Die Gruppeninstanz muss einen groupKey, einen Parent und ein label enthalten, das auf cloudidentity.googleapis.com/groups.discussion_forum festgelegt ist.

Außerdem müssen Sie den Parameter initialGroupConfig festlegen, der den ursprünglichen Inhaber der Gruppe definiert. Sie können für diesen Parameter die folgenden Werte verwenden:

  • WITH_INITIAL_OWNER: Die Person, die die Anfrage sendet, wird zum Inhaber der Gruppe. In den meisten Fällen sollten Sie diesen Wert verwenden.
  • EMPTY: Erstellt eine Gruppe ohne ursprüngliche Inhaber. Sie können diesen Wert nur verwenden, wenn Sie ein Google Workspace-Super Admin oder ein Gruppenadministrator sind. Weitere Informationen zu Google Workspace-Rollen finden Sie unter Vordefinierte Administratorrollen.

Python

Im folgenden Beispiel wird eine Hilfsfunktion zum Erstellen einer Google Groups mithilfe der Python-Clientbibliothek gezeigt:

def create_google_group(service, customer_id, group_id, group_display_name, group_description):
  group_key = {"id": group_id}
  group = {
    "parent": "customers/" + customer_id,
    "description": group_description,
    "displayName": group_display_name,
    "groupKey": group_key,
    # Set the label to specify creation of a Google Group.
    "labels": {
      "cloudidentity.googleapis.com/groups.discussion_forum": ""
    }
  }

  try:
    request = service.groups().create(body=group)
    request.uri += "&initialGroupConfig=WITH_INITIAL_OWNER"
    response = request.execute()
    print(response)
  except Exception as e:
    print(e)

Nach einer Google Groups-Gruppe suchen

REST

Für die Suche nach einer Google Groups-Gruppe rufen Sie groups.search() mit einem Abfragestring auf. Wenn Sie nach allen Gruppen suchen möchten, müssen Sie nur das Label cloudidentity.googleapis.com/groups.discussion_forum angeben.

Python

Im folgenden Beispiel wird eine Hilfsfunktion zum Suchen nach einer Google Group mithilfe der Python-Clientbibliothek gezeigt:

from urllib.parse import urlencode

def search_google_groups(service, customer_id):
  search_query = urlencode({
          "query": "parent=='customerId/{}' && 'cloudidentity.googleapis.com/groups.discussion_forum' in labels".format(customer_id)
  })
  search_group_request = service.groups().search()
  param = "&" + search_query
  search_group_request.uri += param
  response = search_group_request.execute()

  return response

Nächste Schritte