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 o proprietário do o 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 Administrador pré-criado de classificação..

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