How to Set Up Google Workspace Integration

This article explains the steps to integrate Google Workspace on the Josys app integration page.

Note: Please note that any use or transfer of information obtained from Google APIs to other applications must adhere to the Google API Services User Data Policy, including applicable usage limits.

1. Steps to integrate Google Workspace

Step 1: Select Google Workspace from the App Catalog in the Apps section.

Step 2: Provide a suitable Label for identification. Click Sign in with Google and log in with an administrator account that has the privileged administrator role for Google Workspace to proceed with the integration.

• If you cannot integrate using a privileged administrator account, you can create a dedicated management role for integration.
• Please ensure that all checkboxes on the integration screen are checked.
  

2. Troubleshooting Integration Failures with a Super Administrator Account

If integration doesn't work with a super administrator account, it could be due to API restrictions in the Google Workspace settings. In such cases, register Josys as a “configured app” in the Google Workspace admin console and then try the integration again.

2.1 Steps to add Josys 

Step 1: Log in to your Google Workspace Admin console.

Step 2: Navigate to the Security Menu and select API controls from Access and data control.

Step 3: Click Manage Third-Party App access.

Step 4: Click Configure new app

Step 5: Enter the following App ID in the given field, click Search, and then select Josys from the search result.

409639374427-0kf5hbu0rqhherda4lk97qhc9a0lbfgq.apps.googleusercontent.com

Step 6: Select Scope and click Continue.

Step 7: Select Trusted and click Continue.

Step 8: Click Finish.

Josys will then be added as a configured app. After that, please refer to the instructions from Section 1 and try integrating with Josys again.

3. For Account Visibility Only (Synchronization of Accounts/Members Directory)

3.1 Creating an Administrative Role for Synchronizing Users Across Tenants

If you prefer not to use a super administrator’s account for integration with Josys, you can create a dedicated administrative role for integration. An administrator assigned to this role can be used for the integration.

Learn more from Create, edit, and delete custom administrator roles.

Note: With this method, Josys is limited with the operations such as account visibility, account suspension, and deletion without data migration. Account creation will not be available.

3.2 Steps to Creating an Administrative Role

Step 1: In your Google Workspace Admin Console, select Admin roles from the Account menu and click Create new role.

Step 2: Enter the role name and description and click Continue. 

Step 3: Select the privileges to assign to the user role and click Continue. When you assign administrator permissions in the Admin console, the corresponding management API resource permissions are also granted.

This is how a role a created. Now, assign a member to this role whose account you will be use for integration.

Step 4: Click Assign members.

Step 5: Select the member and click Assign Role.

3.3. Creating an Administrative Role for Synchronizing Users of a Specific Organizational Unit

If you wish to integrate only users from a specific organizational unit in Josys, create an administrative role for that organizational unit and assign an administrator to it who will be used for the integration.

Learn more from Create, edit, and delete custom administrator roles.

Note: With this method, the operations available from Josys are limited to account visibility, account suspension, and deletion without data migration. Account creation, role updates, license updates, and the audit log features of GWS will not be available (browser extensions remain accessible).

Steps to Creating an Administrator Role

Step 1: Follow the steps mentioned in the section 3.2.

Step 2: Assign administrator permissions in the Admin console and also grant the corresponding management API resource permissions.

Step 3: Select the member to assign the role to the account you will use for integration and click Assign Role.

FAQ

Q: Will the change to OAuth-only access permitted for apps using Gogoe Workspace accounts, effective March 14, 2025, impact our integration, given that password-based access will be discontinued? 

(Source: Google Workspace Updates)

A: No, there will be no impact as the Josys integration for Google Workspace already uses OAuth-based authentication.