Se você mesclar organizações do Google Workspace, talvez precise migrar suas Chat para que ele continue funcionando.
Antes de migrar o app do Chat, confirme com seu administrador da organização para ver se as configurações administrativas estão o que os afeta. Mudar uma configuração administrativa pode restaurar totalmente para o app do Chat e fazer a migração desnecessária. Por exemplo, o administrador do Google Workspace pode ter adicionar o app do Chat a uma lista de permissões ou talvez precise permitem que os usuários instalem apps do Chat. Para mais informações, consulte Determine se os apps do Google Chat precisam ser migrados após a mesclagem de organizações do Google Workspace.
Após determinar que você precisa migrar seus Siga estas três etapas para o app do Chat:
- Para configurar o ambiente do seu app do Chat, faça o seguinte: criar um projeto do Google Cloud na organização mesclada, ativar as APIs e configurar a tela de consentimento do OAuth 2.0.
- Implante o app do Chat novamente na nova do Google Cloud.
- Adicionar o app do Chat recriado ao Chat espaços ou conversas e desativa a versão original App Chat.
Criar um projeto do Cloud na organização mesclada e ativar as APIs
Criar um novo projeto do Cloud e ativar APIs para o App do Chat na organização mesclada do Google Workspace garante que os usuários e grupos com acesso O app do Chat faz isso sem erros.
Criar um projeto do Cloud
Console do Google Cloud
- No console do Google Cloud, acesse o menu > IAM e Administrador > Criar um projeto.
-
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 após a criação do projeto, então escolha um ID que atenda às suas necessidades para o ciclo de vida projeto.
- No campo Local, clique em Procurar para mostrar os possíveis locais para sua projeto. Em seguida, clique em Selecionar.
- Clique em Criar. O console do Google Cloud acessa a página "Painel" e seu projeto é criado em alguns minutos.
CLI da gcloud
Em um dos ambientes de desenvolvimento a seguir, acesse o Google Cloud CLI (`gcloud`):
-
Cloud Shell: para usar um terminal on-line com a gcloud CLI
configure o Cloud Shell.
Ativar o Cloud Shell -
Local Shell: para usar um ambiente de desenvolvimento local,
instalar e
inicializar
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 do Chat precisam ter a API Google Chat ativado. Dependendo de como o app do Chat for criado, você poderá pode precisar ativar outras APIs. Por exemplo, se você criou seu app de chat usando o Google Cloud Functions, ativar 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 funcionar, ative no novo projeto do Cloud as mesmas APIs que ativados no projeto antigo do Cloud.
Para ativar uma API, faça o seguinte:
Console do Google Cloud
- No console do Google Cloud, acesse o menu > Mais produtos > Google Workspace > Biblioteca de produtos.
- Clique na API que você quer ativar.
- Clique em 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 o serviço de API que será ativado.gcloud services enable API_SERVICE_ID
Configurar a API Chat
No novo projeto do Cloud, 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
Configurar a tela de permissão OAuth
Pode ser necessário configurar a tela de permissão OAuth para seu do Google 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 o 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 Save and continue.
Se você estiver criando um app para uso fora da sua conta do Google Workspace organização, clique em Adicionar ou remover escopos. Recomendamos as seguintes práticas ao selecionando escopos:
- Selecione os escopos que oferecem 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.
- Analise os escopos listados em cada uma das três seções: não confidencial sensíveis, sensíveis e restritos. Para qualquer escopo listado no "Seus escopos confidenciais" ou "Seus escopos restritos" em algumas seções, tente identificar escopos alternativos não confidenciais para evitar revisões adicionais desnecessárias.
- Alguns escopos exigem revisões adicionais do Google. Somente para apps usados pela sua organização do Google Workspace, os escopos não são listados tela de consentimento e o uso de escopos restritos ou sensíveis não exige revisão posterior do Google. Para mais informações, consulte Categorias de escopo.
- Após selecionar os escopos necessários ao lado do seu app, clique em Salvar e continuar.
- Se você selecionou 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 qualquer outro usuário de teste autorizado e clique em Salvar e continuar.
- Analise o resumo do registro do app. Para fazer alterações, clique em Editar. Se o app estiver tudo certo, clique em Voltar para o painel.
Implante o app do Chat novamente no novo projeto do Cloud
Se o app do Chat tiver sido criado Apps Script, AppSheet ou outro tipo de conexão, como Python ou Java, a reimplantação do app Chat difere pouco. Em ambos os casos, não é necessário recriar todo o código, mas precisamos fazer algumas mudanças.
Migrar a lógica do app do Chat
Dependendo 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 que foi criado usando o Cloud Functions, o Cloud Run ou o App Engine.
- Em apps de conversação do Chat que usam linguagem natural, você também precisam migrar os agentes do Dialogflow.
- Nos apps de chat criados com a proteção de um firewall, você também migrar os tópicos do Pub/Sub.
Configurar recursos interativos no novo projeto do Cloud
Para reimplantar seu app do Chat criado com uma linguagem como Python ou Java, configure o app do Chat um novo projeto do Cloud.
Para configurar os recursos interativos, consulte Receber e responder a interações do usuário.
Reimplantar um app do Chat do Apps Script
Para reimplantar seu app do Chat criado com no Apps Script, altere o número do projeto do Cloud do projeto do Apps Script está associado ao número do projeto que pertence ao seu novo projeto do Cloud. Em seguida, copie ID de implantação do Apps Script e cole-o no 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 o menu > IAM e Administrador > Configurações.
- No campo Número do projeto, copie o valor.
Definir o número do projeto do Google Cloud no seu projeto do Apps Script
Acesse o Apps Script.
No projeto do Apps Script no 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 seu app do Chat
No console do Google Cloud, pesquise "API Google Chat". e clique em API Google Chat e em Gerenciar.
Clique na guia Configuração e insira as seguintes informações informações:
- Nome do app: o nome que as pessoas usam ao interagir com seu App Chat.
- URL do avatar: um URL HTTPS que aponta para uma imagem quadrada (por exemplo, PNG ou JPEG), pelo menos 128 x 128, que aparece como o avatar para seu app do Chat.
- Descrição: uma descrição do A finalidade do app de chat que aparece abaixo do nome do app do Chat.
Para ativar os recursos interativos, clique no botão Ativar recursos interativos para permitir 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ê já usou. copiado.
Para concluir o restante da configuração, consulte a tabela na Configurar o app do Chat no novo projeto do Cloud
Clique em Salvar.
Reimplantar um app do Chat do AppSheet
Para reimplantar seu app do Chat criado com AppSheet no seu novo projeto do Cloud, copiar o app para o novo projeto do Cloud.
Atualizar a conta de serviço
Se o app do Chat for autenticado como app e usar uma para fazer chamadas às APIs do Google, atualize o Detalhes da conta de serviço do app do Chat. Para mais informações, consulte Faça a autenticação como um app do Chat.
Compartilhar o app do Chat
Antes de o app do Chat ser disponibilizado para os usuários no sua nova organização administrador pode ter que permitir manualmente o acesso ao App Chat. 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 o novo organização, é hora de divulgá-lo. Adicionar aos espaços do Chat ou mensagens diretas e remova o app Chat antigo para que as pessoas enviem mensagens apenas para os App Chat.
Adicionar o novo app do Chat aos espaços do Chat
Acesse o Chat.
Clique em uma mensagem direta ou em um espaço.
Clique no menu suspenso ao lado do nome do espaço ou da pessoa e, em seguida, selecione Aplicativos e e integrações com outros clientes.
Clique em Adicionar apps.
Digite o nome do app, selecione-o na lista e clique em Adicionar.
Repita essas etapas para cada espaço ou mensagem direta que você quer adicionar. para o app do Chat.
Remover o app Chat antigo dos espaços do Chat
Acesse o Chat.
Clique em uma mensagem direta ou em um espaço.
Clique no menu suspenso ao lado do nome do espaço ou da pessoa e, em seguida, selecione Aplicativos e e integrações com outros clientes.
Ao lado do antigo app Chat não migrado, clique em Mais opções e depois clique em Remover do espaço.
Repita essas etapas para cada espaço ou mensagem direta que você quer remover. do antigo app Chat.
Desativar o app Chat antigo
Para impedir que os usuários usem o app Chat antigo e incentivá-los a usar o novo app Chat, Desativar o app Chat antigo e cancelar a publicação no Google Workspace Marketplace.