Migrar o app Google Chat

Se você mesclar organizações do Google Workspace, talvez seja necessário migrar o app Chat para que ele continue funcionando.

Antes de migrar o app Chat, verifique com o administrador da sua organização se as configurações administrativas estão afetando o app. Mudar uma configuração administrativa pode restaurar a funcionalidade completa do app Chat e tornar a migração desnecessária. Por exemplo, o administrador do Google Workspace pode precisar adicionar seu 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 ser migrados após a fusão de organizações do Google Workspace.

Depois de determinar que você precisa migrar seu app do Chat, siga este processo de três etapas:

  1. Configure o ambiente do seu app do Chat criando um projeto do Google Cloud na organização unificada, ativando APIs e configurando a tela de consentimento do OAuth 2.0.
  2. Reimplante o app Chat no novo projeto do Cloud.
  3. Adicione o app do Chat recriado aos espaços ou conversas do Chat e desative o app original.

Criar um projeto do Cloud na organização mesclada e ativar as APIs

Criar um projeto do Cloud e ativar APIs para o app Chat na organização unificada do Google Workspace garante que os usuários e grupos que você permite acessar o app Chat possam fazer isso sem erros.

Criar um projeto do Cloud

Console do Google Cloud

  1. No console do Google Cloud, acesse Menu > IAM e administrador > Criar um projeto.

    Acessar "Criar um projeto"

  2. No campo Nome do projeto, insira um nome descritivo para o projeto.

    Opcional: para editar o ID do projeto, clique em Editar. O ID não pode ser alterado após a criação do projeto. Portanto, escolha um ID que atenda às suas necessidades durante a vida útil dele.

  3. No campo Local, clique em Procurar para mostrar os locais possíveis para seu projeto. Em seguida, clique em Selecionar.
  4. 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.
    Ativar o Cloud Shell
  • Shell local: para usar um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud.
    Para criar um projeto do Cloud, use o comando gcloud projects create: 
    gcloud projects create PROJECT_ID
     Substitua PROJECT_ID definindo o ID do projeto que você quer criar.

Ativar APIs

Todos os apps do Chat precisam ter a API Google Chat ativada. Dependendo de como o app do Chat foi criado, talvez seja necessário ativar outras APIs. Por exemplo, se você criou seu app do Chat usando o Google Cloud Functions, ative as APIs Cloud Build, Cloud Functions, Pub/Sub, Cloud Logging, Artifact Registry e 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.

Para ativar uma API, faça o seguinte:

Console do Google Cloud

  1. No console do Google Cloud, acesse Menu > Mais produtos > Google Workspace > Biblioteca de produtos.

    Acessar a biblioteca de produtos

  2. Clique na API que você quer ativar.
  3. Clique em Ativar.
  4. Para ativar mais APIs, repita essas etapas.

Google Cloud CLI

  1. Instale ou abra a interface de linha de comando (CLI) do Google Cloud.

  2. Execute o comando services enable, especificando qual serviço de API ativar.

    gcloud services enable API_SERVICE_ID

Configurar a API Chat

No novo projeto do Cloud, use a API Chat para especificar o nome, a descrição e o ícone do app Chat. Para configurar esses detalhes, consulte Configurar a API Chat

Talvez seja necessário configurar a tela de permissão OAuth do seu projeto do Cloud. Se você já usou o OAuth 2.0 para autorização, use os mesmos escopos de acesso.

  1. No console do Google Cloud, acesse Menu > > Branding.

    Acessar Branding

  2. Se você já tiver configurado o , poderá definir as seguintes configurações da tela de permissão do OAuth em Branding, Público-alvo e Acesso a dados. Se aparecer uma mensagem informando que ainda não foi configurado, clique em Começar:
    1. Em Informações do app, no campo Nome do app, insira um Nome do app.
    2. Em E-mail para suporte do usuário, escolha um endereço de e-mail para que os usuários entrem em contato com você se tiverem dúvidas sobre o consentimento deles.
    3. Clique em Próxima.
    4. Em Público, selecione o tipo de usuário do seu app.
    5. Clique em Próxima.
    6. Em Informações de contato, insira um Endereço de e-mail para receber notificações sobre mudanças no seu projeto.
    7. Clique em Próxima.
    8. Em Concluir, leia a Política de dados do usuário dos serviços de API do Google e, se concordar, selecione Concordo com a Política de dados do usuário dos serviços de API do Google.
    9. Clique em Continuar.
    10. Clique em Criar.
    11. Se você selecionou Externo como o tipo de usuário, adicione usuários de teste:
      1. Clique em Público-alvo.
      2. Em Usuários de teste, clique em Adicionar usuários.
      3. Insira seu endereço de e-mail e os outros usuários de teste autorizados. Depois, clique em Salvar.

  3. Se você estiver criando um app para uso fora da sua organização do Google Workspace, clique em Acesso a dados > Adicionar ou remover escopos. Recomendamos as seguintes práticas recomendadas ao selecionar escopos:

    • Selecione os escopos que fornecem o nível mínimo de acesso exigido pelo app. Para uma lista de escopos disponíveis, consulte Escopos do OAuth 2.0 para APIs do Google.
    • Revise os escopos listados em cada uma das três seções: não sensíveis, sensíveis e restritos. Para os escopos listados nas seções "Seus escopos sensíveis" ou "Seus escopos restritos", tente identificar escopos alternativos não sensíveis para evitar análises adicionais desnecessárias.
    • Alguns escopos exigem análises adicionais do Google. Para apps usados apenas 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 sensíveis não exige mais análise do Google. Para mais informações, consulte Categorias de escopo.
  4. Depois de selecionar os escopos necessários para seu app, clique em Salvar.

