Creazione e ricerca di gruppi Google
Questa pagina spiega come eseguire alcune operazioni fondamentali con l'API Cloud Identity Groups.
Prima di iniziare
Prima di procedere con le informazioni riportate in questa pagina, svolgi le seguenti attività:
Leggi la panoramica dell'API Groups.
Creare un gruppo Google
REST
Per creare un gruppo Google, chiama
groups.create()
con
un'istanza del nuovo gruppo. L'istanza di gruppo deve includere groupKey
,
Parent
e label
impostati su cloudidentity.googleapis.com/groups.discussion_forum
.
Devi anche impostare il parametro initialGroupConfig
, che definisce il
proprietario iniziale del gruppo. Per questo parametro puoi utilizzare i seguenti valori:
WITH_INITIAL_OWNER
: rende la persona che invia la richiesta proprietaria del gruppo. Nella maggior parte dei casi, devi utilizzare questo valore.EMPTY
: crea un gruppo senza proprietari iniziali. Puoi utilizzare questo valore solo se sei un super amministratore o un amministratore di gruppi di Google Workspace. Per maggiori informazioni sui ruoli di Google Workspace, consulta Ruoli amministrativi predefiniti.
Python
L'esempio seguente mostra una funzione di supporto per creare un gruppo Google utilizzando la libreria client 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)
Ricerca di un gruppo Google
REST
Per cercare un gruppo Google, chiama
groups.search()
con
una stringa di query. Per cercare tutti i gruppi, devi solo fornire l'etichettacloudidentity.googleapis.com/groups.discussion_forum
.
Python
L'esempio seguente mostra una funzione di supporto utilizzata per cercare un gruppo Google utilizzando la libreria client 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
Passaggi successivi
Una volta creato un gruppo, puoi creare le relative iscrizioni. Per creare appartenenze per un gruppo Google, consulta Gestire le appartenenze per i gruppi Google.