Last modified: January 18, 2022

Overview

This document explains how to set up your Google Drive™ account as an Additional Destination in WHM’s Backup Configuration interface (WHM >> Home >> Backup >> Backup Configuration).

Prerequisites

• Create a Google account.
• Create a Google Console project.
• Enable the Google Drive API from the Google Console.

Create your account credentials

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

1. Navigate to the Google API Manager website.
2. In the left side navigation bar, click Credentials.
3. Click Create credentials.
4. Click Help me choose.
5. From the Which API are you using? menu, select Google Drive API.
6. Select User Data under What data will you be accessing? and click Next.
   Note:

   The steps beyond this point may vary if you have already signed up or have authorized this API.
7. In the App Information section, enter the information for App Name and User Support Email.
8. In the Developer contact information section, enter the email address for the developer. Click Save and continue.
   Note:

   The Set up OAuth consent screen may appear. Google allows users to complete the form after they set up the OAuth consent screen.

9. The fields in the Scopes section are optional.
10. In the OAuth Client ID menu, select Web application as the Application Type you plan to use.
    Note:

    There may be additional fields to fill out based on the application you have chosen.
11. In the Authorized JavaScript origins field, add an entry for each server performing backups to this location, where HOSTNAME represents the hostname of a server:

    https://HOSTNAME:2087/googledriveauth/callback

12. In the Authorized redirect URIs field, add an entry for each URI.
13. Click Create. The Credentials interface will appear.
14. Click Download to get a copy of the newly-created credentials.
15. Save them in a secure location. Step 7 of the Create a Google Drive transport procedure requires these credentials.

Create your OAuth consent screen

To set up an OAuth consent screen, perform the following steps:

1. Click APIs & Services.
2. Click OAuth consent screen. The Oauth consent screen configuration interface will appear.
3. Under Test Users, click Add Users. A sidebar will appear.
4. Enter the email addresses from steps 7 and 8 from the previous procedure.
5. Click Save.
   Note:

   After you validate the backup destination, you can go back to this interface and click Publish to publish the application.

Increase your quota limit

1. Scroll down on the Google Cloud Platform project Dashboard page.
2. Click Google Drive API.
3. Click Quotas.
4. Click the down arrow by Queries per day.
5. Click Edit by the Quota Name. A sidebar will appear.
6. Enter a number to change your quota limit.

Create a Google Drive transport

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 select the Additional Destinations tab.
3. From the Destination Type menu, select Google Drive™.
4. Click Create New Destination.
5. In the Destination Name text box, enter a display name for this backup destination.
6. In the Folder text box, enter the desired folder in which to store backups.
   Note:

   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 create the credentials file. A new tab will appear that allows you to authorize access to your Google Drive data.
9. Follow Google’s directions to authorize access to your Google Drive.
10. When the message Credentials successfully generated appears, close that browser tab to return to the tab with the WHM interface.
11. In the Timeout text box, enter the desired timeout duration. This value defaults to 30 seconds.
12. Click Save Destination.
    Note:

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