Skip to main content

Google Workspace Individual

Overview​

This integration allows users within an organization to connect their individual Google Workspace accounts with the Intail app using a straightforward, single-click OAuth 2.0 authentication process. Initially, administrative privileges are required to enable the organization to connect with Intail. Once this is set up, all other users in the organization can connect without any issues.

Prerequisites​

  • A Google Workspace account.
  • Initial administrative approval from the organization to connect with Intail.
caution

Administrative privileges are required only for the initial setup to allow the organization to connect with Intail. After this is done, individual users can connect without needing further administrative permissions.

Step-by-Step Guide​

1. Initial Setup by Administrator​

  1. An administrator must first enable the integration by approving the Intail app for the organization.
  2. Navigate to the organization's Admin console.
  3. Go to: Main Menu -> Security -> Access and data control -> API controls.
  4. Under Manage Third-Party App Access, search for the Intail app and approve the connection.

2. Connect Your Google Workspace Account (For Individual Users)​

  • After the administrator has approved the app, individual users can connect by following these steps:
  • In the Intail app, navigate Settings page and go to the Integrations in Settings section.
  • Locate the Google Workspace Individual integration option.
  • Click the Connect button.

3. Authorize Access​

  • You will be redirected to the Google login page.
  • Log in with your Google Workspace account credentials.
  • Review the requested permissions and click Allow to authorize the Intail app to access your Google Workspace data.

4. Confirm Integration​

  • After granting permissions, you will be redirected back to the Intail app.
  • A confirmation message will indicate that your Google Workspace account has been successfully connected.

Supported OAuth Scopes​

The following OAuth scopes may be requested during the connection process to provide the necessary access:

  • https://www.googleapis.com/auth/gmail.metadata: Allows reading metadata for emails, which includes headers and labels but not the message body or attachments.
  • https://www.googleapis.com/auth/admin.directory.user.readonly: Provides read-only access to user directory information.
  • https://www.googleapis.com/auth/calendar.readonly: Grants read-only access to the user's calendar events.

These scopes ensure that the Intail app can only read data without the capability to modify it, maintaining data integrity and security.

By following these steps, users within the organization can seamlessly connect their Google Workspace accounts with the Intail app, facilitating efficient data access and integration.