## Capabilities

DataGrail's Google Apps integration provides the following capabilities:

| Product | Capability |
| --- | --- |
| [Live Data Map](https://docs.datagrail.io/docs/ldm/ldm-overview) | System Detection |

## Before You Start

To successfully configure this integration, please ensure you have sufficient privileges:

- **DataGrail User Role:** Super Admin, Connections Manager
- **Google Apps Account:** Google Workspace
- **Google Apps User Role:** Admin

## Connect to DataGrail

1. Select **Login to Configure**.
2. Select the admin account you want to connect to DataGrail.
3. Select **Allow** to grant DataGrail the necessary permissions for the integration.

## Next Steps

Now that you've successfully connected the integration, check out the following resources:

- [Direct Contact Integrations](https://docs.datagrail.io/docs/integrations/direct-contact/overview)
- [Learn more about Live Data Map](https://docs.datagrail.io/docs/ldm/ldm-overview)
- [Live Data Map - System Inventory](https://docs.datagrail.io/docs/ldm/system-inventory)
- [Inventory System Reports Overview](https://docs.datagrail.io/docs/ldm/system-profiles)

## Troubleshooting

If you are unable to successfully connect the integration, review these common troubleshooting steps:

"This app isn't verified" Error

The DataGrail Google Integrations are in the process of being verified, so it is possible you receive a "This app isn't verified" error. To resolve this:

1. Open the [Google Admin Console](https://support.google.com/a/answer/182076).
2. From the Admin Console, select **Main Menu** → **Security** → **API controls**.
3. Under **App access control**, select **Manage Third-Party App Access**.
4. Select **Configure new app**, and choose **Client ID**.
5. Paste the DataGrail **Client ID**:
    
    ```text
    541919842333-kl8um0o8j308f4a1a84h4riqq72r0611.apps.googleusercontent.com
    ```

6. Check the boxes for the **Client ID** that you want to configure, and then press **Select**.
7. Choose the option **Trusted** to allow DataGrail the appropriate access.
8. Click **Configure**.
9. On the apps page, the **Access** column should show **Trusted**.

_Please see Google's documentation on adding trusted apps [here](https://support.google.com/a/answer/7281227?hl=en) for more info._

Ensure Required Permissions Are Granted on API Keys/Resources

DataGrail checks required permissions and scopes on API keys/resources used by each integration. If all necessary permissions are not granted, new connections will fail.

Review Required Account Types and User Roles

If users do not have the necessary permissions or the minimum required user role in the connecting system, the connection to DataGrail will fail. Additionally, connections will fail if your account type does not match the one required by the integration.

See [Before You Start](https://docs.datagrail.io/docs/integrations/connection-instructions/google_apps/#before-you-start) to review these requirements.

## API Documentation

Learn more about this API implementation and DataGrail functionality in our
[API Integration Documentation](https://docs.datagrail.io/docs/integrations/api-documentation/google_apps).

Need help?

If you have any questions, please reach out to your dedicated Account Manager or contact us at [support@datagrail.io](mailto:support@datagrail.io).
