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 configurar el parámetro initialGroupConfig
, que define el propietario inicial del grupo. Puedes usar los siguientes valores para esto
parámetro:
WITH_INITIAL_OWNER
: Hace que la persona que envía la solicitud sea propietaria de al grupo. Debes 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 ver más para conocer los roles de Google Workspace, consulta Configuración roles.
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. Para crear de un Grupo de Google, consulta Administra membresías para Grupos de Google.