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.

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?

Una vez que exista un grupo, puedes crearle membresías. Si quieres crear membresías para un Grupo de Google, consulta Administra las membresías de los Grupos de Google.