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.

Hinweis

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.

Sie müssen auch den Parameter initialGroupConfig festlegen, der die ursprünglicher Inhaber der Gruppe. Sie können folgende Werte verwenden: Parameter:

  • WITH_INITIAL_OWNER: Die Person, die die Anfrage sendet, wird zum Inhaber von der Gruppe. Sie sollten diesen Wert in den meisten Fällen verwenden.
  • EMPTY: Damit wird eine Gruppe ohne Eigentümer erstellt. Sie können nur diesen Wert verwenden wenn Sie Google Workspace Super Admin oder Groups Admin sind. Weitere Informationen Informationen zu Google Workspace-Rollen finden Sie unter Vordefinierter Administrator Rollen

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