Skip to main content

Google Drive Authorization

In order to get started with the Google Drive Blueprints, a service account with the necessary GCP permissions is required. Additionally, this Service account will need to be invited to any files or folders you wish to access programatically.

Creating a Service Account for Google Drive​

  1. Login to your GCP console
  2. Using the top selector, choose the Project where you want your Google Drive service account to live.

  1. Search for "Google Drive API" in the search bar

  1. Depending on your existing setup, either click "ENABLE" or "MANAGE"
  2. Click "Credentials" in the sidebar

  1. Click "+ CREATE CREDENTIALS" and select "Service account" from the options

  1. Add a service account name
    a. Do not edit the ID field which will auto-populate
    b. Optionally add a description to the service account

  1. Click "CREATE AND CONTINUE"
  2. Click "Select a role" dropdown
    a. Scroll down the options and hover over "Basic"
    b. Select "Editor"

  1. Click "CONTINUE"
  2. Click "DONE"
  3. Find the new service on the service accounts table
    a. Click the pencil icon under the "Actions" column to edit

  1. Click the "KEYS" tab

  1. On the Keys tab click the "ADD KEY" dropdown and click "Create new key"

  1. In the popup modal select "JSON"
  2. Click "CREATE"
  3. Copy the downloaded file JSON contents and save for safe keeping. The contents of this file can be pasted into the "Service Account" input for all Google Drive Blueprints.

Inviting a Service Account to a Google Drive File​

  1. Navigate to the credentials page for the Google Drive API.
  2. In the table shown, copy the email/name of the service account you want to use. It should be formatted like name@project.iam.gserviceaccount.com

NOTE: This value can also be found either be found under "client_email" in the Service Account JSON.

  1. Navigate to the file you're wanting to use.
  2. Click the Share button.

  1. Paste the email of the service account from step 2 and click the email option that appears (or press Enter)

  1. Ensure that the Service Account email has Editor access.
  2. Click "Send".

  1. Click "Share anyway"

  1. Now you can start using any of our Blueprints with that file!

INFO: Pro Tip Want to access multiple files with the same credentials? You can also share Google Drive folders with the Service Account Email, causing every file in that folder and its subfolders to be accessible.

Drive and Folder ID's​

When providing the Shared Drive or the Google Drive Folder, you have the option to either provide the name of the Drive/Folder or the ID. It is recommended to provide the ID, since that is unique. Both the ID's can be found from the URL.

Drive ID​

All Drive ID's start with 0A and can be found by navigating to the root of the drive, and accessing it from the URL:

Folder ID​

All Folder ID's start with a 1 and are 33 characters long. It can be found by selecting the folder and accessing it from the URL: