Como criar e pesquisar nos Grupos do Google
Nesta página, explicamos como executar algumas operações fundamentais com a API Cloud Identity Groups.
Antes de começar
Execute as seguintes tarefas antes de continuar com as informações desta página:
Como criar um Grupo do Google
REST
Para criar um Grupo do Google, chame
groups.create()
com uma instância do novo grupo. A instância do grupo precisa incluir groupKey
,
Parent
e label
definidos como cloudidentity.googleapis.com/groups.discussion_forum
.
Também é necessário definir o parâmetro initialGroupConfig
, que define o
proprietário inicial do grupo. Você pode usar os seguintes valores para isso
:
WITH_INITIAL_OWNER
: torna a pessoa que envia a solicitação o proprietário do o grupo. Use esse valor na maioria dos casos.EMPTY
: cria um grupo sem proprietários iniciais. Esse valor só pode ser usado superadministrador do Google Workspace ou administrador de grupos. Para mais informações sobre as funções do Google Workspace, consulte Administrador pré-criado de rede.
Python
No exemplo a seguir, mostramos uma função auxiliar para criar um Grupo do Google usando a biblioteca de cliente do 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)
Como pesquisar um Grupo do Google
REST
Para pesquisar um Grupo do Google, chame
groups.search()
com uma string de consulta. Para pesquisar todos os grupos, só é necessário fornecer o rótulo
cloudidentity.googleapis.com/groups.discussion_forum
.
Python
Veja no exemplo a seguir uma função auxiliar usada para pesquisar grupos do Google usando a biblioteca de cliente do 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
A seguir
Você pode criar assinaturas para um grupo depois de criá-lo. Para criar assinaturas para um Grupo do Google, consulte Como gerenciar assinaturas para Grupos do Google.
Você pode atualizar um grupo do Google para um grupo de segurança.