🤖 Merge PR DefinitelyTyped#71508 [google-apps-script] Fixed types for file download by @marekdedic

Author: marekdedic

types/google-apps-script/apis/drive_v2.d.ts

@@ -111,6 +111,8 @@ declare namespace GoogleAppsScript {
                 // Gets a file's metadata by ID.
                 get(fileId: string): Drive.Schema.File;
                 // Gets a file's metadata by ID.
+                get(fileId: string, optionalArgs: Record<string, any> & { alt: "media" }): string;
+                // Gets a file's metadata by ID.
                 get(fileId: string, optionalArgs: Record<string, any>): Drive.Schema.File;
                 // Insert a new file.
                 insert(resource: Schema.File): Drive.Schema.File;

types/google-apps-script/apis/drive_v3.d.ts

@@ -1349,7 +1349,14 @@ declare namespace GoogleAppsScript {
                         /** Gets a file's metadata or content by ID. If you provide the URL parameter `alt=media`, then the response includes the file contents in the response body. Downloading content with `alt=media` only works if the file is stored in Drive. To download Google Docs, Sheets, and Slides use [`files.export`](/drive/api/reference/rest/v3/files/export) instead. For more information, see [Download & export files](/drive/api/guides/manage-downloads).
                         @param fileId The ID of the file.*/
                         get(fileId: string): Drive_v3.Drive.V3.Schema.File;
-                        /** Gets a file's metadata or content by ID. If you provide the URL parameter `alt=media`, then the response includes the file contents in the response body. Downloading content with `alt=media` only works if the file is stored in Drive. To download Google Docs, Sheets, and Slides use [`files.export`](/drive/api/reference/rest/v3/files/export) instead. For more information, see [Download & export files](/drive/api/guides/manage-downloads).
+                        /** Gets a file's content by ID. If you provide the URL parameter `alt=media`, then the response includes the file contents in the response body. Downloading content with `alt=media` only works if the file is stored in Drive. To download Google Docs, Sheets, and Slides use [`files.export`](/drive/api/reference/rest/v3/files/export) instead. For more information, see [Download & export files](/drive/api/guides/manage-downloads).
+                        @param fileId The ID of the file.
+                        @param optionalArgs Optional arguments.*/
+                        get(
+                            fileId: string,
+                            optionalArgs: Record<string, any> & { alt: "media" },
+                        ): string;
+                        /** Gets a file's metadata or content by ID.
                         @param fileId The ID of the file.
                         @param optionalArgs Optional arguments.*/
                         get(

types/google-apps-script/test/google-apps-script-tests.ts

@@ -1148,6 +1148,16 @@ function createFolder() {
     console.log("Created Folder:", folder.name, folder.id);
 }
 
+function getFile() {
+    const file = Drive.Files.get("FileID");
+    console.log(file.name);
+}
+
+function getRawFile() {
+    const fileBlob: string = Drive.Files.get("FileID", { alt: "media" });
+    console.log(fileBlob);
+}
+
 // Example showing how to create a folder
 function createDrive() {
     const drive = Drive.Drives.create({