Autorizzare GWMME per il proprio account

Google Workspace Migration for Microsoft Exchange

Prima di utilizzare Google Workspace Migration for Microsoft Exchange (GWMME), devi autorizzarlo per il tuo account.

Passaggio 1: crea un account di servizio

Il modo in cui crei l'account di servizio varia a seconda che tu voglia eseguire uno script automatico (consigliato) o creare l'account manualmente.

Opzione 1: utilizza uno script automatico per creare l'account

Questo script GitHub non è supportato dall'assistenza Google Workspace. Se riscontri problemi durante l'utilizzo dello script, segui i passaggi per creare manualmente l'account. Scopri di più sull'utilizzo dello script.

  1. Accedi come super amministratore e apri Cloud Shell in una finestra del browser.
  2. Per avviare lo script automatico, nella shell inserisci questo comando:

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

  3. Completa i passaggi nella finestra di Cloud Shell.
  4. Fai clic su Scarica per scaricare sul tuo computer il file JSON che contiene l'ID client dell'account di servizio.
  5. Configura la migrazione. Per informazioni dettagliate, vedi Eseguire la migrazione dei dati con GWMME.

Scopri di più sull'utilizzo dello script.

Opzione 2: crea manualmente un account di servizio

Passaggio 1: crea un progetto

  1. Vai a Google Cloud e accedi come super amministratore. Se è la prima volta che accedi alla console, accetta i Termini di servizio.
  2. Fai clic su IAM e amministratore e poi Gestisci risorse. Potrebbe essere necessario fare prima clic su Menu .
  3. In alto, fai clic su Crea progetto e inserisci un nome per il progetto.
  4. (Facoltativo) Per aggiungere il progetto a una cartella, in Posizione fai clic su Sfoglia, vai alla cartella e fai clic su Seleziona.
  5. Fai clic su Crea.
  6. Per impostazione predefinita, solo il creatore del progetto ha i diritti per gestirlo. Per far sì che il progetto possa continuare a essere gestito se il suo autore lascia l'organizzazione, assegna ad almeno un'altra persona il ruolo di Project Owner. Per maggiori dettagli, vedi Gestire l'accesso a progetti, cartelle e organizzazioni.

Passaggio 2: attiva le API per l'account di servizio

  1. Seleziona la casella accanto al nuovo progetto.
  2. Fai clic su API e servizi e poi Libreria. Potrebbe essere necessario fare prima clic su Menu .
  3. Per ciascuna delle API richieste (qui sotto), fai clic sul nome e scegli Attiva:
    • SDK Admin
    • API Google Calendar
    • Contacts API
    • API Gmail
    • API Groups Migration

    Suggerimento: se non riesci a trovare l'API, specifica il nome nella casella di ricerca.

Passaggio 3: configura la schermata per il consenso OAuth

Suggerimento: quando aggiungi gli indirizzi email di seguito, utilizza account email amministrativi condivisi.

  1. In Google Cloud, apri il progetto che hai creato in precedenza.
    • Se hai creato manualmente un account di servizio, il progetto è stato creato in Passaggio 1: crea un progetto.
    • Se hai creato il progetto utilizzando uno script, il nome del progetto è elencato nell'editor di Google Cloud Shell dopo l'esecuzione dello script.
  2. Fai clic su API e servizi e poi Schermata per il consenso OAuth. Potrebbe essere necessario fare prima clic su Menu .
  3. Fai clic su Branding.

    Se non vedi Inizia, vai al passaggio 4. In caso contrario, vai al passaggio 5.

  4. Fai clic su Clienti.

    Se vedi + Crea cliente, vai al passaggio 4: crea l'account di servizio. In caso contrario, vai al passaggio 5.

  5. Fai clic su Inizia.
  6. Nel campo Nome app, inserisci il nome dell'applicazione, ad esempio Google Workspace Migrate o GWM.
  7. Nel campo Email per assistenza utenti, inserisci un indirizzo email a cui gli utenti possono rivolgersi per eventuali domande e fai clic su Avanti.
  8. Per Pubblico, seleziona Interno e fai clic su Avanti.
  9. In Informazioni di contatto, inserisci gli indirizzi email pertinenti e fai clic su Avanti.
  10. In Fine, seleziona la casella Accetto le Norme relative ai dati utente: servizi API di Google.
  11. Fai clic su Continua e poi Crea.

Passaggio 4: crea l'account di servizio

  1. Fai clic su API e servizi e poi Credenziali. Potrebbe essere necessario fare prima clic su Menu .
  2. Fai clic su Crea credenziali e poi Account di servizio.
  3. In Nome account di servizio, inserisci un nome per l'account di servizio e, se vuoi, aggiungi una descrizione.
  4. Fai clic su Crea e continua e poi Fine.
  5. Prendi nota del valore dell'ID univoco dell'account di servizio. Ne avrai bisogno successivamente. Questo valore è anche l'ID client dell'account di servizio.

    Suggerimento: puoi trovare il valore anche nella scheda Dettagli del service account o nel file JSON.

  6. Fai clic su Fine e poi Salva.
  7. In alto, fai clic su Chiavi e poi Aggiungi chiave e poi Crea nuova chiave.
  8. Assicurati che il tipo di chiave sia impostato su JSON e fai clic su Crea.

    Un messaggio indicherà che il file JSON della chiave privata dell'account di servizio è stato scaricato sul computer.

  9. Prendi nota del nome del file e della posizione in cui viene salvato dal browser. Ne avrai bisogno successivamente.
  10. Fai clic su Chiudi.

