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: définit la personne qui envoie la demande comme propriétaire du groupe. Vous devez utiliser cette valeur dans la plupart des cas.
  • EMPTY: crée un groupe sans propriétaire initial. Vous ne pouvez utiliser cette valeur que si vous êtes un super-administrateur Google Workspace ou un administrateur des groupes. Pour en savoir plus sur les rôles Google Workspace, consultez la page 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

Étapes suivantes