Como criar e pesquisar nos Grupos do Google

Nesta página, explicamos como executar algumas operações fundamentais com a API Cloud Identity Groups.

Antes de começar

Execute as seguintes tarefas antes de continuar com as informações desta página:

Como criar um Grupo do Google

REST

Para criar um Grupo do Google, chame groups.create() com uma instância do novo grupo. A instância do grupo precisa incluir groupKey, Parent e label definidos como cloudidentity.googleapis.com/groups.discussion_forum.

Também é necessário definir o parâmetro initialGroupConfig, que define o proprietário inicial do grupo. É possível usar os seguintes valores para esse parâmetro:

  • WITH_INITIAL_OWNER: torna a pessoa que envia a solicitação a proprietária do grupo. Use esse valor na maioria dos casos.
  • EMPTY: cria um grupo sem proprietários iniciais. Só é possível usar esse valor se você for um superadministrador ou administrador de grupos do Google Workspace. Para mais informações sobre as funções do Google Workspace, consulte Funções de administrador predefinidas.

Python

No exemplo a seguir, mostramos uma função auxiliar para criar um Grupo do Google usando a biblioteca de cliente do 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)

Como pesquisar um Grupo do Google

REST

Para pesquisar um Grupo do Google, chame groups.search() com uma string de consulta. Para pesquisar todos os grupos, só é necessário fornecer o rótulo cloudidentity.googleapis.com/groups.discussion_forum.

Python

Veja no exemplo a seguir uma função auxiliar usada para pesquisar grupos do Google usando a biblioteca de cliente do 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

A seguir