Enterprise: How to add a Google Workspace source
The following tutorial details how to add Google Workspace source to SyncGene.
Step 1. Visit Google API Console. Make sure you are logged in with your Google Workspace account.
Step 2. Once logged in, click the CREATE PROJECT button located top left of the page.
Step 3. In the project creation window, add a name to your project. It will be used for synchronization with SyncGene only. Once done, click the CREATE button.
Step 4. A notification window will appear on the right side of the page. Click the SELECT PROJECT button.
Step 5. Click the Navigation Menu button top left corner to access the drop-down menu and inside - select the Marketplace option.
Step 6. Do a search for Google People API.
Step 7. Once found, click on it and click the Enable button.
Step 8. Repeat the steps 5-7 to enable the following APIs:
- Admin SDK API
- Google Calendar API
- Tasks API
- Google Drive API
- Contacts API*
Note: Contacts API is optional at this point because it's no longer developed and being migrated to Google People API.
Step 9. Open the Service Accounts page. Select your project.
Step 10. Click the +CREATE SERVICE ACCOUNT button.
Step 11. Add a service name, description, other options are not required. Once details are added, click the CREATE AND CONTINUE button.
Step 12. In the service accounts list, click the 3 vertical dots option located in the Actions column at the end and select Manage Keys from the drop-down menu.
Step 13. In the Manage Keys window click the ADD KEY button and select the Create new key option.
Step 14. In the window that appears, select a format for your key: JSON and click the CREATE button. A .json file will be downloaded to your computer, keep it safe for later use.
Obtaining unique Client-ID
Step 1. Open the Service accounts page and select your project.
Step 2. In the service accounts list, click the 3 vertical dots option located in the Actions column at the end and select Manage Details from the drop-down menu.
Step 3. In the Manage Details window, copy the Unique ID for later use.
Delegating domain-wide authority to your service account
Step 1. Open Google Workspace Admin Console.
Step 2. Click on the Security option in the main menu on the left side and select API controls inside.
Step 3. In the API controls window click the MANAGE DOMAIN WIDE DELEGATION button at the bottom.
Step 4. In the Domain delegation page click Add new option.
Step 5. In the Client ID field input the ID you saved earlier from the service account creation steps.
Step 6. In the OAuth scopes field enter the following scopes required for SyncGene synchronization:
https://www.googleapis.com/auth/drive.appdata, https://www.googleapis.com/auth/tasks, https://www.googleapis.com/auth/contacts, https://www.googleapis.com/auth/calendar.settings.readonly, https://www.googleapis.com/auth/calendar.events, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/admin.directory.orgunit.readonly, https://www.googleapis.com/auth/admin.directory.user.readonly
Note: Every scope must be specified even if you do not need it for your use case.
Click the AUTHORIZE button.
Configuring Google Workspace account on SyncGene
Step 1. Open Add Google Workspace Source page.
Step 2. Click the Choose File button and upload the JSON file you downloaded previously during Google Workspace configuration.
Step 3. Input your admin account name and click ADD SOURCE button.
If everything was done correctly, you will receive a success notification popup.
- Be sure to follow the above steps to the letter.
- If you have any trouble with configuration, be sure to visit Live Help.