Google Gemini data source

This topic provides details on how to capture Google Gemini chat data with Collect.

RelativityOne collects Gemini Chat data and automatically converted to Relativity’s short message format (RSMF). For more information, see Relativity Short Message Format.

Considerations

Note the following considerations about this data source:

  • This connector requires a Google Workspace Enterprise Plus license with Vault enabled.
  • Gemini conversations are retained and made accessible based on your organization's Vault retention policies.
  • This connector collects Google Chat messages, including Gemini-enhanced threads, through the Google Vault API.
  • Relativity supports both persistent and ephemeral conversations, provided they fall within the configured retention window in Vault.
    • Ephemeral conversations are those where messages are not retained in the user's chat history but are accessible with the Vault API.
    • These are returned in Collect if Vault retention is enabled and search filters align with message dates.
  • If your organization uses multiple Google Workspace domains or organizational units, you must configure a separate data source for each in the Collect application. We recommend that you clearly name each data source to identify the workspace it is connecting to.

Advanced Gemini features

Several advanced Gemini features are not currently included in Vault exports. This means they will not be seen in our RSMF output.

These limitations are inherent to Google’s current export behavior and not Collect-specific.

Currently, in some cases, Google Vault exports may include placeholder links, or immersive chips, for these features.

  • When the immersive chips are available, Relativity inserts a Gemini Content Description based on the accompanying summary text provided by Google.
  • This content description offers limit context and does not include full visual or interactive content.

Google has indicated that there will be support for these features in the future.

The advanced features include:

  • Canvas
  • Deep Research responses
  • Uploaded images
  • Citations
  • Custom assistant names
  • Annotation metadata

Prerequisites

You must set up and configure a Google Cloud project before creating the data source in RelativityOne. For more information, see Google Workspace account setup.

Complete the following before setting up a Google Gemini data source in Relativity:

  • Set up a Google Cloud project and enable the following APIs:
    • Google Vault API
    • Admin SDK API
    • Generate OAuth 2.0 credentials:
    • Client ID and Client Secret
  • Grant the required access scopes during OAuth configuration:
    • https://www.googleapis.com/auth/admin.directory.user.readonly
    • https://www.googleapis.com/auth/ediscovery
  • Confirm that target user accounts and chat spaces are covered by an active Vault retention policy.

For detailed steps, see Google.

Once you complete the prerequisites, you can begin creating the data source.

Create the data source

Use the following procedure to connect the Google Gemini data source to Collect.

In RelativityOne:

  1. Navigate to Collection Admin.
  2. Click the New Collection Source Instance button.
    1. Name—enter a unique name for the data source.
    2. Type—select the Google Workspace data source.
    3. Settings—enter the required information in the Settings fields. For more information, see Settings fields.
  3. Click Save.

The data source displays on the Collection Admin page.

Settings fields

To connect Relativity to a Google Gemini workspace, you need to gather and enter the information for the following fields.

  • OAuth Client ID—enter the client ID created in your Google Cloud project.
  • OAuth Client Secret—enter the client secret linked to the above client ID.
  • Super Admin Email—enter the email address of a super admin account in your Google Workspace domain. This enables user impersonation for Vault access.

You must complete OAuth app setup in your Google Cloud console and approve domain-wide delegation before using these credentials.

Configure the data source in Collect

Add criteria to collect specific data. To configure the data sources, complete the following fields:

  • Select and unselected tabs—choose the data sources to collect from by moving unselected data sources to the selected list.
  • Field—choose the field to filter on within the data source.
  • Operator—choose an operator such as equals, contains, greater than, or less than.
  • Value—enter a value to find in the selected field.

After selecting field options, you must click Add Criteria.

Criteria Operators Description Example
Start Date Greater Than or Equals When you use the Start Date property in a query, the search returns messages that exist the day of and after the entered date. When you search a Start Date of 1/1/2024, Relativity collects all messages from that date to today.
End Date Less Than or Equals When you use the End Date property in a query, the search returns messages that exist the day of and before the entered date. When you search an End Date of 1/31/2024, Relativity collects messages from the beginning of time through that date.
Custodian Email Equals Filters for messages involving the specified user's email address. Messages sent or received by user@company.com are included.
Conversation ID Equals Filters for a specific conversation or message thread in Gemini Chat. Collects messages associated with conversation ID 17:abc123xyz456....
Workspace ID Equals Filters messages within a specific Google Chat space, room or group chat. Collects from the space with ID spaces/AAAAB3NzaC1yc2....
Keyword Contains Filters for messages containing one or more specified search terms or phrases. "project launch" OR "contract signed"

Temporary, or ephemeral, chats will also be returned if they occurred within the Vault retention window and meet your search criteria.