Autorizzare GWMME per il proprio account

Questo script GitHub non è supportato dall'assistenza Google Workspace. Se hai problemi a utilizzare lo 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 maggiori dettagli, vedi Eseguire la migrazione dei dati con GWMME.

Scopri di più sull'utilizzo dello script.

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 amministrazione 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 l'autore del progetto dispone dei diritti necessari 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 proprietario del progetto. 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 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
   • API Contatti
   • 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 service account, il progetto è stato creato nel 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 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 il service account. 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. Per Email per assistenza utenti, inserisci un indirizzo email che gli utenti possono contattare per porre domande, quindi fai clic su Avanti.
8. Per Pubblico, seleziona Interno e fai clic su Avanti.
9. Per Informazioni di contatto, inserisci gli indirizzi email pertinenti e fai clic su Avanti.
10. Per Fine, seleziona la casella Accetto le Norme relative ai dati utente dei servizi API di Google.
11. Fai clic su Continua Crea.

Passaggio 4: crea l'account di servizio

1. Fai clic su API e servizi Credenziali. Potrebbe essere necessario fare prima clic su Menu .
2. Fai clic su Crea credenziali Service account.
3. In Nome account di servizio, inserisci un nome per l'account di servizio e, facoltativamente, aggiungi una descrizione.
4. Fai clic su Crea e continua Fine.
5. Prendi nota del valore ID univoco per il service account. Ti servirà in un secondo momento. Questo valore è anche l'ID client dell'account di servizio.

   Suggerimento: puoi trovare il valore anche nella scheda Dettagli dell'account di servizio o nel file JSON.

6. Fai clic su Fine. Salva.
7. In alto, fai clic su Chiavi Aggiungi chiave 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. Ti servirà in un secondo momento.
10. Fai clic su Chiudi.

Esegui questi passaggi sull'account di destinazione.

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

   Vai a 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 dell'account di servizio o in Google Cloud (fai clic su IAM e amministrazione Account di servizio il nome del tuo account di servizio).

3. Per Ambiti OAuth, copia e incolla il seguente elenco di ambiti separati 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. Seleziona il 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.

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 Sicurezza Accesso e controllo dei dati Controlli API Gestisci delega a livello di dominio.

   Vai a 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 dell'account di servizio o in Google Cloud (fai clic su IAM e amministrazione Account di servizio il nome del tuo account di servizio).

3. Per 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 Sicurezza Accesso e controllo dei dati Controlli API Gestisci delega a livello di dominio.

   Vai a 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 dell'account di servizio o in Google Cloud (fai clic su IAM e amministrazione Account di servizio il nome del tuo account di servizio).

3. Per Ambiti OAuth, copia e incolla il seguente elenco di ambiti separati 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. Seleziona il 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.