Enterprise: How to add a Google Workspace source

4 min. readlast update: 11.05.2021

The following tutorial details how to add Google Workspace source to SyncGene.

undefined

 

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.

undefined

 

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.

undefined

 

Step 4. A notification window will appear on the right side of the page. Click the SELECT PROJECT button.

undefined

 

Step 5. Click the Navigation Menu button top left corner to access the drop-down menu and inside - select the Marketplace option.

undefined

 

Step 6. Do a search for Google People API.

undefined

 

Step 7. Once found, click on it and click the Enable button. 

undefined

 

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.

undefined

 

Step 9. Open the Service Accounts page. Select your project.

undefined

 

Step 10. Click the +CREATE SERVICE ACCOUNT button. 

undefined

 

Step 11. Add a service name, description, other options are not required. Once details are added, click the CREATE AND CONTINUE button.

undefined

 

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. 

undefined

 

Step 13. In the Manage Keys window click the ADD KEY button and select the Create new key option.

undefined

 

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.

undefined

 

undefined

 

Obtaining unique Client-ID

Step 1. Open the Service accounts page and select your project. 

undefined

 

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.

undefined

 

Step 3. In the Manage Details window, copy the Unique ID for later use. 

undefined

 

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.

undefined

 

Step 3. In the API controls window click the MANAGE DOMAIN WIDE DELEGATION button at the bottom.

undefined

 

Step 4. In the Domain delegation page click Add new option. 

undefined

 

Step 5. In the Client ID field input the ID you saved earlier from the service account creation steps.

undefined

 

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.

undefined

 

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.

undefined

 

Step 3. Input your admin account name and click ADD SOURCE button.

undefined

 

If everything was done correctly, you will receive a success notification popup.

undefined

 

undefined

 

Tips:

  • Be sure to follow the above steps to the letter.
  • If you have any trouble with configuration, be sure to visit Live Help.

Contact Support

Was this article helpful?