Skip to main content

Connect Google Drive with VectorAmp's service account

Use this setup when VectorAmp asks you to share Google Drive folders with a VectorAmp service account.

VectorAmp service account:

gdrive-ingestion@vectoramp-customer-ingestion.iam.gserviceaccount.com

What you need​

  • A Google Drive folder URL or folder ID.
  • Permission to share that folder.
  • If your company blocks external sharing, ask your Google Workspace administrator to allow sharing with the VectorAmp service account above.

Share a folder from Google Drive​

  1. Open Google Drive.

  2. Find the folder you want VectorAmp to ingest.

  3. Right-click the folder.

  4. Click Share.

  5. In Add people, groups, and calendar events, paste:

    gdrive-ingestion@vectoramp-customer-ingestion.iam.gserviceaccount.com

  6. Set the role to Viewer.

  7. Leave Notify people unchecked if Google shows that option.

  8. Click Share or Send.

VectorAmp only needs Viewer access.

Copy the folder URL​

  1. In Google Drive, open the folder.
  2. Copy the URL from your browser address bar.
  3. Paste the full URL into VectorAmp.

A Google Drive folder URL usually looks like this:

https://drive.google.com/drive/folders/1AbCdEfGhIjKlMnOpQrStUvWxYz

VectorAmp will extract the folder ID automatically.

Copy only the folder ID​

If you prefer to paste only the ID:

  1. Open the folder in Google Drive.
  2. Look at the URL.
  3. Copy the value after /folders/.

Example:

https://drive.google.com/drive/folders/1AbCdEfGhIjKlMnOpQrStUvWxYz

Folder ID:

1AbCdEfGhIjKlMnOpQrStUvWxYz

Add multiple folders​

In VectorAmp, paste one folder URL or folder ID per line.

Example:

https://drive.google.com/drive/folders/1AbCdEfGhIjKlMnOpQrStUvWxYz
1MnOpQrStUvWxYzAbCdEfGhIjKl

Shared drives​

For folders inside a Shared Drive:

  1. Open Google Drive.
  2. Open the Shared Drive.
  3. Right-click the folder.
  4. Click Share.
  5. Add the VectorAmp service account as Viewer.
  6. Copy the folder URL and paste it into VectorAmp.

If sharing is disabled, ask your Google Workspace administrator to allow external sharing for that Shared Drive or folder.

Troubleshooting​

VectorAmp says it cannot access the folder​

Check that:

  • The folder was shared with gdrive-ingestion@vectoramp-customer-ingestion.iam.gserviceaccount.com.
  • The role is Viewer or higher.
  • You pasted a folder URL or folder ID, not a file URL.
  • Your Google Workspace policy allows sharing with external service accounts.

I do not see a Share option​

You may not have permission to share that folder. Ask the folder owner or your Google Workspace administrator to grant access.

Fallback: use your own service account JSON​

Use this only if your Google Workspace policy blocks sharing Drive folders with VectorAmp's service account.

Create a service account​

  1. Open the Google Cloud Console service accounts page.
  2. Select the Google Cloud project you want to use for this integration.
  3. Click Create service account.
  4. Enter a service account name, for example vectoramp-drive-ingestion.
  5. Click Create and continue.
  6. You do not need to grant project roles for Google Drive folder sharing. Click Continue.
  7. Click Done.

Create a JSON key​

  1. On the Service accounts page, click the service account you created.
  2. Open the Keys tab.
  3. Click Add key.
  4. Click Create new key.
  5. Select JSON.
  6. Click Create.
  7. Google downloads a .json file to your computer.

Treat this file like a password. Anyone with the file can act as that service account.

Share the Drive folder with your service account​

  1. Open the downloaded JSON file in a text editor.
  2. Copy the client_email value. It looks like name@project-id.iam.gserviceaccount.com.
  3. Open Google Drive.
  4. Right-click the folder you want VectorAmp to ingest.
  5. Click Share.
  6. Paste the client_email value.
  7. Set the role to Viewer.
  8. Click Share or Send.

Add it in VectorAmp​

  1. In VectorAmp, choose Upload my own service account JSON.
  2. Drag/select the downloaded .json key file, or paste the full JSON contents.
  3. Paste the Drive folder URL or folder ID.
  4. Save the source.