Crea y busca Grupos de Google

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

Antes de comenzar

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

Crea un Grupo de Google

REST

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

También debes establecer el parámetro initialGroupConfig, que define el propietario inicial del grupo. Puedes usar los siguientes valores para este parámetro:

  • WITH_INITIAL_OWNER: Hace que la persona que envía la solicitud sea propietaria del grupo. Deberías usar este valor en la mayoría de los casos.
  • EMPTY: Crea un grupo sin propietarios iniciales. Solo puedes usar este valor si eres administrador avanzado de Google Workspace o administrador de grupos. Para obtener más información sobre las funciones de Google Workspace, consulta Funciones de administrador compiladas con anterioridad.

Python

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

Busca un Grupo de Google

REST

Para buscar un Grupo de Google, llama a groups.search() con una string de consulta. Para buscar todos los grupos, solo debes 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 mediante la biblioteca 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

¿Qué sigue?