Overview

DryvIQ connections to Google Drive require OAuth 2.0 access. A client application configuration is required. DryvIQ provides a pre-configured, default client application, or the user can create a custom client application if preferred. To learn more click here.

This connection is for personal Google Drive accounts. Is you are looking to migrate content for your Google business drives, you will need to use the Google Workspace or Google Shared Drives connectors.

Two-factor authentication to Google Drive accounts is supported. When testing the connection, you will be guided through the same two-factor authentication flow used when signing into Google Drive.

Creating connection | User Interface

Select Connections > Add connection.
Select Google Drive as the platform on the Add connection modal.
Enter the connection information. Reference the table below for details about each field.
Select Sign in with Google Drive.
On the Sign in with Google modal, enter the Email Address for the account you are using for the connection and click Next.
Enter the Password required to log in to the Google Drive account and select Next.
Select Allow when prompted to allow DryvIQ to access your account.
You will see a "Connection test succeeded" message on the Add connection modal. (If you don't see this message, repeat the sign in and authorization steps above.)
Select Done to finish creating the connection.

Add Connection Modal - Google Drive

Field	Description	Required

Field	Description	Required
Display as	Enter the display name for the connection. If you will be creating multiple connections, ensure the name readily identifies the connection. The name displays in the application, and you can use it to search for the connection and filter lists. The maximum length is 255* characters.* f you do not add a display name, the connection will automatically be named using the account owner's name. For example, Google Drive (John Doe). If it will be useful for you to reference the connection by account, you should use the default name.	Optional
Platform API Credentials		Required
Use the system default client credentials	Select this option to create a standard connection to access a user's files and folders. This is the default selection.
Use custom client credentials	Select this option to create an administrator connection. If you choose to use your own application credentials, two additional options will be displayed. Please visit the Google Developer's documentation for more information.
Client ID	This field displays only when you select Use custom client credentials. This value will be provided by your Google Drive administrator. It's the Identifier of the third-party application as defined by OAuth 2.0. To learn more, click here.	Optional
Client Secret	This field displays only when you select Use custom client credentials. This value will be provided by your Google Drive administrator. This is the client secret (password) of the third-party application as defined by OAuth 2.0. This is used with an application key to authenticate a third-party application. To learn more, click here.	Optional

Google Sign in

Grant Access to Google Drive

Connection Test Succeeded

Features and Limitations

Platforms all have unique features and limitations. DryvIQ’s transfer engine manages these differences between platforms and allows you to configure actions based on Job Policies and Behaviors. Utilize the Platform Comparison tool to see how your integration platforms may interact regarding features and limitations.

Supported Features	Unsupported Features	Other Features/Limitations

Supported Features	Unsupported Features	Other Features/Limitations
Version preservation	Author/Owner preservation	Invalid characters: /
Timestamp preservation	File lock propagation	File size maximum: 5 TB
Metadata map	Mirror lock ownership	Path length maximum: n/a (See Path Lengths below)
	Restricted types (See Restricted Types below)	Segment path length: 500 (See Path Lengths below)
	Account map
	Group map
	Permission preservation
	User impersonation
	Tags map

Path Lengths

Google Drive does not impose restrictions for the total path length.

Segment path lengths are limited to 500 character. Segments are delimited by a forward slash (/). For example, <max 500 characters>/<max 500 characters>.

Restricted Types

Native Google Docs

Although Box supports Google Docs, Google Workspace does not support exporting Google Docs in their native format. Consequently, you cannot transfer Google Docs from Google Workspace to Box without the files being converted to the Microsoft equivalent during the transfer process. However, a Google Doc created in Box can be transferred to Google Workspace and retain its original format. DryvIQ exports Google native documents in the following formats:

Google Docs convert to docx files.
Google Slides convert to pptx files.
Google Sheets convert to xlsx files.
Google Drawings converts to svg files.
Google Apps Script converts to json files.

Non-transferable Items

Sites, Forms, Fusion Tables, My Maps and Google Workspace Marketplace are Google proprietary formats and are not available for download in Google Workspace/Google Drive. This means DryvIQ is prevented from transferring these items. Expected behavior is the item will be flagged with the error message "IO Violation and message: Downloading content is not supported for file: /"

Comments in Docs, Sheets, and Slides are also not transferable.

Shortcut Links

Google does not allow downloading of native link files that appear on the Google platforms. DryvIQ will filter these files out of the migration job and log the skipped reason for reference.

Versioning and Simulation

For Google native documents, only the size of the current version can be calculated from the API. When running a simulation job with versioning enabled, only the size of the current version of the file will be shown. The size of the other versions will not be calculated for these documents.

Create connection | REST API

The code below shows how to create a new connection using a REST API call. The GET request returns JSON with the OAuth2 target URL needed to finish the connection creation. Follow the given URL to finish creating the connection.

GET {{url}}v1/connections/platforms/google-drive/new

Create Connection with Delete Policy | REST API

Soft delete is the default delete policy. This means deleted items are moved to the trash on the platform. The code below shows how to set the delete policy to "permanent" while creating a new connection that uses the using a REST API call.

Send the The GET request below.

GET {{url}}v1/connections/platforms/google-drive/new
The GET request returns JSON with the OAuth2 target URL needed to finish the connection creation.
Copy and past the URL generated in your browser and add the following at the end of it: %26delete_behavior%3Dpermanent.
Follow the given URL to finish creating the connection.

Create connection | CLI

The CLI command below returns the OAuth2 target URL needed to finish the connection creation. In most environments the URL will be automatically opened in your default browser to complete the creation process. If not follow the given URL to finish creating the connection.
CLI: Connections

skysync-cli connections add --platform google-drive

DryvIQ Migrate

Google Drive