@maxim_mazurok/gapi.client.drive-v3 0.0.20230326 → 0.0.20230413

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://www.googleapis.com/discovery/v1/apis/drive/v3/rest
-// Revision: 20230326
+// Revision: 20230413
 
 /// <reference types="gapi.client" />
 
@@ -311,19 +311,19 @@ declare namespace gapi.client {
         }
         interface File {
             /**
-             * A collection of arbitrary key-value pairs which are private to the requesting app.
+             * A collection of arbitrary key-value pairs that are private to the requesting app.
              * Entries with null values are cleared in update and copy requests. These properties can only be retrieved using an authenticated request. An authenticated request uses an access
-             * token obtained with a OAuth 2 client ID. You cannot use an API key to retrieve private properties.
+             * token obtained with an OAuth 2 client ID. You cannot use an API key to retrieve private properties.
              */
             appProperties?: { [P in string]: string };
-            /** Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take. */
+            /** Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user can take. */
             capabilities?: {
                 /** Whether the current user is the pending owner of the file. Not populated for shared drive files. */
                 canAcceptOwnership?: boolean;
-                /** Whether the current user can add children to this folder. This is always false when the item is not a folder. */
+                /** Whether the current user can add children to this folder. This is always false when the item isn't a folder. */
                 canAddChildren?: boolean;
                 /**
-                 * Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for
+                 * Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item isn't a folder. Only populated for
                  * items in shared drives.
                  */
                 canAddFolderFromAnotherDrive?: boolean;
@@ -338,22 +338,22 @@ declare namespace gapi.client {
                 /** Whether the current user can comment on this file. */
                 canComment?: boolean;
                 /**
-                 * Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it is
+                 * Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it's
                  * not a folder.
                  */
                 canCopy?: boolean;
                 /** Whether the current user can delete this file. */
                 canDelete?: boolean;
-                /** Whether the current user can delete children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. */
+                /** Whether the current user can delete children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. */
                 canDeleteChildren?: boolean;
                 /** Whether the current user can download this file. */
                 canDownload?: boolean;
                 /**
-                 * Whether the current user can edit this file. Other factors may limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or
+                 * Whether the current user can edit this file. Other factors might limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or
                  * canModifyContent.
                  */
                 canEdit?: boolean;
-                /** Whether the current user can list the children of this folder. This is always false when the item is not a folder. */
+                /** Whether the current user can list the children of this folder. This is always false when the item isn't a folder. */
                 canListChildren?: boolean;
                 /** Whether the current user can modify the content of this file. */
                 canModifyContent?: boolean;
@@ -361,13 +361,13 @@ declare namespace gapi.client {
                 canModifyContentRestriction?: boolean;
                 /** Whether the current user can modify the labels on this file. */
                 canModifyLabels?: boolean;
-                /** Whether the current user can move children of this folder outside of the shared drive. This is false when the item is not a folder. Only populated for items in shared drives. */
+                /** Whether the current user can move children of this folder outside of the shared drive. This is false when the item isn't a folder. Only populated for items in shared drives. */
                 canMoveChildrenOutOfDrive?: boolean;
                 /** Deprecated - use canMoveChildrenOutOfDrive instead. */
                 canMoveChildrenOutOfTeamDrive?: boolean;
                 /**
-                 * Whether the current user can move children of this folder within this drive. This is false when the item is not a folder. Note that a request to move the child may still fail
-                 * depending on the current user's access to the child and to the destination folder.
+                 * Whether the current user can move children of this folder within this shared drive or My Drive. This is false when the item isn't a folder. Note that a request to move the child
+                 * might still fail depending on the current user's access to the child and to the destination folder.
                  */
                 canMoveChildrenWithinDrive?: boolean;
                 /** Deprecated - use canMoveChildrenWithinDrive instead. */
@@ -375,15 +375,15 @@ declare namespace gapi.client {
                 /** Deprecated - use canMoveItemOutOfDrive instead. */
                 canMoveItemIntoTeamDrive?: boolean;
                 /**
-                 * Whether the current user can move this item outside of this drive by changing its parent. Note that a request to change the parent of the item may still fail depending on the
-                 * new parent that is being added.
+                 * Whether the current user can move this item outside of this shared drive or My Drive by changing its parent. Note that a request to change the parent of the item might still
+                 * fail depending on the new parent that's being added.
                  */
                 canMoveItemOutOfDrive?: boolean;
                 /** Deprecated - use canMoveItemOutOfDrive instead. */
                 canMoveItemOutOfTeamDrive?: boolean;
                 /**
-                 * Whether the current user can move this item within this drive. Note that a request to change the parent of the item may still fail depending on the new parent that is being
-                 * added and the parent that is being removed.
+                 * Whether the current user can move this item within this shared drive or My Drive. Note that a request to change the parent of the item might still fail depending on the new
+                 * parent that's being added and the parent that's being removed.
                  */
                 canMoveItemWithinDrive?: boolean;
                 /** Deprecated - use canMoveItemWithinDrive instead. */
@@ -396,13 +396,13 @@ declare namespace gapi.client {
                 canReadLabels?: boolean;
                 /**
                  * Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if
-                 * it isn't a folder, can be read.
+                 * it's not a folder, can be read.
                  */
                 canReadRevisions?: boolean;
                 /** Deprecated - use canReadDrive instead. */
                 canReadTeamDrive?: boolean;
                 /**
-                 * Whether the current user can remove children from this folder. This is always false when the item is not a folder. For a folder in a shared drive, use canDeleteChildren or
+                 * Whether the current user can remove children from this folder. This is always false when the item isn't a folder. For a folder in a shared drive, use canDeleteChildren or
                  * canTrashChildren instead.
                  */
                 canRemoveChildren?: boolean;
@@ -414,14 +414,14 @@ declare namespace gapi.client {
                 canShare?: boolean;
                 /** Whether the current user can move this file to trash. */
                 canTrash?: boolean;
-                /** Whether the current user can trash children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. */
+                /** Whether the current user can trash children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. */
                 canTrashChildren?: boolean;
                 /** Whether the current user can restore this file from trash. */
                 canUntrash?: boolean;
             };
             /** Additional information about the content of the file. These fields are never populated in responses. */
             contentHints?: {
-                /** Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and may contain HTML elements. For more information, see Manage file metadata. */
+                /** Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and might contain HTML elements. For more information, see Manage file metadata. */
                 indexableText?: string;
                 /** A thumbnail for the file. This will only be used if Google Drive cannot generate a standard thumbnail. */
                 thumbnail?: {
@@ -453,16 +453,16 @@ declare namespace gapi.client {
              */
             folderColorRgb?: string;
             /**
-             * The full file extension extracted from the name field. May contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google
+             * The full file extension extracted from the name field. Can contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google
              * Drive.
-             * This is automatically updated when the name field changes, however it isn't cleared if the new name does not contain a valid extension.
+             * This is automatically updated when the name field changes, however it's not cleared if the new name does not contain a valid extension.
              */
             fullFileExtension?: string;
             /** Whether there are permissions directly on this file. This field is only populated for items in shared drives. */
             hasAugmentedPermissions?: boolean;
             /** Whether this file has a thumbnail. This does not indicate whether the requesting app has access to the thumbnail. To check access, look for the presence of the thumbnailLink field. */
             hasThumbnail?: boolean;
-            /** The ID of the file's head revision. This is currently only available for files with binary content in Google Drive. */
+            /** The ID of the file's head revision. This is only available for files with binary content in Google Drive. */
             headRevisionId?: string;
             /** A static, unauthenticated link to the file's icon. */
             iconLink?: string;
@@ -507,7 +507,7 @@ declare namespace gapi.client {
                 maxApertureValue?: number;
                 /** The metering mode used to create the photo. */
                 meteringMode?: string;
-                /** The number of clockwise 90 degree rotations applied from the image's original orientation. */
+                /** The number of clockwise 90-degree rotations applied from the image's original orientation. */
                 rotation?: number;
                 /** The type of sensor used to create the photo. */
                 sensor?: string;
@@ -520,7 +520,7 @@ declare namespace gapi.client {
                 /** The width of the image in pixels. */
                 width?: number;
             };
-            /** Whether the file was created or opened by the requesting app. */
+            /** Whether the requesting app created or opened the file. */
             isAppAuthorized?: boolean;
             /** Identifies what kind of resource this is. Value: the fixed string "drive#file". */
             kind?: string;
@@ -546,17 +546,17 @@ declare namespace gapi.client {
              * If a file is created with a Google Doc MIME type, the uploaded content will be imported if possible. The supported import formats are published in the About resource.
              */
             mimeType?: string;
-            /** Whether the file has been modified by this user. */
+            /** Whether this user has modified the file. */
             modifiedByMe?: boolean;
-            /** The last time the file was modified by the user (RFC 3339 date-time). */
+            /** The last time the user modified the file (RFC 3339 date-time). */
             modifiedByMeTime?: string;
             /**
-             * The last time the file was modified by anyone (RFC 3339 date-time).
+             * The last time anyone modified the file (RFC 3339 date-time).
              * Note that setting modifiedTime will also update modifiedByMeTime for the user.
              */
             modifiedTime?: string;
             /**
-             * The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and
+             * The name of the file. This isn't necessarily unique within a folder. Note that for immutable items such as the top-level folders of shared drives, My Drive root folder, and
              * Application Data folder the name is constant.
              */
             name?: string;
@@ -564,10 +564,10 @@ declare namespace gapi.client {
             originalFilename?: string;
             /** Whether the user owns the file. Not populated for items in shared drives. */
             ownedByMe?: boolean;
-            /** The owner of this file. Only certain legacy files may have more than one owner. This field isn't populated for items in shared drives. */
+            /** The owner of this file. Only certain legacy files might have more than one owner. This field isn't populated for items in shared drives. */
             owners?: User[];
             /**
-             * The IDs of the parent folders which contain the file.
+             * The IDs of the parent folders that contain the file.
              * If not specified as part of a create request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any
              * discoverable parents of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list.
              */
@@ -577,7 +577,7 @@ declare namespace gapi.client {
             /** The full list of permissions for the file. This is only available if the requesting user can share the file. Not populated for items in shared drives. */
             permissions?: Permission[];
             /**
-             * A collection of arbitrary key-value pairs which are visible to all apps.
+             * A collection of arbitrary key-value pairs that are visible to all apps.
              * Entries with null values are cleared in update and copy requests.
              */
             properties?: { [P in string]: string };
@@ -586,12 +586,12 @@ declare namespace gapi.client {
             /** A key needed to access the item via a shared link. */
             resourceKey?: string;
             /**
-             * The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or
+             * The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or
              * shortcut files.
              */
             sha1Checksum?: string;
             /**
-             * The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or
+             * The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or
              * shortcut files.
              */
             sha256Checksum?: string;
@@ -611,11 +611,11 @@ declare namespace gapi.client {
                 targetResourceKey?: string;
             };
             /**
-             * The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it is not populated for shortcuts
-             * or folders.
+             * The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it's not populated for shortcuts or
+             * folders.
              */
             size?: string;
-            /** The list of spaces which contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. */
+            /** The list of spaces that contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. */
             spaces?: string[];
             /** Whether the user has starred the file. */
             starred?: boolean;
@@ -629,7 +629,7 @@ declare namespace gapi.client {
             /** The thumbnail version for use in thumbnail cache invalidation. */
             thumbnailVersion?: string;
             /**
-             * Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file. The trashed item is excluded from all files.list responses
+             * Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner can trash a file. The trashed item is excluded from all files.list responses
              * returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy,
              * download, export, and share the file.
              */
@@ -640,7 +640,7 @@ declare namespace gapi.client {
             trashingUser?: User;
             /** A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the user. */
             version?: string;
-            /** Additional metadata about video media. This may not be available immediately upon upload. */
+            /** Additional metadata about video media. This might not be available immediately upon upload. */
             videoMediaMetadata?: {
                 /** The duration of the video in milliseconds. */
                 durationMillis?: string;
@@ -649,9 +649,9 @@ declare namespace gapi.client {
                 /** The width of the video in pixels. */
                 width?: number;
             };
-            /** Whether the file has been viewed by this user. */
+            /** Whether this user has viewed the file. */
             viewedByMe?: boolean;
-            /** The last time the file was viewed by the user (RFC 3339 date-time). */
+            /** The last time the user viewed the file (RFC 3339 date-time). */
             viewedByMeTime?: string;
             /** Deprecated - use copyRequiresWriterPermission instead. */
             viewersCanCopyContent?: boolean;
@@ -1907,6 +1907,8 @@ declare namespace gapi.client {
             emptyTrash(request?: {
                 /** Data format for the response. */
                 alt?: string;
+                /** If set, empties the trash of the provided shared drive. */
+                driveId?: string;
                 /** Deprecated. If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root. */
                 enforceSingleParent?: boolean;
                 /** Selector specifying which fields to include in a partial response. */
@@ -2203,7 +2205,7 @@ declare namespace gapi.client {
                 userIp?: string;
             },
             body: File): Request<File>;
-            /** Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification. */
+            /** Subscribes to changes to a file. */
             watch(request: {
                 /** Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when alt=media. */
                 acknowledgeAbuse?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.drive-v3",
-  "version": "0.0.20230326",
+  "version": "0.0.20230413",
   "description": "TypeScript typings for Drive API v3",
   "license": "MIT",
   "author": {

package/readme.md

@@ -228,7 +228,7 @@ Updates a file's metadata and/or content. When calling this method, only populat
 await gapi.client.drive.files.update({ fileId: "fileId",  });
 
 /*
-Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification.
+Subscribes to changes to a file.
 */
 await gapi.client.drive.files.watch({ fileId: "fileId",  });
 

package/tests.ts

@@ -3,7 +3,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 
-// Revision: 20230326
+// Revision: 20230413
 
 gapi.load('client', async () => {
     /** now we can use gapi.client */
@@ -929,6 +929,7 @@ gapi.load('client', async () => {
         });
         /** Permanently deletes all of the user's trashed files. */
         await gapi.client.drive.files.emptyTrash({
+            driveId: "Test string",
             enforceSingleParent: true,
         });
         /** Exports a Google Workspace document to the requested MIME type and returns exported byte content. Note that the exported content is limited to 10MB. */
@@ -1298,7 +1299,7 @@ gapi.load('client', async () => {
             webViewLink: "Test string",
             writersCanShare: true,
         });
-        /** Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification. */
+        /** Subscribes to changes to a file. */
         await gapi.client.drive.files.watch({
             acknowledgeAbuse: true,
             fileId: "Test string",