Migrar o app Google Chat

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

Antes de migrar o app do 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 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 ser migrados após a mesclagem de organizações do Google Workspace.

Depois de determinar que você precisa migrar o app do Chat, conclua o processo de três etapas a seguir:

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

Criar um projeto na nuvem na organização mesclada e ativar APIs

A criação de um novo projeto na nuvem e a ativação de APIs para o app do Chat na organização mesclada do Google Workspace garantem que os usuários e grupos que você permite acessar o app do Chat possam fazer isso sem erros.

Criar um projeto na nuvem

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 do projeto não pode ser alterado depois que o projeto é criado. Portanto, escolha um ID que atenda às suas necessidades durante a vida útil do projeto.

  3. No campo Local, clique em Procurar para mostrar os locais possíveis para o seu projeto. Em seguida, clique em Selecionar.
  4. Clique em Criar. O console do Google Cloud navega até a página "Painel", e o projeto é criado em alguns minutos.

CLI 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 na nuvem, 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 é criado, talvez seja necessário ativar outras APIs. Por exemplo, se você criou o app do Chat usando o Google Cloud Functions, ative a API Cloud Build, a API Cloud Functions, a API Pub/Sub, a API Cloud Logging, a API Artifact Registry e a API Cloud Run. Como prática recomendada, para garantir que o app migrado funcione, ative as mesmas APIs no novo projeto na nuvem que estão ativadas no projeto na nuvem antigo.

Para ativar uma API, faça o seguinte:

Console do Google Cloud

  1. No console do Google Cloud, acesse Menu > APIs e serviços > Biblioteca > Google Workspace.

    Acessar a biblioteca de APIs

  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 Google Cloud Command Line Interface (CLI).

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

    gcloud services enable API_SERVICE_ID

Configurar a API Chat

No novo projeto na nuvem, você precisa usar a API Chat para especificar o nome, a descrição e o ícone do app do Chat. Para configurar esses detalhes, consulte Configurar a API Chat

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

  1. No Console de APIs do Google, acesse Menu > Plataforma de autenticação do Google > Branding.

    Acessar Branding

  2. Se você já configurou a plataforma de autenticação do Google, pode configurar as seguintes configurações da tela de permissão OAuth em Branding, Público-alvo e Acesso a dados. Se você receber uma mensagem informando que a plataforma de autenticação do Google ainda não está configurada, 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 de suporte para que os usuários possam entrar em contato com você se tiverem dúvidas sobre o consentimento.
    3. Clique em Próxima.
    4. Em Público-alvo, selecione o tipo de usuário do 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 projeto.
    7. Clique em Próxima.
    8. Em Concluir, revise 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 para 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 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: escopos não sensíveis sensíveis e restritos. Para todos os escopos listados nas "Seus escopos sensíveis" ou "Seus escopos restritos" seções, tente identificar escopos não sensíveis alternativos para evitar outras revisões desnecessárias.
    • Alguns escopos exigem revisões adicionais do Google. Para apps usados apenas internamente pela organização do Google Workspace, os escopos não são listados na tela de permissão, e o uso de escopos restritos ou sensíveis não exige mais revisões do Google. Para mais informações, consulte Categorias de escopo.
  4. Depois de selecionar os escopos exigidos pelo app, clique em Salvar.

Para mais informações sobre como configurar a permissão OAuth, consulte Introdução à plataforma de autenticação do Google.

Reimplantar o app do Chat no novo projeto na nuvem

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

Migrar a lógica do app do Chat

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

  • Para apps HTTP, também é necessário migrar o restante da lógica do app que foi criada usando funções do Cloud Run, 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 na nuvem

Para reimplantar o app do Chat criado com uma linguagem como Python ou Java, configure o app do Chat no novo projeto na nuvem.

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

Reimplantar um app do Chat do Apps Script

Para reimplantar o app do Chat criado com o Apps Script, mude o número do projeto na nuvem associado ao projeto do Apps Script para o número do projeto que pertence ao seu novo projeto na nuvem. 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 de APIs do Google.

Copiar o número do projeto na nuvem

  1. No Console de APIs do Google, 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 na nuvem 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 do 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.

Copiar o ID de implantação do projeto do Apps Script

  1. No canto superior direito do Apps Script, clique em Implantar > Gerenciar implantações.
  2. Em ID de implantação, clique em Copiar.
  3. Clique em Concluído.

Reconfigurar e reimplantar o app do Chat

  1. No Console de APIs do Google, pesquise "API Google Chat" e clique 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 o app do 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 app do Chat.
    • Descrição: uma descrição da finalidade pretendida do app do Chat, que aparece abaixo do nome do app.

  3. Para ativar recursos interativos, clique na opção Ativar recursos interativos que permite que os usuários interajam com o app do Chat:

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

  5. No campo ID de implantação, cole o ID de implantação que você copiou anteriormente.

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

  7. Clique em Salvar.

Reimplantar um app do Chat do AppSheet

Para reimplantar o app do Chat criado com o AppSheet no novo projeto na nuvem, copie o app para o novo projeto na nuvem.

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 para as 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 do 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 do Chat

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

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

  1. Acesse o Chat.

    Acessar o Chat

  2. Clique em uma mensagem direta ou 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. Insira 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 do Chat antigo de espaços do Chat

  1. Acesse o Chat.

    Acessar o Chat

  2. Clique em uma mensagem direta ou 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 do Chat antigo e não 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 do Chat antigo.

Desativar o app do Chat antigo

Para impedir que os usuários usem o app do Chat antigo e incentivá-los a usar o novo app do Chat, desative o app do Chat antigo e cancele a publicação dele no Google Workspace Marketplace.