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
- Go to https://console.developers.google.com/.
- Create a new project.
- Click Enable APIs and Services and enable the Google Drive API.
-
Obtain Credentials.
- Click Credentials.
- Click Create Credentials > OAuth Client ID.
- In the Application Type list, click Desktop App.
- Type a name for the app.
- 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
- Go to https://console.developers.google.com/ and log in.
- Create a new project, and make sure the project is selected.
- Go to API Manager > Library.
- Select Admin SDK and click Enable.
- Select Drive API and click Enable.
- Select API Manager > Credentials.
- Select Create Credentials > Service Account Key.
- Select New Service Account.
-
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).
-
Select Key type JSON, and then click Create.
Save the JSON file provided by Google for use later.
- Find the service account you created by clicking (Menu button) > IAM & Admin > Service accounts.
- In the table, click Edit for the service account you created.
- Select the Enable G Suite Domain-wide Delegation check box, and click Save.
- Click View Client ID, and copy the Client ID to be used later. (The Client ID is also shown in API Manager > Credentials).
-
Go to https://admin.google.com/ and log in using an administrator account.
-
In the Admin Console menu, click Security.
-
Select Show more > Advanced settings > Manage API Client Access.
-
Ensure that an entry is present for the Client ID you obtained above. Ensure that the following scopes are included:
- 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)
-
Click Authorize.