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.

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

  • WITH_INITIAL_OWNER: Die Person, die die Anfrage sendet, wird zum Eigentümer der Gruppe. Dieser Wert sollte in den meisten Fällen verwendet werden.
  • EMPTY: Damit wird eine Gruppe ohne Eigentümer erstellt. Sie können diesen Wert nur verwenden, wenn Sie Google Workspace-Super Admin oder Gruppenadministrator sind. Weitere Informationen zu Google Workspace-Rollen finden Sie im Hilfeartikel 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