...
...
...
...
...
...
...
...
...
On This Page
| Table of Contents |
|---|
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.
| Info |
|---|
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
...
Expand the Manage section in the left navigation menu.
Click Connections.
Click 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.
...
Click 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
...
click Next.
...
Click Allow when prompted to allow DryvIQ to access your account.
You will see a green "
...
Connected” message on
...
the bottom of the modal when DryvIQ establishes connection. (If
...
the connection fails, verify the information you entered.)
...
Click Done to finish creating the connection.
Add Connection Modal
...
for 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. | |
...
See Google’s API-specific authorization and authentication information documentation to learn more. | |
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. |
...
See Google’s API-specific authorization and authentication information documentation to learn more |
...
. | 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. |
...
See Google’s API-specific authorization and authentication information documentation to learn more |
...
. | Optional |
...
Login
...
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.
...
Use 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 |
...
See |
...
below for more information. | |
...
...
See |
...
below for more information. | Segment path length: 500 |
...
See |
...
below for more information. | ||
...
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, G Suite does not support exporting Google Docs in their native format. Consequently, you cannot transfer Google Docs from G Suite 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 G Suite and retain its original format.
Non-transferable Items
Sites, Forms, Fusion Tables, My Maps and G Suite Marketplace are Google proprietary formats and are not available for downloadin G Suite/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.
...
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.
| Code Block |
|---|
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.
| Code Block |
|---|
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.
...