Nesta página, explicamos como usar a API Google Chat para compartilhar um espaço do Google Chat com usuários específicos em uma organização do Google Workspace, para que eles possam descobrir e participar do espaço.
Para especificar os usuários da organização que podem descobrir e participar de um espaço, crie públicos-alvo. Um público-alvo é um grupo de pessoas, como departamentos específicos ou toda a organização, com quem você pode compartilhar um espaço do Chat para melhorar o reconhecimento e o compartilhamento. Com os públicos-alvo, também é possível gerenciar e personalizar associações a espaços, em vez de convidar usuários individuais para um espaço. Para mais informações, consulte Sobre os públicos-alvo.
Só é possível tornar os espaços nomeados detectáveis para públicos-alvo. Não é possível compartilhar outros tipos de espaços, como mensagens diretas ou conversas em grupo, com públicos-alvo.
Pré-requisitos
- Uma conta do Google Workspace com acesso ao Google Chat. A conta precisa ter o papel de superadministrador da organização do Google Workspace.
- Um público-alvo disponível para acesso no Chat Para criar um público-alvo, consulte Criar um público-alvo. Para disponibilizar um público-alvo para os espaços do Chat, consulte Configurar o acesso ao espaço para o Chat.
Encontrar o ID do público-alvo
Para encontrar o ID de um público-alvo, faça o seguinte:
No Google Admin Console, acesse Menu > Diretório > Públicos-alvo.
Na tabela Públicos-alvo, clique no campo Nome do público-alvo.
Encontre o ID do público-alvo no URL da página. O formato do URL é
https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID
, em queTARGET_AUDIENCE_ID
é o ID alfanumérico do público-alvo.
Na próxima seção, você vai usar o ID do público-alvo para criar ou atualizar um espaço detectável e torná-lo detectável para o público-alvo.
Especificar o público-alvo na solicitação da API Chat
Para criar um espaço para um público-alvo específico, use o método create()
ou
setup()
no recurso Space
. Para tornar um espaço
detectável, use o método update()
no recurso Space
. Como apenas espaços nomeados podem ser compartilhados com públicos-alvo, o tipo de espaço (representado no campo spaceType
) precisa ser SPACE
.
Para tornar um espaço detectável para seu público-alvo, inclua o objeto
AccessSettings
no recurso Space
como parte da solicitação da API Chat. No objeto, especifique o campo audience
:
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
Substitua TARGET_AUDIENCE_ID
pelo ID do público-alvo que você recebeu na seção anterior. Para usar as configurações
padrão de compartilhamento do espaço do Chat na sua organização do Google Workspace, substitua por default
.
Para detalhes sobre como criar ou atualizar espaços usando a API Chat, consulte estes guias:
Temas relacionados
- Criar um público-alvo
- Configurar o compartilhamento no Chat
- Criar espaços com diferentes níveis de acesso