Como criar e pesquisar 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
.
Você também precisa definir o parâmetro initialGroupConfig
, que define o
proprietário inicial do grupo. Você pode usar os seguintes valores para esse parâmetro:
WITH_INITIAL_OWNER
: torna a pessoa que envia a solicitação o proprietário do grupo. Use esse valor na maioria dos casos.EMPTY
: cria um grupo sem proprietários iniciais. Esse valor só poderá ser usado se você for um superadministrador do Google Workspace ou administrador de grupos. Para mais informações sobre os papéis do Google Workspace, consulte Papéis de administrador pré-criados.
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 associações a um Grupo do Google, consulte Como gerenciar associações a Grupos do Google.
Você pode atualizar um grupo do Google para um grupo de segurança.