Crear y buscar grupos de Google

En esta página se explica cómo realizar algunas operaciones fundamentales con la API Groups de Cloud Identity.

Antes de empezar

Realiza las siguientes tareas antes de continuar con la información de esta página:

Crear un grupo de Google

REST

Para crear un grupo de Google, llama a groups.create() con una instancia del nuevo grupo. La instancia de grupo debe incluir groupKey, Parent y label con el valor cloudidentity.googleapis.com/groups.discussion_forum.

También debe definir el parámetro initialGroupConfig, que define el propietario inicial del grupo. Puede usar los siguientes valores para este parámetro:

  • WITH_INITIAL_OWNER: convierte a la persona que envía la solicitud en propietaria del grupo. Debería usar este valor en la mayoría de los casos.
  • EMPTY: crea un grupo sin propietarios iniciales. Solo puedes usar este valor si eres superadministrador o administrador de grupos de Google Workspace. Para obtener más información sobre los roles de Google Workspace, consulta el artículo Roles de administrador predefinidos.

Python

En el siguiente ejemplo se muestra una función auxiliar para crear un grupo de Google con la biblioteca de cliente de 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)

Buscar un grupo de Google

REST

Para buscar un grupo de Google, llama a groups.search() con una cadena de consulta. Para buscar todos los grupos, solo tienes que proporcionar la etiqueta cloudidentity.googleapis.com/groups.discussion_forum.

Python

En el siguiente ejemplo se muestra una función auxiliar que se usa para buscar un grupo de Google con la biblioteca de cliente de 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

Siguientes pasos