Before you Install the Connector

This section describes the steps you should take before installing the connector.

Retrieve Information from a single Google Drive

To retrieve information from Google Drive you must create an application to represent the connector. Google will provide an application key and application secret that you can use as part of the OAuth authentication process.

To create an application to represent the connector

  1. Go to https://console.developers.google.com/.
  2. Create a new project.
  3. Click Enable APIs and Services and enable the Google Drive API.
  4. Obtain Credentials.

    1. Click Credentials.
    2. Click Create Credentials > OAuth Client ID.
    3. In the Application Type list, click Desktop App.
    4. Type a name for the app.
    5. Make a note of the Client ID and Secret, and click OK. You will need this information when you run the OAuth configuration tool (see Configure OAuth Authentication).

Retrieve Information from G Suite Users

To retrieve information from the Google Drives of multiple users in a G Suite domain, you must create a service account that the connector can use to access the information. You must enable G Suite Domain-wide delegation and grant the relevant permissions.

To create a G Suite service account and grant relevant permissions

  1. Go to https://console.developers.google.com/ and log in.
  2. Create a new project, and make sure the project is selected.
  3. Click Enabled APIs & services and enable the following:

    • Admin SDK API.
    • Google Drive API.
  4. Click Credentials and create a new Service Account.
  5. Give the new service account a name. Then select the following roles:

    • Project > Viewer.
    • Project > Editor (if you want to use the insert or delete actions).
  6. Select Key type JSON, and then click Create.

    Save the JSON file provided by Google for use later.

  7. Find the service account you created by clicking (Menu button) > IAM & Admin > Service accounts.
  8. In the table, click Manage Details for the service account you created.
  9. Make a note of the Client ID for the service account, to be used later.
  10. Go to https://admin.google.com/ and log in using an administrator account.
  11. In the Admin Console menu, click Security > Access and data control > API controls.
  12. Select Manage Domain Wide Delegation.
  13. Select Add new to add an entry using the client ID you obtained above.
  14. Add the following OAuth scopes:

    • https://www.googleapis.com/auth/admin.directory.user.readonly
    • https://www.googleapis.com/auth/drive.readonly.
    • https://www.googleapis.com/auth/drive (if you want to use the insert or delete actions)
  15. Click Authorize.