Google Drive
On This Page
- 1 Overview
- 2 Creating connection | User Interface
- 3 Features and Limitations
- 3.1 Path Lengths
- 3.2 Restricted Types
- 3.2.1 Native Google Docs
- 3.2.2 Non-transferable Items
- 3.2.3 Shortcut Links
- 3.2.4 Versioning and Simulation
- 4 Create connection | REST API
- 5 Create Connection with Delete Policy | REST API
- 6 Create connection | CLI
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. If 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 |
---|---|---|
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 |
---|---|---|
File size maximum: 5 TB | ||
Path length maximum: n/a | ||
| Restricted types | Segment path length: 500 |
|
| |
|
| |
|
| |
|
| |
|
|
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.
skysync-cli connections add --platform google-drive