Passaggio 2: autorizza il tuo ID client nella Console di amministrazione

Se hai utilizzato uno script automatico per creare il tuo account di servizio, puoi ignorare questo passaggio.

La modalità di autorizzazione dipende dal tipo di account da cui esegui la migrazione.

Opzione 1: non eseguire la migrazione da un account Google Workspace

Esegui questi passaggi sull'account di destinazione.

  1. Nella Console di amministrazione Google, vai a Menu e poi Sicurezza e poi Accesso e controllo dei dati e poi Controlli API e poi Gestisci delega a livello di dominio.

    Per questa attività, devi aver eseguito l'accesso come super amministratore.

  2. Fai clic su Aggiungi nuovo e inserisci l'ID client del tuo account di servizio.

    Puoi trovare questo ID (chiamato anche ID univoco) nel file JSON che hai scaricato durante la creazione del service account o in Google Cloud (fai clic su IAM e amministratore e poi Service accounts e poi il nome del tuo service account).

  3. In Ambiti OAuth, copia e incolla il seguente elenco di ambiti delimitato da virgole:

    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. Fai clic su Autorizza.
  5. Punta al nuovo ID client, fai clic su Visualizza dettagli e assicurati che nell'elenco siano riportati tutti gli ambiti.

    Se manca un ambito, fai clic su Modifica, inserisci l'ambito mancante e fai clic su Autorizza. Non puoi modificare l'ID client.

Le modifiche possono richiedere fino a 24 ore, ma in genere sono più rapide. Scopri di più

Opzione 2: esegui la migrazione da un account Google Workspace

I passaggi da seguire variano a seconda della configurazione. Se hai:

  • Domini di origine e di destinazione di Google Workspace diversi: autorizza GWMME sia sul dominio di origine sia su quello di destinazione seguendo i passaggi 1 e 2 descritti di seguito in questa pagina.
  • Domini di origine e di destinazione di Google Workspace uguali : autorizza GWMME solo sul dominio di destinazione seguendo il passaggio 2 descritto di seguito in questa pagina.
  • Password aggiunte nel file CSV di controllo : autorizza GWMME solo sul tuo dominio di destinazione seguendo il passaggio 2 descritto di seguito in questa pagina. Quindi, concedi l'accesso al tuo account di origine per le app meno sicure. Per maggiori dettagli, vedi Passaggio 2: consenti alle app meno sicure di accedere agli account.

Passaggio 1: autorizza GWMME sul tuo dominio di origine

  1. Nella Console di amministrazione Google, vai a Menu e poi Sicurezza e poi Accesso e controllo dei dati e poi Controlli API e poi Gestisci delega a livello di dominio.

    Per questa attività, devi aver eseguito l'accesso come super amministratore.

  2. Fai clic su Aggiungi nuovo e inserisci l'ID client del tuo account di servizio.

    Puoi trovare questo ID (chiamato anche ID univoco) nel file JSON che hai scaricato durante la creazione del service account o in Google Cloud (fai clic su IAM e amministratore e poi Service accounts e poi il nome del tuo service account).

  3. In Ambiti OAuth, copia e incolla il seguente ambito:

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

  4. Fai clic su Autorizza.
  5. Successivamente, completa il passaggio 2 descritto di seguito.

Passaggio 2: autorizza GWMME sul dominio di destinazione

  1. Nella Console di amministrazione Google, vai a Menu e poi Sicurezza e poi Accesso e controllo dei dati e poi Controlli API e poi Gestisci delega a livello di dominio.

    Per questa attività, devi aver eseguito l'accesso come super amministratore.

  2. Fai clic su Aggiungi nuovo e inserisci l'ID client del tuo account di servizio.

    Puoi trovare questo ID (chiamato anche ID univoco) nel file JSON che hai scaricato durante la creazione del service account o in Google Cloud (fai clic su IAM e amministratore e poi Service accounts e poi il nome del tuo service account).

  3. In Ambiti OAuth, copia e incolla il seguente elenco di ambiti delimitato da virgole:

    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 i domini di origine e di destinazione di Google Workspace corrispondono, aggiungi il seguente ambito:

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

  5. Fai clic su Autorizza.
  6. Punta al nuovo ID client, fai clic su Visualizza dettagli e assicurati che nell'elenco siano riportati tutti gli ambiti.

    Se manca un ambito, fai clic su Modifica, inserisci l'ambito mancante e fai clic su Autorizza. Non puoi modificare l'ID client.

Le modifiche possono richiedere fino a 24 ore, ma in genere sono più rapide. Scopri di più

Passaggio 3: configura la migrazione

Per informazioni dettagliate, vedi Eseguire la migrazione dei dati con GWMME.


Google, Google Workspace e i marchi e i loghi correlati sono marchi di Google LLC. Tutti gli altri nomi di società e prodotti sono marchi delle società a cui sono associati.