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 :
Consultez la Présentation de l'API Groups.
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
:
WITH_INITIAL_OWNER
: rend la personne qui envoie la requête 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 super-administrateur Google Workspace ou administrateur de groupes. Pour plus d'informations sur les rôles Google Workspace, consultez l'article rôles.
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
Une fois qu'un groupe existe, vous pouvez lui créer des adhésions. Pour créer des adhésions à un groupe Google, consultez la section Gérer les adhésions pour Google Groupes.
Vous pouvez mettre à jour un groupe Google vers un groupe de sécurité.