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/groups.discussion_forum.

Vous devez également définir le paramètre initialGroupConfig, qui définit le propriétaire initial du groupe. Vous pouvez utiliser les valeurs suivantes pour ce paramètre:

  • WITH_INITIAL_OWNER: rend la personne qui envoie la requête propriétaire du groupe. Dans la plupart des cas, vous devez utiliser cette valeur.
  • EMPTY: crée un groupe sans propriétaires initiaux. Vous ne pouvez utiliser cette valeur que si vous êtes super-administrateur Google Workspace ou administrateur de groupes. Pour en savoir plus sur les rôles Google Workspace, consultez Rôles d'administrateur prédéfinis.

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/groups.discussion_forum.

Python

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

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

Étape suivante