@pipedream/google_drive 1.12.2 → 2.1.0

package/actions/add-comment/add-comment.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-add-comment",
   name: "Add Comment",
   description: "Add an unanchored comment to a Google Doc (general feedback, no text highlighting). [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/comments/create)",
-  version: "0.1.8",
+  version: "0.1.9",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/add-file-sharing-preference/add-file-sharing-preference.mjs

@@ -20,7 +20,7 @@ export default {
   name: "Share File or Folder",
   description:
     "Add a [sharing permission](https://support.google.com/drive/answer/7166529) to the sharing preferences of a file or folder and provide a sharing URL. [See the documentation](https://developers.google.com/drive/api/v3/reference/permissions/create)",
-  version: "0.2.16",
+  version: "0.2.17",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/copy-file/copy-file.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-copy-file",
   name: "Copy File",
   description: "Create a copy of the specified file. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/copy) for more information",
-  version: "0.1.23",
+  version: "0.1.24",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/create-file-from-template/create-file-from-template.mjs

@@ -9,7 +9,7 @@ export default {
   key: "google_drive-create-file-from-template",
   name: "Create New File From Template",
   description: "Create a new Google Docs file from a template. Optionally include placeholders in the template document that will get replaced from this action. [See documentation](https://www.npmjs.com/package/google-docs-mustaches)",
-  version: "0.1.26",
+  version: "0.1.27",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/create-file-from-text/create-file-from-text.mjs

@@ -5,7 +5,7 @@ export default {
   key: "google_drive-create-file-from-text",
   name: "Create New File From Text",
   description: "Create a new file from plain text. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/create) for more information",
-  version: "0.2.16",
+  version: "0.2.17",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/create-folder/create-folder.mjs

@@ -13,7 +13,7 @@ export default {
   key: "google_drive-create-folder",
   name: "Create Folder",
   description: "Create a new empty folder. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/create) for more information",
-  version: "0.1.24",
+  version: "0.1.25",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/create-shared-drive/create-shared-drive.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-create-shared-drive",
   name: "Create Shared Drive",
   description: "Create a new shared drive. [See the documentation](https://developers.google.com/drive/api/v3/reference/drives/create) for more information",
-  version: "0.1.24",
+  version: "0.1.25",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/create-text-file/create-text-file.mjs

@@ -12,7 +12,7 @@ export default {
     + " `mimeType = 'application/vnd.google-apps.folder'` to find the folder ID first."
     + " Supported content formats: plain text, Markdown, HTML, Rich Text, CSV."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/files/create)",
-  version: "0.0.2",
+  version: "0.0.3",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/delete-comment/delete-comment.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-delete-comment",
   name: "Delete Comment",
   description: "Delete a specific comment (Requires ownership or permissions). [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/comments/delete)",
-  version: "0.0.12",
+  version: "0.0.13",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/delete-file/delete-file.mjs

@@ -5,7 +5,7 @@ export default {
   name: "Delete File",
   description:
     "Permanently delete a file or folder without moving it to the trash. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/delete) for more information",
-  version: "0.1.24",
+  version: "0.1.25",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/delete-reply/delete-reply.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-delete-reply",
   name: "Delete Reply",
   description: "Delete a reply on a specific comment. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/replies/delete) for more information",
-  version: "0.0.9",
+  version: "0.0.10",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/delete-shared-drive/delete-shared-drive.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-delete-shared-drive",
   name: "Delete Shared Drive",
   description: "Delete a shared drive without any content. [See the documentation](https://developers.google.com/drive/api/v3/reference/drives/delete) for more information",
-  version: "0.1.23",
+  version: "0.1.24",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/download-file/download-file.mjs

@@ -1,3 +1,4 @@
+import { ConfigurationError } from "@pipedream/platform";
 import fs from "fs";
 import stream from "stream";
 import { promisify } from "util";
@@ -24,14 +25,15 @@ const SHORTCUT_MIME_TYPE = "application/vnd.google-apps.shortcut";
 export default {
   key: "google_drive-download-file",
   name: "Download File",
-  description: "Download a file from Google Drive to the `/tmp` directory or return its contents as a buffer."
+  description: "Download one or more files from Google Drive to the `/tmp` directory or return their contents as buffers."
+    + " Select multiple files to download a batch in a single run."
     + " Use to fetch a file's contents for processing in downstream steps — e.g., parsing a CSV, extracting text from a PDF, or re-uploading to another service."
     + " For Google Workspace files (Docs, Sheets, Slides, Drawings, Apps Script), exports to an Office-compatible format by default:"
     + " Docs → `.docx`, Sheets → `.xlsx`, Slides → `.pptx`, Drawings → PNG, Apps Script → JSON."
     + " Pass `mimeType` to force a specific format. Shortcuts are resolved to their target automatically."
     + " Folders, Forms, and My Maps cannot be downloaded via this action."
     + " [See the documentation](https://developers.google.com/drive/api/v3/manage-downloads)",
-  version: "0.1.27",
+  version: "0.2.1",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -48,6 +50,19 @@ export default {
       description: "The shared drive the file is in, if any. Leave empty for files in My Drive.",
       optional: true,
     },
+    fileIds: {
+      propDefinition: [
+        googleDrive,
+        "fileId",
+        (c) => ({
+          drive: c.drive,
+        }),
+      ],
+      type: "string[]",
+      label: "Files",
+      description: "The Google Drive file(s) to download. Select one or more files to download a batch in a single run. Accepts file IDs (opaque Drive identifiers). Shortcuts are resolved to their target automatically.",
+      optional: true,
+    },
     fileId: {
       propDefinition: [
         googleDrive,
@@ -56,7 +71,8 @@ export default {
           drive: c.drive,
         }),
       ],
-      description: "The Google Drive file to download. Accepts a file ID (opaque Drive identifier). If a shortcut is passed, the target file is resolved and downloaded automatically.",
+      description: "A single Google Drive file to download. Kept for backwards compatibility — prefer `Files` for new configurations. If both are set, this file is included alongside the ones in `Files`.",
+      optional: true,
     },
     filePath: {
       type: "string",
@@ -82,7 +98,7 @@ export default {
       `),
       optional: true,
       async options() {
-        const fileId = this.fileId;
+        const fileId = this.fileId ?? this.fileIds?.[0];
         if (!fileId) {
           return googleWorkspaceExportFormats;
         }
@@ -127,104 +143,150 @@ export default {
     },
   },
   async run({ $ }) {
-    let fileMetadata = await this.googleDrive.getFile(this.fileId, {
-      fields: "name,mimeType,shortcutDetails,webViewLink",
-    });
-
-    // Shortcuts point at a target file; resolve and download the target instead.
-    let downloadFileId = this.fileId;
-    let resolvedFromShortcut = false;
-    if (fileMetadata.mimeType === SHORTCUT_MIME_TYPE) {
-      const targetId = fileMetadata.shortcutDetails?.targetId;
-      if (!targetId) {
-        throw new Error(`Shortcut "${fileMetadata.name}" has no target file and cannot be downloaded.`);
-      }
-      downloadFileId = targetId;
-      resolvedFromShortcut = true;
-      fileMetadata = await this.googleDrive.getFile(targetId, {
-        fields: "name,mimeType,webViewLink",
-      });
-    }
+    // Combine the batch input (`fileIds`) with the legacy single `fileId`, keeping
+    // order and dropping duplicates so the same file isn't downloaded twice.
+    const requestedIds = [
+      ...(this.fileIds ?? []),
+      ...(this.fileId
+        ? [
+          this.fileId,
+        ]
+        : []),
+    ];
+    const fileIds = [
+      ...new Set(requestedIds),
+    ];
 
-    const sourceMimeType = fileMetadata.mimeType;
-
-    if (unsupportedWorkspaceMimes[sourceMimeType]) {
-      throw new Error(
-        `Cannot download file of type "${sourceMimeType}": ${unsupportedWorkspaceMimes[sourceMimeType]}`,
-      );
+    if (fileIds.length === 0) {
+      throw new ConfigurationError("Select at least one file to download (`Files` or `File`).");
+    }
+    if (fileIds.length > 1 && this.filePath) {
+      throw new ConfigurationError("`Destination File Path` can only be used when downloading a single file. Remove it to download multiple files (each saves to `/tmp/<file name>`).");
     }
 
-    const isWorkspaceDocument = sourceMimeType.includes(GOOGLE_DRIVE_MIME_TYPE_PREFIX);
+    const pipeline = promisify(stream.pipeline);
+
+    // Downloads a single file (resolving shortcuts + Workspace export formats),
+    // either writing it to /tmp or returning its contents as a buffer.
+    const downloadOne = async (requestedFileId) => {
+      let fileMetadata = await this.googleDrive.getFile(requestedFileId, {
+        fields: "name,mimeType,shortcutDetails,webViewLink",
+      });
 
-    // Fallback: user value -> static default -> runtime getExportFormats().
-    let effectiveMimeType = this.mimeType;
-    if (isWorkspaceDocument && !effectiveMimeType) {
-      effectiveMimeType = defaultExportMimeBySource[sourceMimeType];
-      if (!effectiveMimeType) {
-        const exportFormats = await this.googleDrive.getExportFormats();
-        effectiveMimeType = exportFormats[sourceMimeType]?.[0];
+      // Shortcuts point at a target file; resolve and download the target instead.
+      let downloadFileId = requestedFileId;
+      let resolvedFromShortcut = false;
+      if (fileMetadata.mimeType === SHORTCUT_MIME_TYPE) {
+        const targetId = fileMetadata.shortcutDetails?.targetId;
+        if (!targetId) {
+          throw new Error(`Shortcut "${fileMetadata.name}" has no target file and cannot be downloaded.`);
+        }
+        downloadFileId = targetId;
+        resolvedFromShortcut = true;
+        fileMetadata = await this.googleDrive.getFile(targetId, {
+          fields: "name,mimeType,webViewLink",
+        });
       }
-      if (!effectiveMimeType) {
+
+      const sourceMimeType = fileMetadata.mimeType;
+
+      if (unsupportedWorkspaceMimes[sourceMimeType]) {
         throw new Error(
-          `No export format available for "${sourceMimeType}". Set Conversion Format explicitly.`,
+          `Cannot download file of type "${sourceMimeType}": ${unsupportedWorkspaceMimes[sourceMimeType]}`,
         );
       }
-    }
 
-    // See https://developers.google.com/drive/api/v3/mime-types for Google MIME types.
-    const file = isWorkspaceDocument
-      ? await this.googleDrive.downloadWorkspaceFile(downloadFileId, {
-        mimeType: effectiveMimeType,
-      })
-      : await this.googleDrive.getFile(downloadFileId, {
-        alt: "media",
-      });
+      const isWorkspaceDocument = sourceMimeType.includes(GOOGLE_DRIVE_MIME_TYPE_PREFIX);
+
+      // Fallback: user value -> static default -> runtime getExportFormats().
+      let effectiveMimeType = this.mimeType;
+      if (isWorkspaceDocument && !effectiveMimeType) {
+        effectiveMimeType = defaultExportMimeBySource[sourceMimeType];
+        if (!effectiveMimeType) {
+          const exportFormats = await this.googleDrive.getExportFormats();
+          effectiveMimeType = exportFormats[sourceMimeType]?.[0];
+        }
+        if (!effectiveMimeType) {
+          throw new Error(
+            `No export format available for "${sourceMimeType}". Set Conversion Format explicitly.`,
+          );
+        }
+      }
 
-    const summaryPrefix = resolvedFromShortcut
-      ? "Resolved shortcut and downloaded"
-      : "Successfully downloaded";
+      // See https://developers.google.com/drive/api/v3/mime-types for Google MIME types.
+      const file = isWorkspaceDocument
+        ? await this.googleDrive.downloadWorkspaceFile(downloadFileId, {
+          mimeType: effectiveMimeType,
+        })
+        : await this.googleDrive.getFile(downloadFileId, {
+          alt: "media",
+        });
 
-    if (this.getBufferResponse) {
-      $.export("$summary", `${summaryPrefix} raw content for file "${fileMetadata.name}"`);
+      if (this.getBufferResponse) {
+        const chunks = [];
+        for await (const chunk of file) {
+          chunks.push(chunk);
+        }
+        const buffer = Buffer.concat(chunks);
 
-      const chunks = [];
-      for await (const chunk of file) {
-        chunks.push(chunk);
+        return {
+          fileId: requestedFileId,
+          fileMetadata,
+          webViewLink: fileMetadata.webViewLink,
+          content: buffer,
+          resolvedFromShortcut,
+        };
       }
-      const buffer = Buffer.concat(chunks);
+
+      let filePath;
+      if (this.filePath) {
+        filePath = this.filePath.includes("tmp/")
+          ? this.filePath
+          : `/tmp/${this.filePath}`;
+      } else {
+        let defaultName = fileMetadata.name;
+        if (isWorkspaceDocument) {
+          const ext = extensionByMime[effectiveMimeType];
+          if (ext && !defaultName.toLowerCase().endsWith(`.${ext.toLowerCase()}`)) {
+            defaultName = `${defaultName}.${ext}`;
+          }
+        }
+        filePath = `/tmp/${defaultName}`;
+      }
+
+      await pipeline(file, fs.createWriteStream(filePath));
 
       return {
-        fileId: this.fileId,
+        fileId: requestedFileId,
         fileMetadata,
         webViewLink: fileMetadata.webViewLink,
-        content: buffer,
+        filePath,
+        resolvedFromShortcut,
       };
-    }
+    };
 
-    let filePath;
-    if (this.filePath) {
-      filePath = this.filePath.includes("tmp/")
-        ? this.filePath
-        : `/tmp/${this.filePath}`;
-    } else {
-      let defaultName = fileMetadata.name;
-      if (isWorkspaceDocument) {
-        const ext = extensionByMime[effectiveMimeType];
-        if (ext && !defaultName.toLowerCase().endsWith(`.${ext.toLowerCase()}`)) {
-          defaultName = `${defaultName}.${ext}`;
-        }
-      }
-      filePath = `/tmp/${defaultName}`;
+    // Single-file downloads keep the original (non-array) return shape for
+    // backwards compatibility; batches return an array of per-file results.
+    if (fileIds.length === 1) {
+      const result = await downloadOne(fileIds[0]);
+      const verb = result.resolvedFromShortcut
+        ? "Resolved shortcut and downloaded"
+        : "Successfully downloaded";
+      const what = this.getBufferResponse
+        ? `raw content for file "${result.fileMetadata.name}"`
+        : `the file, "${result.fileMetadata.name}"`;
+      $.export("$summary", `${verb} ${what}`);
+      return result;
     }
 
-    const pipeline = promisify(stream.pipeline);
-    await pipeline(file, fs.createWriteStream(filePath));
-    $.export("$summary", `${summaryPrefix} the file, "${fileMetadata.name}"`);
+    const files = [];
+    for (const id of fileIds) {
+      files.push(await downloadOne(id));
+    }
+    $.export("$summary", `Successfully downloaded ${files.length} file(s).`);
     return {
-      fileId: this.fileId,
-      fileMetadata,
-      webViewLink: fileMetadata.webViewLink,
-      filePath,
+      files,
+      count: files.length,
     };
   },
 };

package/actions/find-file/find-file.mjs

@@ -6,7 +6,7 @@ export default {
   key: "google_drive-find-file",
   name: "Find File",
   description: "Search for a specific file by name. The `Search Name` field uses Google Drive's tokenized full-text matching — pass a distinctive word or short phrase rather than the full title when the name contains special characters like `&` or `'`. [See the documentation](https://developers.google.com/drive/api/v3/search-files) for more information",
-  version: "0.1.24",
+  version: "0.1.25",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/find-folder/find-folder.mjs

@@ -7,7 +7,7 @@ export default {
   key: "google_drive-find-folder",
   name: "Find Folder",
   description: "Search for a specific folder by name. The `Search Name` field uses Google Drive's tokenized full-text matching — pass a distinctive word or short phrase rather than the full title when the name contains special characters like `&` or `'`. [See the documentation](https://developers.google.com/drive/api/v3/search-files) for more information",
-  version: "0.1.24",
+  version: "0.1.25",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/find-forms/find-forms.mjs

@@ -6,7 +6,7 @@ export default {
   key: "google_drive-find-forms",
   name: "Find Forms",
   description: "List Google Form documents or search for a Form by name. The `Search Name` field uses Google Drive's tokenized full-text matching — pass a distinctive word or short phrase rather than the full title when the name contains special characters like `&` or `'`. [See the documentation](https://developers.google.com/drive/api/v3/search-files) for more information",
-  version: "0.0.25",
+  version: "0.0.26",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/find-spreadsheets/find-spreadsheets.mjs

@@ -6,7 +6,7 @@ export default {
   key: "google_drive-find-spreadsheets",
   name: "Find Spreadsheets",
   description: "Search for a specific spreadsheet by name. The `Search Name` field uses Google Drive's tokenized full-text matching — pass a distinctive word or short phrase rather than the full title when the name contains special characters like `&` or `'`. [See the documentation](https://developers.google.com/drive/api/v3/search-files) for more information",
-  version: "0.1.24",
+  version: "0.1.25",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-comment/get-comment.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-get-comment",
   name: "Get Comment By ID",
   description: "Get comment by ID on a specific file. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/comments/get) for more information",
-  version: "0.0.9",
+  version: "0.0.10",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-current-user/get-current-user.mjs

@@ -6,7 +6,7 @@ export default {
   key: "google_drive-get-current-user",
   name: "Get Current User",
   description: "Retrieve Google Drive account metadata for the authenticated user via `about.get`, including display name, email, permission ID, and storage quota. Useful when flows or agents need to confirm the active Google identity or understand available storage. [See the documentation](https://developers.google.com/drive/api/v3/reference/about/get).",
-  version: "0.0.10",
+  version: "0.0.11",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/get-file/get-file.mjs

@@ -11,7 +11,7 @@ export default {
     + "\n\nCommon fields: `id`, `name`, `mimeType`, `size`, `parents`, `webViewLink`, `webContentLink`,"
     + " `createdTime`, `modifiedTime`, `owners`, `permissions`, `description`, `trashed`."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/files/get)",
-  version: "0.0.2",
+  version: "0.0.3",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/get-file-by-id/get-file-by-id.mjs

@@ -5,7 +5,7 @@ export default {
   key: "google_drive-get-file-by-id",
   name: "Get File By ID",
   description: "Get info on a specific file. [See the documentation](https://developers.google.com/drive/api/reference/rest/v3/files/get) for more information",
-  version: "0.0.20",
+  version: "0.0.21",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-folder-id-for-path/get-folder-id-for-path.mjs

@@ -12,7 +12,7 @@ export default {
   key: "google_drive-get-folder-id-for-path",
   name: "Get Folder ID for a Path",
   description: "Retrieve a folderId for a path. [See the documentation](https://developers.google.com/drive/api/v3/search-files) for more information",
-  version: "0.1.25",
+  version: "0.1.26",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-reply/get-reply.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-get-reply",
   name: "Get Reply By ID",
   description: "Get reply by ID on a specific comment. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/replies/get) for more information",
-  version: "0.0.9",
+  version: "0.0.10",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-shared-drive/get-shared-drive.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-get-shared-drive",
   name: "Get Shared Drive",
   description: "Get metadata for one or all shared drives. [See the documentation](https://developers.google.com/drive/api/v3/reference/drives/get) for more information",
-  version: "0.1.23",
+  version: "0.1.24",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-user-details/get-user-details.mjs

@@ -10,7 +10,7 @@ export default {
     + " When the user says 'my files' or 'my documents', call this first to get the owner email,"
     + " then pass it to **Search Files** with a query like `'user@example.com' in owners`."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/about/get)",
-  version: "0.0.2",
+  version: "0.0.3",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/is-folder-ancestor/is-folder-ancestor.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-is-folder-ancestor",
   name: "Is Folder Ancestor",
   description: "Check if a specific folder is anywhere in the parent hierarchy of a file or folder. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/files/get)",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-access-proposals/list-access-proposals.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-list-access-proposals",
   name: "List Access Proposals",
   description: "List access proposals for a file or folder. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/accessproposals/list)",
-  version: "0.0.16",
+  version: "0.0.17",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,