Para mais informações sobre como configurar o consentimento do OAuth, consulte Começar a usar o .

Redistribuir o app Chat para o novo projeto do Cloud

Dependendo se o app Chat foi criado com o Apps Script, o AppSheet ou outro tipo de conexão, como Python ou Java, a nova implantação do app Chat é um pouco diferente. Em qualquer um dos casos, não é necessário recriar todo o código, mas é preciso fazer algumas mudanças.

Migrar a lógica do app Chat

Dependendo da arquitetura do seu app do Chat, talvez seja necessário migrar outros serviços para o novo projeto do Cloud:

  • Para apps HTTP, também é necessário migrar o restante da lógica do app criada com o Cloud Functions, o Cloud Run ou o App Engine.
  • Para apps de chat conversacionais que usam linguagem natural, também é necessário migrar os agentes do Dialogflow.
  • Para apps de chat criados atrás de um firewall, também é necessário migrar os tópicos do Pub/Sub.

Configurar recursos interativos no novo projeto do Cloud

Para fazer uma nova implantação do app do Chat criado com uma linguagem como Python ou Java, configure o app do Chat no seu novo projeto do Cloud.

Para configurar recursos interativos, consulte Receber e responder a interações do usuário.

Redeploy um app do Chat do Apps Script

Para reimplantar o app do Chat criado com o Apps Script, mude o número do projeto do Cloud associado ao projeto do Apps Script para o número do projeto que pertence ao novo projeto do Cloud. Em seguida, copie o ID de implantação do Apps Script e cole na página de configuração do app Chat no console do Google Cloud.

Copiar o número do projeto do Cloud

  1. No console do Google Cloud, acesse Menu > IAM e administrador > Configurações.

    Acessar as configurações do IAM e do administrador

  2. No campo Número do projeto, copie o valor.

Definir o número do projeto do Google Cloud no projeto do Apps Script

  1. Acesse o Apps Script.

    Acessar o Apps Script

  2. No projeto do Apps Script do app Chat, clique em Configurações do projeto .

  3. Em Projeto do Google Cloud Platform (GCP), clique em Mudar projeto.

  4. Em Número do projeto do GCP, cole o número do projeto do Google Cloud.

  5. Clique em Configurar projeto.

Copie o ID de implantação do projeto do Apps Script.

  1. Na parte de cima à direita do Apps Script, clique em Implantar > Gerenciar implantações.
  2. Em ID da implantação, clique em Copiar.
  3. Clique em Concluído.

Reconfigurar e reimplantar seu app do Chat

  1. No console do Google Cloud, pesquise "API Google Chat" e clique em API Google Chat e em Gerenciar.

    Acessar a API Chat

  2. Clique na guia Configuração e insira as seguintes informações obrigatórias:

    • Nome do app: o nome que as pessoas usam ao interagir com seu app de chat.
    • URL do avatar: um URL HTTPS que aponta para uma imagem gráfica quadrada (por exemplo, PNG ou JPEG), de pelo menos 128 x 128, que aparece como o avatar do seu app de chat.
    • Descrição: uma descrição da finalidade pretendida do app Chat que aparece abaixo do nome dele.

  3. Para ativar os recursos interativos, clique na chave Ativar recursos interativos, que permite que os usuários interajam com seu app do Chat:

  4. Em "Configurações de conexão", selecione Projeto do Apps Script.

  5. No campo ID da implantação, cole o ID que você copiou antes.

  6. Para concluir o restante da configuração, consulte a tabela em Configurar o app Chat no novo projeto do Cloud

  7. Clique em Salvar.

Redeploy um app do Chat do AppSheet

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 se autenticar 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 do Chat.

Compartilhar o app Chat

Antes que o app do Chat fique disponível para os usuários na nova organização, o administrador talvez precise permitir manualmente o acesso ao app do Chat. Para mais informações, consulte Configurar o acesso para organizações do Google Workspace na documentação do Google Workspace Marketplace.

Mudar para o novo app Chat

Agora que o app Chat foi migrado para a nova organização, é hora de divulgá-lo. Adicione o novo app aos espaços do Chat ou mensagens diretas e remova o app antigo para que as pessoas só enviem mensagens para o app migrado.

Adicionar o novo app do Chat aos espaços do Chat

  1. Acesse o Chat.

    Acessar o Chat

  2. Clique em uma mensagem direta ou um espaço.

  3. Clique no menu suspenso ao lado do nome do espaço ou da pessoa e selecione Apps e integrações.

  4. Clique em Adicionar apps.

  5. Digite o nome do app, selecione-o na lista e clique em Adicionar.

  6. Repita essas etapas para cada espaço ou mensagem direta em que você quer adicionar o app do Chat.

Remover o app Chat antigo dos espaços do Chat

  1. Acesse o Chat.

    Acessar o Chat

  2. Clique em uma mensagem direta ou um espaço.

  3. Clique no menu suspenso ao lado do nome do espaço ou da pessoa e selecione Apps e integrações.

  4. Ao lado do app Chat antigo, que não foi migrado, clique em Mais opções e em Remover do espaço.

  5. Repita essas etapas para cada espaço ou mensagem direta em que você quer remover o app Chat antigo.

Desativar o app Chat antigo

Para impedir que os usuários usem o app Chat antigo e incentivar o uso do novo, desative e cancele a publicação do app antigo no Google Workspace Marketplace.