Z2Gsync
Google Workspace Setup & Permissions
A comprehensive step-by-step guide to configuring and authorizing your synchronization environment for Zimbra to Google migration.
1. Google Workspace Initialization
https://console.cloud.google.com/projectcreate
Project Name: Zimbra-Gmail-Migration
2. Project Selection
* Navigate to the project selector
** Select the newly created migration project
3. APIs & Services Dashboard
https://console.cloud.google.com/apis/dashboard
* Click “Enable APIs & Services”
Activate the following components:
– Google Calendar API
– Google Tasks API
– People API
– Gmail API
– Admin SDK API
4. IAM & Service Account
https://console.cloud.google.com/iam-admin/serviceaccounts
* Access “Service Accounts”
** Create Service Account
– Name: zimbra-sync
* Click “Create and Continue”
– Role: Owner
* Click “Done”
Account ID: 113645871371519722347
5. Security JSON Management
* Identify the service account
** Click Three Dots -> Manage Keys
* Click “Add Key”
** Create new key -> Select JSON
Important: Save “service-account.json” immediately. It is only available for download once.
6. Domain-Wide Delegation
https://admin.google.com/ac/owl/domainwidedelegation
* Security Settings
** Access and data control
*** API controls
**** MANAGE DOMAIN WIDE DELEGATION
Add new client with the following details:
113645871371519722347
Scopes to add:
https://mail.google.com/, https://www.googleapis.com/auth/admin.directory.group, https://www.googleapis.com/auth/admin.directory.group.member, https://www.googleapis.com/auth/admin.directory.resource.calendar, https://www.googleapis.com/auth/admin.directory.user, https://www.googleapis.com/auth/admin.directory.user.readonly, https://www.googleapis.com/auth/apps.groups.migration, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/contacts, https://www.googleapis.com/auth/contacts.other.readonly, https://www.googleapis.com/auth/contacts.readonly, https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/drive.appdata, https://www.googleapis.com/auth/email.migration, https://www.googleapis.com/auth/forms, https://www.googleapis.com/auth/gmail.compose, https://www.googleapis.com/auth/gmail.insert, https://www.googleapis.com/auth/gmail.labels, https://www.googleapis.com/auth/gmail.modify, https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.settings.basic, https://www.googleapis.com/auth/gmail.settings.sharing, https://www.googleapis.com/auth/tasks, https://www.googleapis.com/auth/user.addresses.read, https://www.googleapis.com/auth/user.emails.read, https://www.googleapis.com/auth/user.gender.read, https://www.googleapis.com/auth/user.organization.read, https://www.googleapis.com/auth/user.phonenumbers.read, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile, http://sites.google.com/feeds
7. Mailbox Delegation Settings
https://admin.google.com/ac/apps/gmail/usersettings
* Apps → Google Workspace → Gmail → User Settings
** Scroll to Mail Delegation
*** Enable: “Let users delegate access to their mailbox to other users in the domain”
