Creazione e ricerca di gruppi Google

In questa pagina viene spiegato come eseguire alcune operazioni di base con API Cloud Identity Groups.

Prima di iniziare

Prima di procedere con le informazioni in questa pagina, esegui le operazioni seguenti:

di Gemini Advanced.

Creazione di un gruppo Google

REST

Per creare un gruppo Google, chiama groups.create() con un'istanza del nuovo gruppo. L'istanza del gruppo deve includere un elemento groupKey, Parent e label impostati su cloudidentity.googleapis.com/groups.discussion_forum.

Devi anche impostare il parametro initialGroupConfig, che definisce proprietario iniziale del gruppo. Per questo, puoi utilizzare i seguenti valori :

  • WITH_INITIAL_OWNER: rende la persona che invia la richiesta come proprietario di il gruppo. Nella maggior parte dei casi dovresti utilizzare questo valore.
  • EMPTY: crea un gruppo senza proprietari iniziali. Puoi usare solo questo valore se sei super amministratore di Google Workspace o amministratore di Gruppi. Per ulteriori informazioni informazioni sui ruoli di Google Workspace, consulta Amministratore predefinito ruoli.

Python

L'esempio seguente mostra una funzione helper 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'etichetta cloudidentity.googleapis.com/groups.discussion_forum.

Python

L'esempio seguente mostra una funzione helper utilizzata per cercare una funzione Raggruppa 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