Google Drive integration
Create, share, organise, and watch files across Google Drive and shared drives on behalf of your clients.
What it does
The Google Drive integration gives your agency the whole Drive surface inside a workflow: create and upload files, organise them into folders, move and trash them, share them with exactly the right people, manage shared drives, work through comments and approvals, and read back revision history. Connect a client’s Google account once and every file operation your workflow needs is a node — with the file, folder, drive, comment and permission all chosen from dropdowns rather than pasted as IDs.
Connect a Google Drive account
- Open your workspace in TaskJuice and navigate to Connections.
- Choose Google Drive and click Connect.
- Sign in with the Google account whose files you want to manage on behalf of your client.
- Grant the requested scopes. Full Drive access (
https://www.googleapis.com/auth/drive) is a Google restricted scope: you must bring your own OAuth client and complete Google’s CASA assessment against it before you can publish workflows that use it. TaskJuice records that requirement on the scope itself, so the editor tells you before you publish rather than after. - TaskJuice returns you to the workspace with the connection ready to use in any workflow.
To revoke access at any time, visit Google Account permissions and remove the TaskJuice entry.
Triggers
Every Drive trigger polls on a configurable interval and emits one activation per cycle, with everything newly observed wrapped in an items array. Drop a Loop node downstream (type array, path items) to handle each entry individually, or feed the array straight into a digest.
google-drive/new-file— lists Google Drive files ordered by creation time (newest first) and emits one cycle per poll containing every new file observed since the last cycle.google-drive/updated-file— emits Drive files whose content or metadata changed since the last poll, newest change first.google-drive/new-folder— emits Drive folders created since the last poll, newest first.google-drive/new-comment— emits comments added to one Drive file. Only comments created after the workflow is first published fire, judged by the comment's own creation date, so replying to or editing an older comment does not fire it.google-drive/new-shared-drive— emits shared drives the connected user gained access to since the last poll.
Actions
Files
google-drive/create-drive-file— creates an empty Drive file from metadata alone — a name, a MIME type and a parent folder.google-drive/create-folder— creates a folder in Drive.google-drive/create-file-from-text— creates a Drive file whose contents are the text you supply, in one multipart upload.google-drive/create-shortcut— creates a shortcut that points at an existing Drive file.google-drive/upload-file— uploads binary file content to Drive in one multipart request, together with its name and parent folder.google-drive/copy-file— copies an existing Drive file.google-drive/list-files— lists Drive files matching a search query.google-drive/get-file— retrieves the metadata of one Drive file.google-drive/download-file— downloads the binary content of a Drive file and returns it as a file reference a downstream node can consume.google-drive/export-file— exports a Google Docs Editors file (Doc, Sheet, Slide, Drawing) to a downloadable format such as PDF or DOCX.google-drive/update-file— updates the metadata of a Drive file — rename it, change its description, or star it.google-drive/move-file— moves a Drive file into a different folder.google-drive/trash-file— moves a Drive file to the trash.google-drive/untrash-file— restores a trashed Drive file to its original folder.google-drive/delete-file— permanently deletes a Drive file, skipping the trash.google-drive/empty-trash— permanently deletes every trashed file the connected user owns.google-drive/generate-file-ids— pre-allocates Drive file IDs.google-drive/start-file-download— starts an asynchronous Drive download and returns a long-running operation.google-drive/get-operation— reads the current state of a Drive long-running operation, such as the one Start File Download returns.
Sharing and permissions
google-drive/create-permission— grants access to a Drive file or folder.google-drive/list-permissions— lists everyone who currently has access to a Drive file or folder, and in what role.google-drive/get-permission— reads one existing access grant on a Drive file.google-drive/update-permission— changes an existing access grant — promote a reader to a writer, set or clear an expiry.google-drive/transfer-ownership— transfers ownership of a Drive file to an existing collaborator and demotes the connected account to writer; consumer accounts receive a pending-owner invitation the recipient must accept.google-drive/delete-permission— revokes an access grant on a Drive file.google-drive/list-access-proposals— lists the pending “request access” prompts on a Drive file.google-drive/get-access-proposal— reads one pending access request on a Drive file, including who asked and what they said.google-drive/resolve-access-proposal— approves or denies a pending access request on a Drive file.
Shared drives
google-drive/create-shared-drive— creates a shared drive.google-drive/list-shared-drives— lists the shared drives the connected user is a member of.google-drive/get-shared-drive— reads the metadata of one shared drive, including the capabilities the connected user has on it.google-drive/update-shared-drive— renames a shared drive or changes its theme, colour and restrictions.google-drive/delete-shared-drive— permanently deletes a shared drive.google-drive/hide-shared-drive— hides a shared drive from the connected user’s default view.google-drive/unhide-shared-drive— restores a hidden shared drive to the connected user’s default view.
Comments and replies
google-drive/create-comment— adds a comment to a Drive file.google-drive/list-comments— lists the comments on a Drive file, newest change first.google-drive/get-comment— reads one comment on a Drive file, together with its replies.google-drive/update-comment— rewrites the text of an existing comment on a Drive file.google-drive/delete-comment— deletes a comment from a Drive file, along with its replies.google-drive/create-reply— replies to a comment on a Drive file.google-drive/list-replies— lists the replies to one comment on a Drive file.google-drive/get-reply— reads one reply to a comment on a Drive file.google-drive/update-reply— rewrites the text of an existing reply to a comment.google-drive/delete-reply— deletes one reply to a comment on a Drive file.
Revisions
google-drive/list-revisions— lists the stored revisions of a Drive file.google-drive/get-revision— reads the metadata of one stored revision of a Drive file.google-drive/update-revision— changes what Drive does with a stored revision — pin it against the 30-day purge, or publish it.google-drive/delete-revision— permanently deletes one stored revision of a Drive file.
Change feed
google-drive/get-start-page-token— returns the cursor that marks “everything from now on”.google-drive/list-changes— reads everything that changed since a cursor — files added, edited, trashed or removed.
Labels
google-drive/list-file-labels— lists the Drive labels applied to a file.google-drive/modify-file-labels— adds, changes or removes Drive labels on a file.
Account
google-drive/get-about— reads the connected account’s Drive information: storage quota and usage, the signed-in user, and the import/export format map Drive supports.google-drive/list-installed-apps— lists the third-party apps the connected user has installed in Drive, and the file types each one opens.google-drive/get-installed-app— reads the details of one third-party Drive app by ID.
Approvals
google-drive/start-approval— opens an approval on a Drive file and asks the reviewers you name to sign off.google-drive/list-approvals— lists the approvals on a Drive file, open and closed.google-drive/get-approval— reads one approval on a Drive file, including each reviewer’s response.google-drive/approve-approval— records the connected user’s approval on a Drive file approval.google-drive/decline-approval— records the connected user’s rejection on a Drive file approval.google-drive/cancel-approval— cancels an open approval on a Drive file.google-drive/comment-on-approval— adds a comment to an open approval, notifying the initiator and every reviewer.google-drive/reassign-approval— adds or replaces the reviewers on an open approval.
Known limitations
- Drive triggers poll; they are not push. Google Drive does publish push notifications, but a Drive notification carries an empty body — every signal is in
X-Goog-*headers, and finding out what changed needs a second call against a stored cursor. TaskJuice therefore polls, with a 60-second floor and a five-minute default, so latency is bounded by the interval you choose rather than instant. - Full Drive access is a Google restricted scope. Google requires a CASA security assessment against your own OAuth client before an app may request
https://www.googleapis.com/auth/drivein production. Plan for that lead time. - A file has exactly one parent. Drive removed multi-parenting, so every action that places an item takes a single parent folder, and Move File is modelled as "add the new parent, remove the old one".
- Google Workspace features need a Workspace account. Shared drives, Drive labels and approvals are unavailable on a consumer Google account; those actions return a permission error rather than an empty result.
- Link-share grants show as a blank row in the permission picker. Drive labels a grant by the grantee's email, and an "anyone with the link" grant has none. The row is still selectable — it is the one with no label — or bind the ID from List Permissions (
anyoneWithLink) with the field's expression toggle. - Approvals and access requests involve other people. Starting an approval needs at least one reviewer who is a user in your Google Workspace, so a single-user tenant can only exercise the reviewer side on itself; reassigning to an address that is not a Workspace user is rejected by Drive. Access requests appear only when someone else asks for access to your file.
- Drive only ever deletes an older revision. Delete Revision on a file with a single revision is refused by Drive (
cannotDeleteOnlyRevision); the current revision is never deletable. - Docs Editors files have no binary content. Use Export File for a Doc, Sheet or Slide deck (choosing PDF, DOCX, XLSX and so on) and Download File for everything else.
- Drive keeps binary revisions for 30 days unless a revision is pinned with Keep Forever, so List Revisions on an older file may return fewer entries than you expect.
- The Drive API enforces per-user and per-project quotas. A 429 surfaces as a retryable rate-limit error and TaskJuice respects the recommended backoff.
Was this helpful?