Como criar e pesquisar 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.

Você também precisa definir o parâmetro initialGroupConfig, que define o proprietário inicial do grupo. Você pode usar os seguintes valores para esse parâmetro:

  • WITH_INITIAL_OWNER: torna a pessoa que envia a solicitação o proprietário do grupo. Use esse valor na maioria dos casos.
  • EMPTY: cria um grupo sem proprietários iniciais. Esse valor só poderá ser usado se você for um superadministrador do Google Workspace ou administrador de grupos. Para mais informações sobre os papéis do Google Workspace, consulte Papéis de administrador pré-criados.

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