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. 

Go to one of the following sections in this article:  

• Considerations and caveats
• Setting it up
• Using it

Considerations and caveats

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.

Setting it up

Finding the ID of a folder

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
   

Placing it

You set up integrations in a way similar to widgets (see, Placing and setting up a widget). However, instead of selecting an integration directly from the widget carousel, select the Integrations widget. When editing the Integrations widget, select the Igloo Integration Libray followed by Google Drive. For information about integration-specific configuration options, refer to the options below.

Options tab

General options

• Title: Enter a title for the integration. The title appears as a heading above the integration's contents. You should use the title to give users an idea of why the integration's content is important to them or highlight the content's purpose. Titles also serve to better structure the content of a page 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.  
• Title Link: Enter the URL of a location in your digital workplace. Users who click the integration's title, if it has one, will go to this location. Whether you enter the link as a relative URL or absolute URL does not matter, it will convert to an absolute URL the next time you edit the integration. 
• Description: Enter a description for the integration. The description appears between the title and the integration's contents. You can use this text to provide additional context to the integration or instructions for using the integration. When entering a description, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should selectTranslation and enter a description for each supported language. 

Integration options

• 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.

Advanced options

• 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.
  
• Show Last Modified By: Select Enable to show the Last Modified By column; deselect Enable to hide this column.
  
• Show Last Modified: Select Enable to show the Last Modified column; deselect Enable to hide this column.
  
• Show File Type: Select Enable to show the File Type column; deselect Enable to hide this column.
  
• Show File Size: Select Enable to show the Size column; deselect Enable to hide this column.
  
• 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.

Layout tab

There are no layout options available for this integration. 

Appearance tab

Use the Class field to add custom CSS to this integration. 

Your digital workplace's CSS theme overrides the other settings here, so these settings will not change the integration's appearance.

Using it

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.

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

Browsing

Select a folder to view its contents. Use the breadcrumbs at the top of the file and folder list to navigate to a parent folder.

If enabled, use the search box to find a specific file or folder. 

Folders

You can perform the following actions involving folders:

• Select New Folder 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.
• 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.

Files

You can perform the following actions involving 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. 
• Drag and drop files from your device into the integration. The files you dragged will be uploaded to the current location.
• If View in Google Drive is enabled, select to view the file in Google Drive. The document opens in a new browser tab.
• To the right of a file, select Actions to view additional options:
  • View in Google Drive: If enabled, select to open the file in Google Drive. The document opens in a new browser tab. 
  • Download: Select to download the file to your device.
  • Delete File: Select to delete the file. You will be prompted to confirm this action. 
  • Information: Select 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).