Se você mesclar organizações do Google Workspace, talvez precise migrar seu app do Chat para que ele continue funcionando.
Antes de migrar o app do Chat, verifique com o administrador da organização se ele está sendo afetado pelas configurações administrativas. A mudança de uma configuração administrativa pode restaurar a funcionalidade completa do app do Chat e tornar a migração desnecessária. Por exemplo, o administrador do Google Workspace pode precisar adicionar o app do Chat a uma lista de permissões ou permitir que os usuários instalem apps do Chat. Para mais informações, consulte Determinar se os apps do Google Chat precisam migrar após a mesclagem de organizações do Google Workspace.
Depois de determinar que você precisa migrar seu app do Chat, conclua o processo de três etapas a seguir:
- Para configurar o ambiente do app do Chat, crie um projeto do Google Cloud na organização mesclada, ative APIs e configure a tela de permissão do OAuth 2.0.
- Implante o app do Chat novamente no novo projeto do Cloud.
- Adicione o app do Chat recriado a espaços ou conversas do Chat e desative o app do Chat original.
Criar um projeto do Cloud na organização mesclada e ativar as APIs
A criação de um novo projeto do Cloud e a ativação de APIs para o app do Chat na organização mesclada do Google Workspace garante que os usuários e grupos com permissão de acesso ao app do Chat possam fazer isso sem erros.
Criar um projeto do Cloud
Console do Google Cloud
- No console do Google Cloud, acesse Menu > IAM e administrador > Criar um projeto.
-
No campo Nome do projeto, digite um nome descritivo para o projeto.
Opcional: para mudar o ID do projeto, clique em Editar. O ID do projeto não pode ser alterado após a criação dele. Portanto, escolha um ID que atenda às suas necessidades durante a vida útil do projeto.
- No campo Local, clique em Procurar para exibir possíveis locais para seu projeto. Em seguida, clique em Selecionar.
- Clique em Criar. O console do Google Cloud navega até a página "Painel", e seu projeto é criado em alguns minutos.
CLI da gcloud
Em um dos seguintes ambientes de desenvolvimento, acesse a CLI do Google Cloud ("gcloud"):
-
Cloud Shell: para usar um terminal on-line com a CLI gcloud
já configurada, ative o Cloud Shell.
Ative o Cloud Shell -
Shell local: para usar um ambiente de desenvolvimento local,
instale e
initialize
a CLI gcloud.
Para criar um projeto do Cloud, use o comando "gcloud projects create":
Substitua PROJECT_ID definindo o ID do projeto que você quer criar.gcloud projects create PROJECT_ID
Ativar APIs
Todos os apps de chat precisam ter a API Google Chat ativada. Dependendo de como seu app do Chat foi criado, talvez seja necessário ativar outras APIs. Por exemplo, se você criou seu app de chat usando o Google Cloud Functions, ative a API Cloud Build, API Cloud Functions, API Pub/Sub, API Cloud Logging, API Artifact Registry e API Cloud Run. Como prática recomendada, para garantir que o app migrado funcione, ative as mesmas APIs no novo projeto do Cloud que estão ativadas no projeto antigo do Cloud.
Para ativar uma API, faça o seguinte:
Console do Google Cloud
- No console do Google Cloud, acesse Menu > Mais produtos > Google Workspace > Biblioteca de produtos.
- Clique na API que você quer ativar.
- Selecione Ativar.
- Para ativar mais APIs, repita essas etapas.
Google Cloud CLI
- Instale ou abra a interface de linha de comando (CLI) do Google Cloud.
-
Execute o comando
services enable, especificando qual serviço de API será ativado.gcloud services enable API_SERVICE_ID
Configurar a tela de permissão OAuth
Pode ser necessário configurar a tela de permissão OAuth para seu projeto do Cloud. Se você já usou o OAuth 2.0 para autorização, use os mesmos escopos de acesso de autorização.
- No console do Google Cloud, acesse Menu > APIs e serviços > Tela de permissão OAuth.
- Selecione o tipo de usuário para seu app e clique em Criar.
- Preencha o formulário de registro do app e clique em Salvar e continuar.
Se você estiver criando um app para uso fora da sua organização do Google Workspace, clique em Adicionar ou remover escopos. Recomendamos as seguintes práticas ao selecionar escopos:
- Selecione os escopos que fornecem o nível mínimo de acesso exigido pelo app. Para acessar uma lista de escopos disponíveis, consulte Escopos do OAuth 2.0 para APIs do Google.
- Analise os escopos listados em cada uma das três seções: escopos não confidenciais, confidenciais e restritos. Para os escopos listados nas seções "Seus escopos confidenciais" ou "Seus escopos restritos", tente identificar escopos não confidenciais alternativos para evitar revisões desnecessárias.
- Alguns escopos exigem outras análises do Google. No caso de apps usados somente internamente pela sua organização do Google Workspace, os escopos não são listados na tela de consentimento, e o uso de escopos restritos ou confidenciais não requer análise adicional do Google. Para mais informações, consulte Categorias de escopo.
- Depois de selecionar os escopos exigidos pelo app, clique em Save and Continue.
- Se você tiver selecionado Externo como tipo de usuário, adicione usuários de teste:
- Em Usuários de teste, clique em Adicionar usuários.
- Insira seu endereço de e-mail e outros usuários de teste autorizados e clique em Salvar e continuar.
- Analise o resumo de registro do seu app. Para fazer mudanças, clique em Editar. Se o registro do app estiver correto, clique em Voltar para o painel.
Implante o app do Chat novamente no novo projeto do Cloud
Dependendo se o app do Chat foi criado com o Apps Script, o AppSheet ou outro tipo de conexão, como Python ou Java, a reimplantação do app do Chat será um pouco diferente. Em ambos os casos, não é necessário recriar todo o código, mas você precisa fazer algumas alterações.
Migrar a lógica do app do Chat
Dependendo da arquitetura do seu app do Chat, talvez seja necessário migrar outros serviços para o novo projeto do Cloud:
- Para aplicativos HTTP, você também precisa migrar o restante da lógica do aplicativo que foi criada usando o Cloud Functions, o Cloud Run ou o App Engine.
- Para apps de conversação do Chat que usam linguagem natural, você também precisa migrar os agentes do Dialogflow.
- Para apps do Chat criados atrás de um firewall, você também precisa migrar os tópicos do Pub/Sub.
Configurar o app do Chat no novo projeto do Cloud
Para reimplantar o app do Chat criado com uma linguagem como Python ou Java, configure o app do Chat no novo projeto do Cloud.
No console do Google Cloud, pesquise "API Google Chat", clique em API Google Chat e selecione Gerenciar.
Clique na guia Configuration e insira as seguintes informações necessárias:
- Nome do app: o nome que as pessoas usam ao interagir com seu app do Chat.
- URL do avatar: um URL HTTPS que aponta para uma imagem quadrada (por exemplo, PNG ou JPEG), de pelo menos 128 x 128, que aparece como o avatar do app do Chat.
- Descrição: uma descrição da finalidade pretendida do app do Chat, que aparece abaixo do nome dele.
Para ativar os recursos interativos, clique em Ativar recursos interativos, que permite aos usuários interagir com o app do Chat e use a tabela a seguir para concluir a configuração:
Campo Descrição Funcionalidade Um conjunto de campos que determina como o app de chat pode interagir com os usuários: - Receber mensagens individuais: os usuários podem encontrar e enviar mensagens para o app do Chat diretamente no Google Chat.
- Participar de espaços e conversas em grupo: os usuários podem adicionar o app Chat a espaços e conversas em grupo.
Configurações de conexão O endpoint do app do Chat, que é um destes: - URL do app: um endpoint HTTPS que hospeda a implementação do app do Chat.
- Projeto do Apps Script: um ID de implantação de um projeto do Apps Script que implementa um app do Chat.
- Nome do tópico do Cloud Pub/Sub: um tópico do Pub/Sub que o app do Chat assina como endpoint.
- Dialogflow: registra o aplicativo do Chat com uma integração com o Dialogflow. Para mais informações, consulte Criar um app do Google Chat no Dialogflow que entenda linguagem natural.
Comandos de barra Comandos que podem ser exibidos aos usuários no Google Chat. Permite que os usuários vejam as ações principais do seu app no Google Chat e escolham uma ação específica com que querem interagir. Para mais informações, consulte Responder a comandos de barra como um app do Chat. Visualizações de links padrões de URL que o app do Chat reconhece e oferece conteúdo adicional para quando os usuários enviarem links. Para mais informações, consulte Visualizar links. Visibilidade Até cinco pessoas ou um ou mais Grupos do Google podem acessar e instalar o app do Chat. Use este campo para testar o app do Chat ou para compartilhar o app do Chat com sua equipe. Confira mais informações em Configurações de visibilidade e publicação do app do Chat. Para registrar erros no Cloud Logging sempre que o app de chat retornar um erro, marque a caixa de seleção Registrar erros no Logging. Saiba mais em Registros de erros de consulta para apps do Chat.
Clique em Salvar. Quando você salva a configuração do app do Chat, ele fica disponível para os usuários especificados na organização do Google Workspace.
Reimplantar um app do Chat do Apps Script
Para reimplantar o app do Chat criado com o Apps Script, altere o número do projeto do Cloud associado ao projeto do Apps Script para o número do novo projeto do Cloud. Em seguida, copie o ID de implantação do Apps Script e cole-o na página de configuração do app do Chat no console do Google Cloud.
Copiar o número do projeto do Cloud
- No console do Google Cloud, acesse Menu > IAM e administrador > Configurações.
- No campo Número do projeto, copie o valor.
Defina o número do projeto do Google Cloud no seu projeto do Apps Script
Acesse o Apps Script.
No projeto do Apps Script do app Chat, clique em Configurações do projeto .
Em Projeto do Google Cloud Platform (GCP), clique em Mudar projeto.
Em Número do projeto do GCP, cole o número do projeto do Google Cloud.
Clique em Configurar projeto.
Copie o ID de implantação do seu projeto do Apps Script
- No canto superior direito do Apps Script, clique em Implantar > Gerenciar implantações.
- Em ID da implantação, clique em Copiar.
- Clique em Concluído.
Reconfigurar e reimplantar o app do Chat
No console do Google Cloud, pesquise "API Google Chat", clique em API Google Chat e selecione Gerenciar.
Clique na guia Configuration e insira as seguintes informações necessárias:
- Nome do app: o nome que as pessoas usam ao interagir com seu app do Chat.
- URL do avatar: um URL HTTPS que aponta para uma imagem quadrada (por exemplo, PNG ou JPEG), de pelo menos 128 x 128, que aparece como o avatar do app do Chat.
- Descrição: uma descrição da finalidade pretendida do app do Chat, que aparece abaixo do nome dele.
Para ativar os recursos interativos, clique em Ativar recursos interativos, que permite que os usuários interajam com seu app do Chat:
Em "Configurações de conexão", selecione Projeto do Apps Script.
No campo ID da implantação, cole o ID que você copiou anteriormente.
Para concluir o restante da configuração, consulte a tabela em Configurar o app do Chat no novo projeto do Cloud.
Clique em Salvar.
Reimplantar um app do AppSheet Chat
Para reimplantar o app do Chat criado com o AppSheet no novo projeto do Cloud, copie o app para o novo projeto do Cloud.
Atualizar a conta de serviço
Se o app do Chat for autenticado como um app e usar uma conta de serviço para fazer chamadas às APIs do Google, atualize os detalhes da conta de serviço do app do Chat. Para mais informações, consulte Autenticar como um app de chat.
Compartilhar o app do Chat
Antes que o app do Chat seja disponibilizado para os usuários na nova organização, talvez o administrador precise permitir manualmente o acesso a ele. Para mais informações, consulte Como os administradores do Google Workspace instalam os apps do Chat.
Mudar para o novo app Chat
Agora que o app do Chat foi migrado para a nova organização, é hora de publicá-lo. Adicione-o aos espaços ou mensagens diretas do Chat e remova o app do Chat antigo para que as pessoas enviem mensagens apenas para o app do Chat migrado.
Adicionar o novo app do Chat aos espaços do Chat
Acesse o Chat.
Clique em uma mensagem direta ou espaço.
Clique no menu suspenso ao lado do nome do espaço ou da pessoa e selecione Apps e integrações.
Clique em Adicionar apps.
Digite o nome do aplicativo, selecione-o na lista e clique em Adicionar.
Repita essas etapas para cada espaço ou mensagem direta a que você quer adicionar o app do Chat.
Remover o app do Chat antigo dos espaços do Chat
Acesse o Chat.
Clique em uma mensagem direta ou espaço.
Clique no menu suspenso ao lado do nome do espaço ou da pessoa e selecione Apps e integrações.
Ao lado do app do Chat antigo não migrado, clique em Mais opções e em Remover do espaço.
Repita essas etapas para cada espaço ou mensagem direta de que você quer remover o app Chat antigo.
Desativar o app Chat antigo
Para impedir que os usuários utilizem o app Chat antigo e incentivá-los a usar o novo, desative o app Chat antigo e cancele a publicação dele no Google Workspace Marketplace.