Créer et rechercher des groupes Google

Cette page explique comment effectuer certaines opérations fondamentales avec l'API Cloud Identity Groups.

Avant de commencer

Effectuez les tâches suivantes avant d'utiliser les informations fournies sur cette page :

Créer un groupe Google

REST

Pour créer un groupe Google, appelez la méthode groups.create() avec une instance du nouveau groupe. L'instance de groupe doit inclure les paramètres groupKey, Parent et label définis sur cloudidentity.googleapis.com/discussion_forums.

Python

L'exemple suivant montre une fonction d'assistance pour créer un groupe Google à l'aide de la bibliothèque cliente Python :

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)

Rechercher un groupe Google

REST

Pour rechercher un groupe Google, appelez la méthode groups.search() avec une chaîne de requête. Pour rechercher tous les groupes, vous ne devez fournir que le libellé cloudidentity.googleapis.com/discussion_forums.

Python

L'exemple suivant montre une fonction d'assistance utilisée pour rechercher un groupe Google à l'aide de la bibliothèque cliente Python :

def search_google_groups(service, identity_source_id, pageSize, view):
  # Set the label to search for all Google groups
  searchQuery = "&query=labels:cloudidentity.googleapis.com/discussion_forums" \
    + "&pageSize=" + pageSize + "&view=" + view
  try:
    searchGroupsRequest = service.groups().search()
    searchGroupsRequest.uri += searchQuery
    response = searchGroupsRequest.execute()
    print response
  except Exception, e:
    print e

Étape suivante

Une fois qu'un groupe existe, vous pouvez lui créer des adhésions. Pour créer des adhésions à un groupe Google, reportez-vous à la section Gérer les adhésions pour Google Groupes.