Criar e pesquisar grupos Google

Esta página explica como realizar algumas operações fundamentais com a API Cloud Identity Groups.

Antes de começar

Realize as seguintes tarefas antes de continuar com as informações nesta página:

Criar um grupo Google

REST

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

Também tem de definir o parâmetro initialGroupConfig, que define o proprietário inicial do grupo. Pode usar os seguintes valores para este parâmetro:

  • WITH_INITIAL_OWNER: torna a pessoa que envia o pedido proprietária do grupo. Deve usar este valor na maioria dos casos.
  • EMPTY: cria um grupo sem proprietários iniciais. Só pode usar este valor se for um superadministrador ou um administrador de grupos do Google Workspace. Para mais informações sobre as funções do Google Workspace, consulte o artigo Funções de administrador predefinidas.

Python

O exemplo seguinte mostra uma função auxiliar para criar um grupo Google através da biblioteca cliente 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)

Pesquisar um Grupo Google

REST

Para pesquisar um grupo Google, chame groups.search() com uma string de consulta. Para pesquisar todos os grupos, só tem de indicar a etiqueta cloudidentity.googleapis.com/groups.discussion_forum.

Python

O exemplo seguinte mostra uma função auxiliar usada para pesquisar um grupo Google com a biblioteca cliente 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

O que se segue?