Overview

This document explains how to set up your Google Drive™ account with backups.

Set up the Google Drive API for your Google account

To create a Google Drive account, visit the Google® Create your Google Account page.

To configure the Google Drive API for your Google account, perform the following steps:
  1. Navigate to the Google API Manager website. 
  2. In the left navigation menu, click Library.
  3. Under the G Suite heading, click GoogleDrive API.
  4. Click Create Project, and then click Create. A new menu will appear.

    If the new menu does not appear, perform the following steps and then proceed to Step 5: 

    1. Click Credentials in the left navigation bar.
    2. Click Create.


  5. Enter your new project name and click Create.

  6. Click Enable.

Increase your Google Drive API quota

According to Google's documentation, Google imposes limits and quotas on their APIs. This causes errors when you back up your server to Google Drive.

To avoid errors due to these limitations, we recommend that you perform the following steps to increase your default quota settings:

  1. In the side navigation bar, click Google Drive API.
  2. Click Quotas.
  3. Increase the value of the Queries per 100 seconds per user setting.

    The maximum value of 1000 usually resolves these errors. However, a lower setting may sufficiently resolve most errors.


  4. Click Done.

Create your account credentials

To set up your account credentials for backups, perform the following steps:

  1. In the side navigation bar, click Credentials.

  2. Click Create credentials.

    If you already possess Google Drive account credentials, click Create credentials and then click Help me choose.


  3. From the Which API are you using? menu, select Google Drive API.
  4. From the Where will you be calling the API from? menu, select Web Server.
  5. From the What data will you be accessing? menu, select User Data.
  6. Click What credentials do I need?.
  7. In the Create an OAuth 2.0 client ID. text box, enter your desired name.
  8. In the Authorized redirect URIs text box, enter the https://hostname:2087/googledriveauth/callback link, where hostname represents your server's hostname.

    To locate your server's hostname, perform either of the following actions:

    • Run the hostname command as the root user.
    • Navigate to WHM's Change Hostname interface (WHM >> Home >> Networking Setup >> Change Hostname). The server's hostname appear's under the Current Hostname heading.


  9. Click Create. The interface will display your new client ID and client secret. 

    • We strongly recommend that you save these credentials in a secure location. Step 7 of the Create a Google Drive transport procedure requires these credentials. 

    • You can also download a JSON file with your client ID and client secret, or access them in the Credentials section. 

  10. Click Done.

Create a Google Drive transport

If you experience problems when you perform these steps, check your browser's popup blocker. Popup blockers may prevent your ability to perform this task successfully. 

To create a Google Drive transport, perform the following steps:

  1. Log in to WHM as a root-enabled user.

  2. Navigate to WHM's Backup Configuration interface (WHM >> Home >> Backup >> Backup Configuration) and scroll to the Additional Destinations section.
  3. From the Destination Type menu, select Google Drive™.
  4. Click Create new destination.
  5. Enter your desired destination name.
  6. Enter the desired folder in which to store backups.

    If you do not specify a folder, the system will store backups in the top-level folder.


  7. Enter your client ID and client secret. 
  8. Click Generate Credentials to generate the credentials file. A new tab will appear that allows you to authorize access to your Google Drive data.
  9. Click Authorize Access.
  10. In the Timeout text box, enter the desired timeout duration.
  11. Click Save Destination.

    • To validate your remote destination, click Save and Validate Destination.
    • If you do not authorize access to your Google Drive data, this action will fail.


Additional documentation