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.

Real-time Updates via Gmail Push Notifications​

Intail utilizes Gmail's push notification system to provide real-time updates about changes in your mailbox. This efficient system eliminates the need for constant polling and reduces network overhead. Here's how it works:

  1. Cloud Pub/Sub Integration: When you connect your account, Intail sets up a secure channel using Google Cloud Pub/Sub to receive notifications about changes in your Gmail mailbox.

  2. Notification Types: You'll receive instant notifications for:

    • New emails arriving in your inbox
    • Changes to email labels
    • Updates to email metadata

  3. Performance Benefits:

    • Reduced API usage and network traffic
    • Immediate updates without polling delays
    • Better battery life for mobile devices
note

Push notifications are automatically renewed by Intail to ensure continuous service. No action is required from users to maintain this functionality.

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.