Nestjs Google Drive Upload

a nestjs google drive upload app

Setup Google Drive API

• Go to Google Cloud Console
• Create a new project
• Enable Google Drive API
• Create a service account
• Download the service account key
• Fill the .env file with the service account data
• Create a uploads folder in your Google Drive
• Share the uploads folder with the service account email
• Share the uploads folder with anyone who has the link to make the files public

Running the app

• Install the dependencies

$ npm i

• Create a .env file from the .env.example file
• Fill the .env file with the required data
• Run the app services

$ docker compose up -d

• Run the app

$ npm run start:dev

• Go to http://localhost:3000 to see the swagger with examples

Migrations

# generate a migration
$ npm run migration:generate --name=example

# run a migration
$ npm run migration:run

# revert a migration
$ npm run migration:revert

Tests (e2e)

$ npm run test

Q/A

Why do I need to share the folder with the service account email?

Service accounts have their own isolated Google Drive storage space. Sharing the folder with the service account email allows you to see the uploaded files in your Google Drive UI. Without sharing, files will still be uploaded successfully but will won't be visible in your Google Drive UI.

Note: If you delete a file from the shared folder in your Google Drive UI, it won't be permanently deleted from the service account's storage—it will only be moved to the trash. To properly delete files, use the API endpoints.

Why do I need /v1/files/:id/download endpoint?

Google Drive files cannot be embedded into tag directly, they disabled the ability to do it, so we need a proxy endpoint to serve the files, but it's just a browser limit, so you can just do fetch on google drive url and receive the file stream.