Autorizar o GWMME para sua conta

Google Workspace Migration for Microsoft Exchange

Antes de usar o Google Workspace Migration for Microsoft Exchange (GWMME), você precisa autorizá-lo para sua conta.

Etapa 1: criar uma conta de serviço

As etapas para criar a conta de serviço serão diferentes se você quiser executar um script automatizado (recomendado) ou criar a conta de forma manual.

Opção 1: usar um script automatizado para criar a conta

Este script do GitHub não está incluído no suporte do Google Workspace. Se você tiver problemas para usar o script, siga as etapas para criar a conta manualmente. Saiba mais sobre o uso do script.

  1. Faça login como superadministrador e abra o Cloud Shell em uma janela do navegador.
  2. No shell, para iniciar o script automatizado, digite o seguinte comando:

    python3 <(curl -s -S -L https://git.io/gwmme-create-service-account)

  3. Conclua as etapas na janela do Cloud Shell.
  4. Clique em Download para salvar o arquivo JSON que contém o ID do cliente da conta de serviço no seu computador.
  5. Configure sua migração. Saiba mais em Migrar dados com o GWMME.

Saiba mais sobre o uso do script.

Opção 2: criar manualmente uma conta de serviço

Etapa 1: criar um projeto

  1. Acesse o Google Cloud e faça login como superadministrador. Se esta for a primeira vez que você faz login no console, aceite os Termos de Serviço.
  2. Clique em IAM e administrador e depoisGerenciar recursos. Talvez você precise clicar em Menu primeiro.
  3. Na parte de cima, clique em Criar projeto e digite um nome.
  4. (Opcional) Para adicionar o projeto a uma pasta, em Local, clique em Procurar, acesse a pasta e clique em Selecionar.
  5. Clique em Criar.
  6. Por padrão, apenas o criador do projeto pode gerenciá-lo. Para garantir que o projeto seja mantido caso o criador saia da organização, atribua a função de proprietário do projeto a pelo menos uma outra pessoa. Para mais detalhes, acesse Gerenciar o acesso a projetos, pastas e organizações.

Etapa 2: ativar as APIs da conta de serviço

  1. Marque a caixa ao lado do novo projeto.
  2. Clique em APIs e serviços e depoisBiblioteca. Talvez você precise clicar em Menu primeiro.
  3. Clique no nome de cada API necessária (veja abaixo) e em Ativar:
    • SDK Admin
    • API Google Calendar
    • API Contacts
    • API Gmail
    • API Groups Migration

    Dica: se você não encontrar a API, especifique o nome dela na caixa de pesquisa.

Etapa 3: configurar a tela de permissão OAuth

Dica: ao selecionar os endereços de e-mail abaixo, use contas de e-mail de administrador compartilhadas.

  1. No Google Cloud, abra o projeto que você criou.
    • Se você criou uma conta de serviço manualmente, o projeto foi criado na Etapa 1: criar um projeto.
    • Se criou o projeto usando um script, o nome dele vai aparecer no editor do Google Cloud Shell após a execução desse script.
  2. Clique em APIs e serviços e depoisTela de permissão OAuth. Talvez você precise clicar em Menu primeiro.
  3. Clique em Branding.

    Se a opção Começar não aparecer, vá para a etapa 4. Caso contrário, acesse a etapa 5.

  4. Clique em Clientes.

    Se você encontrar + Criar cliente, acesse Etapa 4: criar a conta de serviço. Caso contrário, acesse a etapa 5.

  5. Clique em Primeiros passos.
  6. Em Nome do app, insira o nome do aplicativo (por exemplo, Google Workspace Migrate ou GWM).
  7. Em E-mail para suporte do usuário, insira um e-mail para que os usuários possam entrar em contato se tiverem dúvidas e clique em Próxima.
  8. Em Público-alvo, selecione Interno e clique em Próxima.
  9. Em Informações de contato, insira os endereços de e-mail relevantes e clique em Próxima.
  10. Para Concluir, marque a caixa Concordo com a Política de dados do usuário dos serviços de API do Google.
  11. Clique em Continuar e depoisCriar.

Etapa 4: criar a conta de serviço

  1. Clique em APIs e serviços e depoisCredenciais. Talvez você precise clicar em Menu primeiro.
  2. Clique em Criar credenciais e depoisConta de serviço.
  3. Em Nome da conta de serviço, digite um nome para a conta de serviço. Também é possível adicionar uma descrição.
  4. Clique em Criar e continuar e depoisConcluído.
  5. Anote o valor do ID exclusivo da conta de serviço. Você precisará dele mais tarde. Esse valor também é o ID do cliente da conta de serviço.

    Dica: você também pode encontrar o valor na guia "Detalhes" da conta de serviço ou no arquivo JSON.

  6. Clique em Concluído e depoisSalvar.
  7. Na parte de cima, clique em Chaves e depoisAdicionar chave e depoisCriar nova chave.
  8. Verifique se o tipo de chave está definido como JSON e clique em Criar.

    Você vai receber uma mensagem informando que o arquivo JSON da chave privada da conta de serviço foi baixado para seu computador.

  9. Anote o nome do arquivo e onde ele foi salvo pelo navegador. Você precisará dele mais tarde.
  10. Clique em Fechar.

Etapa 2: autorizar seu ID do cliente no Admin Console

Se você usou um script automatizado para criar sua conta de serviço, poderá pular esta etapa.

A forma de autorização depende do tipo de conta da qual você está migrando.

Opção 1: não estou migrando de uma conta do Google Workspace

Siga estas etapas na conta de destino.

  1. No Google Admin Console, acesse Menu e depois Segurança e depoisControle de acesso e dados e depoisControles de API e depoisGerenciar a delegação em todo o domínio.

    Para realizar essa tarefa, você precisa fazer login como superadministrador.

  2. Clique em Adicionar novo e digite o ID do cliente da conta de serviço.

    Você encontra o ID (também chamado de ID exclusivo) no arquivo JSON que salvou ao criar a conta de serviço ou no Google Cloud (clique em IAM e administrador e depoisContas de serviço e depoiso nome da sua conta de serviço).

  3. Em Escopos OAuth, copie e cole a seguinte lista de escopos separada por vírgulas:

    https://www.googleapis.com/auth/contacts,
    https://www.googleapis.com/auth/admin.directory.group.readonly,
    https://www.googleapis.com/auth/admin.directory.user,
    https://www.googleapis.com/auth/apps.groups.migration,
    https://www.googleapis.com/auth/calendar,
    https://www.googleapis.com/auth/gmail.insert,
    https://www.googleapis.com/auth/gmail.labels

  4. Clique em Autorizar.
  5. Aponte para o novo ID do cliente, clique em Ver detalhes e confira se todos os escopos estão listados.

    Se um escopo não estiver listado, clique em Editar, digite o escopo ausente e clique em Autorizar. Não é possível editar o ID do cliente.

As mudanças podem levar até 24 horas, mas costumam ser mais rápidas. Saiba mais

Opção 2: migrar de uma conta do Google Workspace

As etapas necessárias variam de acordo com sua configuração. Se você tem:

  • Domínios de origem e de destino do Google Workspace diferentes: siga as etapas 1 e 2 (abaixo nesta página) para autorizar o GWMME no domínio de origem e no de destino.
  • Domínios de origem e de destino do Google Workspace que são iguais: autorize o GWMME apenas no seu domínio de destino seguindo a etapa 2 (abaixo nesta página).
  • Adicione senhas ao seu arquivo CSV de controle: autorize o GWMME apenas no domínio de destino seguindo a etapa 2 (abaixo nesta página). Em seguida, conceda acesso à sua conta de origem para apps menos seguros. Saiba mais detalhes na Etapa 2: permitir que apps menos seguros acessem contas.

Etapa 1: autorizar o GWMME no seu domínio de origem

  1. No Google Admin Console, acesse Menu e depois Segurança e depoisControle de acesso e dados e depoisControles de API e depoisGerenciar a delegação em todo o domínio.

    Para realizar essa tarefa, você precisa fazer login como superadministrador.

  2. Clique em Adicionar novo e digite o ID do cliente da conta de serviço.

    Você encontra o ID (também chamado de ID exclusivo) no arquivo JSON que salvou ao criar a conta de serviço ou no Google Cloud (clique em IAM e administrador e depoisContas de serviço e depoiso nome da sua conta de serviço).

  3. Em Escopos OAuth, copie e cole o seguinte escopo:

    https://www.googleapis.com/auth/gmail.imap_admin

  4. Clique em Autorizar.
  5. Em seguida, conclua a etapa 2 abaixo.

Etapa 2: autorizar o GWMME no seu domínio de destino

  1. No Google Admin Console, acesse Menu e depois Segurança e depoisControle de acesso e dados e depoisControles de API e depoisGerenciar a delegação em todo o domínio.

    Para realizar essa tarefa, você precisa fazer login como superadministrador.

  2. Clique em Adicionar novo e digite o ID do cliente da conta de serviço.

    Você encontra o ID (também chamado de ID exclusivo) no arquivo JSON que salvou ao criar a conta de serviço ou no Google Cloud (clique em IAM e administrador e depoisContas de serviço e depoiso nome da sua conta de serviço).

  3. Em Escopos OAuth, copie e cole a seguinte lista de escopos separada por vírgulas:

    https://www.googleapis.com/auth/contacts,
    https://www.googleapis.com/auth/admin.directory.group.readonly,
    https://www.googleapis.com/auth/admin.directory.user,
    https://www.googleapis.com/auth/apps.groups.migration,
    https://www.googleapis.com/auth/calendar,
    https://www.googleapis.com/auth/gmail.insert,
    https://www.googleapis.com/auth/gmail.labels

  4. Se os domínios de origem e destino do Google Workspace forem os mesmos, adicione o seguinte escopo:

    https://www.googleapis.com/auth/gmail.imap_admin

  5. Clique em Autorizar.
  6. Aponte para o novo ID do cliente, clique em Ver detalhes e confira se todos os escopos estão listados.

    Se um escopo não estiver listado, clique em Editar, digite o escopo ausente e clique em Autorizar. Não é possível editar o ID do cliente.

As mudanças podem levar até 24 horas, mas costumam ser mais rápidas. Saiba mais

Etapa 3: configurar sua migração

Saiba mais em Migrar dados com o GWMME.


Google, Google Workspace e marcas e logotipos relacionados são marcas registradas da Google LLC. Todos os outros nomes de empresas e produtos são marcas registradas das empresas a que estão associados.