Google Drive

Brightspot's Google Drive integration lets you search and import files from a linked Google Drive account into federated search, and can keep an imported file in sync with later changes in Drive.

Configuring the integration

To configure the Google Drive integration:

1. From the left navigation, under Admin, click Sites & Settings, then select the Global site.
2. From the Integrations tab, expand the Google cluster.
3. In the Drive Client ID field, type the OAuth client ID from the Google Developer Console.
4. In the Drive Client Secret field, type the OAuth client secret from the Google Developer Console.
5. Click Save.

note

Brightspot displays the redirect URI to add in the Google Developer Console (in the form https://your-host/googleDriveAuth) next to the Drive Client ID field.

Linking your account

Google Drive imports files on behalf of the signed-in editor rather than a shared service account. If you have not linked your Google Drive account, the search results panel shows a "Click here to authenticate Google Drive" prompt instead of a search field.

To link your Google Drive account:

1. Open the search panel for Google Drive.
2. Click the authentication link ("Click here to authenticate Google Drive" the first time, or Link another account to add an additional account).
3. Sign in to Google and approve the requested permissions.

After you approve access, Brightspot returns you to the search panel and Google Drive is ready to search.

note

For an asset imported from Google Drive, a Sync widget on the asset's edit page indicates whether the source file has changed since it was imported. Click Reimport From Source to pull in the latest version—if the asset is published, this creates a draft of the differences instead of overwriting it directly.

Importing a Google Drive file

This module doesn't ship a content type for imported Google Drive files. Which content type a file converts to—if any—depends entirely on what your project has implemented.

To import a Google Drive file:

1. Open the search panel for Google Drive.
2. Click the file you want to import.
3. If your project provides more than one way to convert the file, select the one you want from the Converter list.
4. Click Import.
5. Complete your site's workflow and publish the asset.

note

If no converter appears, or the one you need is missing, ask your development team to extend UpdatableExternalItemConverter. For details, see Extending the plugin.