Google Drive integration

Use the Google Drive integration to give users of your digital workplace a way of viewing, adding, and downloading files from Google Drive. When configuring the integration, you can control whether it connects to a standard drive or a shared drive. 

Sections in this article: 

Widget layout

 

The Google Drive integration on a page.

Location Description
Breadcrumbs

Use the breadcrumbs at the top of the file and folder list to navigate to a parent folder.
Search

You can search for files and folders in your Google Drive through the search bar.

Google Drive Integration Search Box
Add folders

Select Add folders to create a folder in the current location. You will be prompted to enter a name for the folder. If you want to change the name of a folder after you create it, you must do so from within Google Drive.
Delete folders

To the right of a folder, select Delete to delete a folder and all of its contents. You will be prompted to confirm this action.
Add files

Select Add File to upload files to the current location. You will be prompted to browse your device and select the file(s) that you want to upload. 
Actions menu

To the right of a file, select Actions to view additional options.
Actions menu: View in Google Drive

If enabled, select View in Google Drive to open the file in Google Drive. The document opens in a new browser tab. 
Actions menu: Download

Select Download will save the selected file to your computer or device.
Actions menu: Delete File

Select Delete File to delete the file. You will be prompted to confirm this action. 
Actions menu: Information

Select Information to view file size, creation date, last user who modified the file, and modification date. A link to the file in Google Drive is also provided in addition to the other Actions menu options (View in Google Drive, Download, Delete File).
Legend

Considerations and caveats

Signing in and access

You must sign in to the integration using the credentials you usually use to log into your Google drive or shared drive. If your browser recognizes that you already have a Google account with an active session, you will only need to select the account you want to sign in with instead of entering your credentials. After entering/selecting your credentials, you will be prompted to allow access to your Google account; this is required to allow the integration to see, edit, create, delete files in Google Drive. You must select Allow to continue using the integration.

You will not see the contents of a shared drive if you do not have access to it in Google Drive.

The authentication and approval process as described above.

To sign out of the integration, select Logout (located in the bottom right corner of the integration).

Shared files and folders

Files and folders shared with a user will display in the root location of a drive. If the integration is configured to show an initial folder other than root, these will not be accessible.

Moving files between your digital workplace and Google Drive

You can't transfer files directly between a folder channel in your digital workplace and Google Drive. You must download the files to your device and upload them to the other repository.

Finding Google Drive IDs

Finding the ID of a folder

If configuring the integration to show a shared drive, don't look for a folder ID. Shared drives do not support specifying an initial folder, and root should be used when entering an Initial Folder ID.

The integration will show the root location of google drive by default. If you want the integration to display only a specific folder and its contents, you must enter its ID when configuring the integration. To find the ID of a folder (standard or shared):

  1. In a web browser, log in to your Google Drive.
  2. Open the folder that you want to restrict the integration to.
  3. The ID is the portion of the URL after folders/, copy it.

    For example, given the URL below, the folder's ID would be: 1K3W----QKPa. https://drive.google.com/drive/folders/1K3W----QKPa

Finding the ID of a shared drive

If you want to show the contents of a shared drive in the integration you must enter its ID when configuring the integration. To find the ID of a shared drive:

  1. In a web browser, log in to your Google Drive.
  2. Open the shared drive that you want to restrict the integration to.
  3. The ID is the portion of the URL after folders/, copy it.

    For example, given the URL below, the shared drive ID would be: 0AK----------------PVA.
https://drive.google.com/drive/u/1/folders/0AK----------------PVA

Set up

  1. Place an  Integrations widget on a page, space, or dashboard. For more information, see Placing and setting up a widget. 
  2. Select the placed widget's Edit button.
  3. Under Integration Library, select Igloo Integration Library.
  4. Select Google Drive from the library.
  5. Review and make changes to the settings on the Options and Appearance tabs. You can find details about the widget's settings in the Settings section below.
  6. In the widget editor, select Update to apply your changes.
  7. At the bottom of your page, space, or dashboard, select Publish or Save as Draft to save your changes.

Settings

Options Tab

Setting Description
Title

Enter a title for the widget. The title appears as a heading above the widget's contents. You should use the title to provide context to the widget and better structure a page's content by clearly denoting different sections.

When entering a title, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a title for each supported language. 

This field can contain a maximum of 140 characters.
Title link

Enter the URL of a location in your digital workplace. Users who click the widget's title, if it has one, will go to this location. Whether you enter the link as a relative URL or an absolute URL does not matter, it will convert to an absolute URL the next time you edit the widget.

This field can contain a maximum of 2,083 characters.
Description

Enter a description for the widget. The description appears between the title and the widget's contents. You can use this text to provide information to users about the widget.

When entering a description, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a description for each supported language.
Initial Folder ID

Enter the default value of root to display the contents of the root location. If you would like to display the contents of a specific folder and all nested folders, enter the ID of that folder. Folders and files outside the specified folder cannot be accessed. For instructions on finding the ID of a folder, see the Finding the ID of a folder section above. This field must contain a value. Shared drives do not support specifying an initial folder and a value of root should be used.
General options
Setting Description

Enable View in Google Drive

Select Enable to show the View in Google Drive option in a file's actions menu; deselect Enable to not show this option. 

Enable Auto Height

Select Enable to make the height of the integration responsive to the amount of content; deselect Enable to give the integration a fixed height (scrollbars will be available to navigate locations with large amounts of files or folders).  If enabled, the Height option on the Appearance tab must be set to Auto (default state).

Show search

Select Enable to give users the ability to search the connected repository; deselect Enable to prevent users from searching the repository.

The search box section of the Google Drive integration.

Show Last Modified By

Select Enable to show the Last Modified By column; deselect Enable to hide this column.
The last modified by column in the Google Drive integration.

Show Last Modified

Select Enable to show the Last Modified column; deselect Enable to hide this column.
The last modified column in the Google Drive integration.

Show File Type

Select Enable to show the File Type column; deselect Enable to hide this column.
The file type column in the Google Drive integration.

Show File Size

Select Enable to show the Size column; deselect Enable to hide this column.
The size column in the Google Drive integration.

Team Drive ID

 

If the drive you want to show is a shared drive, enter its ID here. For instructions on finding the ID of a shared drive, see the Finding the ID of a shared drive section above. 

Is Team Drive Enabled

If you have entered a Team Drive ID and want to show it in the integration, select Enable. Deselect Enable to show a user's regular drive.
Advanced Settings

Appearance tab

Appearance options
Setting Description
Class

 Enter CSS class selectors to provide additional styling to the widget. For more information, see Applying custom CSS to widgets.
Height

 Select the height of the widget.

The default value is Auto (leftmost slider position) scales the widget's height to fit its contents. You can use the slider to set a fixed height between 50px to 600px in increments of 50px.

Selecting a height less than what is needed to display its contents results in the widget having a vertical scrollbar.

Note

Your digital workplace's theme overwrites many of the settings on the Appearance tab. However, the settings listed above are usable.