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. É possível usar os seguintes valores para esse
parâmetro:
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. Só é possível usar esse valor se você for um superadministrador ou administrador de grupos do Google Workspace. Para mais informações sobre as funções do Google Workspace, consulte Administrador pré-criado de classificação..
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.