@maxim_mazurok/gapi.client.drive-v3 0.1.20250821 → 0.1.20250829

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: 20250821
+// Revision: 20250829
 
 /// <reference types="gapi.client" />
 
@@ -267,7 +267,7 @@ declare namespace gapi.client {
       readOnly?: boolean;
       /** Reason for why the content of the file is restricted. This is only mutable on requests that also set `readOnly=true`. */
       reason?: string;
-      /** Output only. The user who set the content restriction. Only populated if `readOnly` is true. */
+      /** Output only. The user who set the content restriction. Only populated if `readOnly=true`. */
       restrictingUser?: User;
       /** The time at which the content restriction was set (formatted RFC 3339 timestamp). Only populated if readOnly is true. */
       restrictionTime?: string;
@@ -279,13 +279,13 @@ declare namespace gapi.client {
     interface DownloadRestriction {
       /** Whether download and copy is restricted for readers. */
       restrictedForReaders?: boolean;
-      /** Whether download and copy is restricted for writers. If true, download is also restricted for readers. */
+      /** Whether download and copy is restricted for writers. If `true`, download is also restricted for readers. */
       restrictedForWriters?: boolean;
     }
     interface DownloadRestrictionsMetadata {
       /** Output only. The effective download restriction applied to this file. This considers all restriction settings and DLP rules. */
       effectiveDownloadRestrictionWithContext?: DownloadRestriction;
-      /** The download restriction of the file applied directly by the owner or organizer. This does not take into account shared drive settings or DLP rules. */
+      /** The download restriction of the file applied directly by the owner or organizer. This doesn't take into account shared drive settings or DLP rules. */
       itemDownloadRestriction?: DownloadRestriction;
     }
     interface Drive {
@@ -393,13 +393,13 @@ declare namespace gapi.client {
        * 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.
        */
       appProperties?: {[P in string]: string};
-      /** Output only. Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take. */
+      /** Output only. Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take. For more information, see [Understand file capabilities](https://developers.google.com/workspace/drive/api/guides/manage-sharing#capabilities). */
       capabilities?: {
         /** Output only. Whether the current user is the pending owner of the file. Not populated for shared drive files. */
         canAcceptOwnership?: boolean;
-        /** Output only. Whether the current user can add children to this folder. This is always false when the item is not a folder. */
+        /** Output only. Whether the current user can add children to this folder. This is always `false` when the item isn't a folder. */
         canAddChildren?: boolean;
-        /** Output only. 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 items in shared drives. */
+        /** Output only. 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;
         /** Output only. Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files. */
         canAddMyDriveParent?: boolean;
@@ -407,17 +407,17 @@ declare namespace gapi.client {
         canChangeCopyRequiresWriterPermission?: boolean;
         /** Output only. Whether the current user can change the owner or organizer-applied download restrictions of the file. */
         canChangeItemDownloadRestriction?: boolean;
-        /** Output only. Whether the current user can change the securityUpdateEnabled field on link share metadata. */
+        /** Output only. Whether the current user can change the `securityUpdateEnabled` field on link share metadata. */
         canChangeSecurityUpdateEnabled?: boolean;
         /** Deprecated: Output only. */
         canChangeViewersCanCopyContent?: boolean;
         /** Output only. Whether the current user can comment on this file. */
         canComment?: boolean;
-        /** Output only. 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 not a folder. */
+        /** Output only. 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 if it's not a folder. */
         canCopy?: boolean;
         /** Output only. Whether the current user can delete this file. */
         canDelete?: boolean;
-        /** Output only. 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. */
+        /** Output only. 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 a user can disable inherited permissions. */
         canDisableInheritedPermissions?: boolean;
@@ -427,11 +427,11 @@ declare namespace gapi.client {
         canEdit?: boolean;
         /** Whether a user can re-enable inherited permissions. */
         canEnableInheritedPermissions?: boolean;
-        /** Output only. Whether the current user can list the children of this folder. This is always false when the item is not a folder. */
+        /** Output only. Whether the current user can list the children of this folder. This is always `false` when the item isn't a folder. */
         canListChildren?: boolean;
         /** Output only. Whether the current user can modify the content of this file. */
         canModifyContent?: boolean;
-        /** Deprecated: Output only. Use one of `canModifyEditorContentRestriction`, `canModifyOwnerContentRestriction` or `canRemoveContentRestriction`. */
+        /** Deprecated: Output only. Use one of `canModifyEditorContentRestriction`, `canModifyOwnerContentRestriction`, or `canRemoveContentRestriction`. */
         canModifyContentRestriction?: boolean;
         /** Output only. Whether the current user can add or modify content restrictions on the file which are editor restricted. */
         canModifyEditorContentRestriction?: boolean;
@@ -439,21 +439,21 @@ declare namespace gapi.client {
         canModifyLabels?: boolean;
         /** Output only. Whether the current user can add or modify content restrictions which are owner restricted. */
         canModifyOwnerContentRestriction?: boolean;
-        /** Output only. 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. */
+        /** Output only. 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: Output only. Use `canMoveChildrenOutOfDrive` instead. */
         canMoveChildrenOutOfTeamDrive?: boolean;
-        /** Output only. 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. */
+        /** Output only. Whether the current user can move children of this folder within this drive. This is `false` when the item isn't 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. */
         canMoveChildrenWithinDrive?: boolean;
         /** Deprecated: Output only. Use `canMoveChildrenWithinDrive` instead. */
         canMoveChildrenWithinTeamDrive?: boolean;
         /** Deprecated: Output only. Use `canMoveItemOutOfDrive` instead. */
         canMoveItemIntoTeamDrive?: boolean;
-        /** Output only. 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. */
+        /** Output only. 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's being added. */
         canMoveItemOutOfDrive?: boolean;
         /** Deprecated: Output only. Use `canMoveItemOutOfDrive` instead. */
         canMoveItemOutOfTeamDrive?: boolean;
-        /** Output only. 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. */
+        /** Output only. 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's being added and the parent that is being removed. */
         canMoveItemWithinDrive?: boolean;
         /** Deprecated: Output only. Use `canMoveItemWithinDrive` instead. */
         canMoveItemWithinTeamDrive?: boolean;
@@ -463,13 +463,13 @@ declare namespace gapi.client {
         canReadDrive?: boolean;
         /** Output only. Whether the current user can read the labels on the file. */
         canReadLabels?: boolean;
-        /** Output only. 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 is not a folder, can be read. */
+        /** Output only. 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 if it's not a folder, can be read. */
         canReadRevisions?: boolean;
         /** Deprecated: Output only. Use `canReadDrive` instead. */
         canReadTeamDrive?: boolean;
-        /** Output only. 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 `canTrashChildren` instead. */
+        /** Output only. 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;
-        /** Output only. Whether there is a content restriction on the file that can be removed by the current user. */
+        /** Output only. Whether there's a content restriction on the file that can be removed by the current user. */
         canRemoveContentRestriction?: boolean;
         /** Output only. Whether the current user can remove a parent from the item without adding another parent in the same request. Not populated for shared drive files. */
         canRemoveMyDriveParent?: boolean;
@@ -479,18 +479,18 @@ declare namespace gapi.client {
         canShare?: boolean;
         /** Output only. Whether the current user can move this file to trash. */
         canTrash?: boolean;
-        /** Output only. 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. */
+        /** Output only. 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;
         /** Output only. 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 128KB in length and may contain HTML elements. */
+        /** Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and may contain HTML elements. */
         indexableText?: string;
         /** A thumbnail for the file. This will only be used if Google Drive cannot generate a standard thumbnail. */
         thumbnail?: {
-          /** The thumbnail data encoded with URL-safe Base64 (RFC 4648 section 5). */
+          /** The thumbnail data encoded with URL-safe Base64 ([RFC 4648 section 5](https://datatracker.ietf.org/doc/html/rfc4648#section-5)). */
           image?: string;
           /** The MIME type of the thumbnail. */
           mimeType?: string;
@@ -498,7 +498,7 @@ declare namespace gapi.client {
       };
       /** Restrictions for accessing the content of the file. Only populated if such a restriction exists. */
       contentRestrictions?: ContentRestriction[];
-      /** Whether the options to copy, print, or download this file, should be disabled for readers and commenters. */
+      /** Whether the options to copy, print, or download this file should be disabled for readers and commenters. */
       copyRequiresWriterPermission?: boolean;
       /** The time at which the file was created (RFC 3339 date-time). */
       createdTime?: string;
@@ -514,13 +514,13 @@ declare namespace gapi.client {
       exportLinks?: {[P in string]: string};
       /** Output only. The final component of `fullFileExtension`. This is only available for files with binary content in Google Drive. */
       fileExtension?: string;
-      /** The color for a folder or a shortcut to a folder as an RGB hex string. The supported colors are published in the `folderColorPalette` field of the About resource. If an unsupported color is specified, the closest color in the palette is used instead. */
+      /** The color for a folder or a shortcut to a folder as an RGB hex string. The supported colors are published in the `folderColorPalette` field of the [`about`](/workspace/drive/api/reference/rest/v3/about) resource. If an unsupported color is specified, the closest color in the palette is used instead. */
       folderColorRgb?: string;
-      /** Output only. 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 Drive. This is automatically updated when the `name` field changes, however it is not cleared if the new name does not contain a valid extension. */
+      /** Output only. 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 Drive. This is automatically updated when the `name` field changes, however it's not cleared if the new name doesn't contain a valid extension. */
       fullFileExtension?: string;
       /** Output only. Whether there are permissions directly on this file. This field is only populated for items in shared drives. */
       hasAugmentedPermissions?: boolean;
-      /** Output only. 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. */
+      /** Output only. Whether this file has a thumbnail. This doesn't indicate whether the requesting app has access to the thumbnail. To check access, look for the presence of the thumbnailLink field. */
       hasThumbnail?: boolean;
       /** Output only. The ID of the file's head revision. This is currently only available for files with binary content in Google Drive. */
       headRevisionId?: string;
@@ -602,7 +602,7 @@ declare namespace gapi.client {
       };
       /** Output only. The MD5 checksum for the content of the file. This is only applicable to files with binary content in Google Drive. */
       md5Checksum?: string;
-      /** The MIME type of the file. Google Drive attempts to automatically detect an appropriate value from uploaded content, if no value is provided. The value cannot be changed unless a new revision is uploaded. If a file is created with a Google Doc MIME type, the uploaded content is imported, if possible. The supported import formats are published in the About resource. */
+      /** The MIME type of the file. Google Drive attempts to automatically detect an appropriate value from uploaded content, if no value is provided. The value cannot be changed unless a new revision is uploaded. If a file is created with a Google Doc MIME type, the uploaded content is imported, if possible. The supported import formats are published in the [`about`](/workspace/drive/api/reference/rest/v3/about) resource. */
       mimeType?: string;
       /** Output only. Whether the file has been modified by this user. */
       modifiedByMe?: boolean;
@@ -610,7 +610,7 @@ declare namespace gapi.client {
       modifiedByMeTime?: string;
       /** he last time the file was modified by anyone (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 Application Data folder the name is constant. */
+      /** 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, the My Drive root folder, and the Application Data folder, the name is constant. */
       name?: string;
       /** The original filename of the uploaded content if available, or else the original value of the `name` field. This is only available for files with binary content in Google Drive. */
       originalFilename?: string;
@@ -633,9 +633,9 @@ declare namespace gapi.client {
       quotaBytesUsed?: string;
       /** Output only. A key needed to access the item via a shared link. */
       resourceKey?: string;
-      /** Output only. The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it is not populated for Docs Editors or shortcut files. */
+      /** Output only. 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;
-      /** Output only. The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it is not populated for Docs Editors or shortcut files. */
+      /** Output only. 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;
       /** Output only. Whether the file has been shared. Not populated for items in shared drives. */
       shared?: boolean;
@@ -649,18 +649,18 @@ declare namespace gapi.client {
         targetId?: string;
         /** Output only. The MIME type of the file that this shortcut points to. The value of this field is a snapshot of the target's MIME type, captured when the shortcut is created. */
         targetMimeType?: string;
-        /** Output only. The ResourceKey for the target file. */
+        /** Output only. The `resourceKey` for the target file. */
         targetResourceKey?: string;
       };
-      /** Output only. Size in bytes of blobs and first party editor files. Won't be populated for files that have no size, like shortcuts and folders. */
+      /** Output only. Size in bytes of blobs and Google Workspace editor files. Won't be populated for files that have no size, like shortcuts and folders. */
       size?: string;
-      /** Output only. The list of spaces which contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. */
+      /** Output only. The list of spaces which contain the file. The currently supported values are `drive`, `appDataFolder`, and `photos`. */
       spaces?: string[];
       /** Whether the user has starred the file. */
       starred?: boolean;
       /** Deprecated: Output only. Use `driveId` instead. */
       teamDriveId?: string;
-      /** Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Not intended for direct usage on web applications due to [Cross-Origin Resource Sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) policies, consider using a proxy server. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request. */
+      /** Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Not intended for direct usage on web applications due to [Cross-Origin Resource Sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) policies. Consider using a proxy server. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `files.thumbnailLink` must be fetched using a credentialed request. */
       thumbnailLink?: string;
       /** Output only. The thumbnail version for use in thumbnail cache invalidation. */
       thumbnailVersion?: string;
@@ -695,9 +695,9 @@ declare namespace gapi.client {
       writersCanShare?: boolean;
     }
     interface FileList {
-      /** The list of files. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched. */
+      /** The list of files. If `nextPageToken` is populated, then this list may be incomplete and an additional page of results should be fetched. */
       files?: File[];
-      /** Whether the search process was incomplete. If true, then some search results might be missing, since all documents were not searched. This can occur when searching multiple drives with the 'allDrives' corpora, but all corpora couldn't be searched. When this happens, it's suggested that clients narrow their query by choosing a different corpus such as 'user' or 'drive'. */
+      /** Whether the search process was incomplete. If true, then some search results might be missing, since all documents were not searched. This can occur when searching multiple drives with the `allDrives` corpora, but all corpora couldn't be searched. When this happens, it's suggested that clients narrow their query by choosing a different corpus such as `user` or `drive`. */
       incompleteSearch?: boolean;
       /** Identifies what kind of resource this is. Value: the fixed string `"drive#fileList"`. */
       kind?: string;
@@ -743,7 +743,7 @@ declare namespace gapi.client {
     interface LabelFieldModification {
       /** The ID of the field to be modified. */
       fieldId?: string;
-      /** This is always drive#labelFieldModification. */
+      /** This is always `"drive#labelFieldModification"`. */
       kind?: string;
       /** Replaces the value of a dateString Field with these new values. The string must be in the RFC 3339 full-date format: YYYY-MM-DD. */
       setDateValues?: string[];
@@ -753,13 +753,13 @@ declare namespace gapi.client {
       setSelectionValues?: string[];
       /** Sets the value of a `text` field. */
       setTextValues?: string[];
-      /** Replaces a `user` field with these new values. The values must be valid email addresses. */
+      /** Replaces a `user` field with these new values. The values must be a valid email addresses. */
       setUserValues?: string[];
       /** Unsets the values for this field. */
       unsetValues?: boolean;
     }
     interface LabelList {
-      /** This is always drive#labelList */
+      /** This is always `"drive#labelList"`. */
       kind?: string;
       /** The list of labels. */
       labels?: Label[];
@@ -769,7 +769,7 @@ declare namespace gapi.client {
     interface LabelModification {
       /** The list of modifications to this label's fields. */
       fieldModifications?: LabelFieldModification[];
-      /** This is always drive#labelModification. */
+      /** This is always `"drive#labelModification"`. */
       kind?: string;
       /** The ID of the label to modify. */
       labelId?: string;
@@ -783,13 +783,13 @@ declare namespace gapi.client {
       nextPageToken?: string;
     }
     interface ModifyLabelsRequest {
-      /** This is always drive#modifyLabelsRequest. */
+      /** This is always `"drive#modifyLabelsRequest"`. */
       kind?: string;
       /** The list of modifications to apply to the labels on the file. */
       labelModifications?: LabelModification[];
     }
     interface ModifyLabelsResponse {
-      /** This is always drive#modifyLabelsResponse */
+      /** This is always `"drive#modifyLabelsResponse"`. */
       kind?: string;
       /** The list of labels which were added or updated by the request. */
       modifiedLabels?: Label[];
@@ -2021,7 +2021,7 @@ declare namespace gapi.client {
       ): Request<Drive>;
     }
     interface FilesResource {
-      /** Creates a copy of a file and applies any requested updates with patch semantics. */
+      /** Creates a copy of a file and applies any requested updates with patch semantics. For more information, see [Create and manage files](https://developers.google.com/workspace/drive/api/guides/create-file). */
       copy(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2031,7 +2031,7 @@ declare namespace gapi.client {
         alt?: string;
         /** JSONP */
         callback?: string;
-        /** Deprecated. Copying files into multiple folders is no longer supported. Use shortcuts instead. */
+        /** Deprecated: Copying files into multiple folders is no longer supported. Use shortcuts instead. */
         enforceSingleParent?: boolean;
         /** Selector specifying which fields to include in a partial response. */
         fields?: string;
@@ -2041,9 +2041,9 @@ declare namespace gapi.client {
         ignoreDefaultVisibility?: boolean;
         /** A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. */
         includeLabels?: string;
-        /** Specifies which additional view's permissions to include in the response. Only 'published' is supported. */
+        /** Specifies which additional view's permissions to include in the response. Only `published` is supported. */
         includePermissionsForView?: string;
-        /** Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions. */
+        /** Whether to set the `keepForever` field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions. */
         keepRevisionForever?: boolean;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
@@ -2076,7 +2076,7 @@ declare namespace gapi.client {
           alt?: string;
           /** JSONP */
           callback?: string;
-          /** Deprecated. Copying files into multiple folders is no longer supported. Use shortcuts instead. */
+          /** Deprecated: Copying files into multiple folders is no longer supported. Use shortcuts instead. */
           enforceSingleParent?: boolean;
           /** Selector specifying which fields to include in a partial response. */
           fields?: string;
@@ -2086,9 +2086,9 @@ declare namespace gapi.client {
           ignoreDefaultVisibility?: boolean;
           /** A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. */
           includeLabels?: string;
-          /** Specifies which additional view's permissions to include in the response. Only 'published' is supported. */
+          /** Specifies which additional view's permissions to include in the response. Only `published` is supported. */
           includePermissionsForView?: string;
-          /** Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions. */
+          /** Whether to set the `keepForever` field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions. */
           keepRevisionForever?: boolean;
           /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
           key?: string;
@@ -2111,7 +2111,7 @@ declare namespace gapi.client {
         },
         body: File,
       ): Request<File>;
-      /** Creates a new file. This method supports an *‍/upload* URI and accepts uploaded media with the following characteristics: - *Maximum file size:* 5,120 GB - *Accepted Media MIME types:*`*‍/*` Note: Specify a valid MIME type, rather than the literal `*‍/*` value. The literal `*‍/*` is only used to indicate that any valid MIME type can be uploaded. For more information on uploading files, see [Upload file data](/workspace/drive/api/guides/manage-uploads). Apps creating shortcuts with `files.create` must specify the MIME type `application/vnd.google-apps.shortcut`. Apps should specify a file extension in the `name` property when inserting files with the API. For example, an operation to insert a JPEG file should specify something like `"name": "cat.jpg"` in the metadata. Subsequent `GET` requests include the read-only `fileExtension` property populated with the extension originally specified in the `title` property. When a Google Drive user requests to download a file, or when the file is downloaded through the sync client, Drive builds a full filename (with extension) based on the title. In cases where the extension is missing, Drive attempts to determine the extension based on the file's MIME type. */
+      /** Creates a file. For more information, see [Create and manage files](/workspace/drive/api/guides/create-file). This method supports an *‍/upload* URI and accepts uploaded media with the following characteristics: - *Maximum file size:* 5,120 GB - *Accepted Media MIME types:* `*‍/*` (Specify a valid MIME type, rather than the literal `*‍/*` value. The literal `*‍/*` is only used to indicate that any valid MIME type can be uploaded. For more information, see [Google Workspace and Google Drive supported MIME types](/workspace/drive/api/guides/mime-types).) For more information on uploading files, see [Upload file data](/workspace/drive/api/guides/manage-uploads). Apps creating shortcuts with the `create` method must specify the MIME type `application/vnd.google-apps.shortcut`. Apps should specify a file extension in the `name` property when inserting files with the API. For example, an operation to insert a JPEG file should specify something like `"name": "cat.jpg"` in the metadata. Subsequent `GET` requests include the read-only `fileExtension` property populated with the extension originally specified in the `name` property. When a Google Drive user requests to download a file, or when the file is downloaded through the sync client, Drive builds a full filename (with extension) based on the name. In cases where the extension is missing, Drive attempts to determine the extension based on the file's MIME type. */
       create(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2121,7 +2121,7 @@ declare namespace gapi.client {
         alt?: string;
         /** JSONP */
         callback?: string;
-        /** Deprecated. Creating files in multiple folders is no longer supported. */
+        /** Deprecated: Creating files in multiple folders is no longer supported. */
         enforceSingleParent?: boolean;
         /** Selector specifying which fields to include in a partial response. */
         fields?: string;
@@ -2129,9 +2129,9 @@ declare namespace gapi.client {
         ignoreDefaultVisibility?: boolean;
         /** A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. */
         includeLabels?: string;
-        /** Specifies which additional view's permissions to include in the response. Only 'published' is supported. */
+        /** Specifies which additional view's permissions to include in the response. Only `published` is supported. */
         includePermissionsForView?: string;
-        /** Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions. */
+        /** Whether to set the `keepForever` field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions. */
         keepRevisionForever?: boolean;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
@@ -2166,7 +2166,7 @@ declare namespace gapi.client {
           alt?: string;
           /** JSONP */
           callback?: string;
-          /** Deprecated. Creating files in multiple folders is no longer supported. */
+          /** Deprecated: Creating files in multiple folders is no longer supported. */
           enforceSingleParent?: boolean;
           /** Selector specifying which fields to include in a partial response. */
           fields?: string;
@@ -2174,9 +2174,9 @@ declare namespace gapi.client {
           ignoreDefaultVisibility?: boolean;
           /** A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. */
           includeLabels?: string;
-          /** Specifies which additional view's permissions to include in the response. Only 'published' is supported. */
+          /** Specifies which additional view's permissions to include in the response. Only `published` is supported. */
           includePermissionsForView?: string;
-          /** Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions. */
+          /** Whether to set the `keepForever` field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions. */
           keepRevisionForever?: boolean;
           /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
           key?: string;
@@ -2201,7 +2201,7 @@ declare namespace gapi.client {
         },
         body: File,
       ): Request<File>;
-      /** Permanently deletes a file owned by the user without moving it to the trash. If the file belongs to a shared drive, the user must be an `organizer` on the parent folder. If the target is a folder, all descendants owned by the user are also deleted. */
+      /** Permanently deletes a file owned by the user without moving it to the trash. For more information, see [Trash or delete files and folders](https://developers.google.com/workspace/drive/api/guides/delete). If the file belongs to a shared drive, the user must be an `organizer` on the parent folder. If the target is a folder, all descendants owned by the user are also deleted. */
       delete(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2211,7 +2211,7 @@ declare namespace gapi.client {
         alt?: string;
         /** JSONP */
         callback?: 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. */
+        /** Deprecated: If an item isn't in a shared drive and its last parent is deleted but the item itself isn't, the item will be placed under its owner's root. */
         enforceSingleParent?: boolean;
         /** Selector specifying which fields to include in a partial response. */
         fields?: string;
@@ -2234,7 +2234,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<void>;
-      /** Downloads content of a file. Operations are valid for 24 hours from the time of creation. */
+      /** Downloads the content of a file. For more information, see [Download and export files](https://developers.google.com/workspace/drive/api/guides/manage-downloads). Operations are valid for 24 hours from the time of creation. */
       download(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2250,7 +2250,7 @@ declare namespace gapi.client {
         fileId: string;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
-        /** Optional. The MIME type the file should be downloaded as. This field can only be set when downloading Google Workspace documents. See [Export MIME types for Google Workspace documents](/drive/api/guides/ref-export-formats) for the list of supported MIME types. If not set, a Google Workspace document is downloaded with a default MIME type. The default MIME type might change in the future. */
+        /** Optional. The MIME type the file should be downloaded as. This field can only be set when downloading Google Workspace documents. For a list of supported MIME types, see [Export MIME types for Google Workspace documents](/workspace/drive/api/guides/ref-export-formats). If not set, a Google Workspace document is downloaded with a default MIME type. The default MIME type might change in the future. */
         mimeType?: string;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
@@ -2265,7 +2265,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<Operation>;
-      /** Permanently deletes all of the user's trashed files. */
+      /** Permanently deletes all of the user's trashed files. For more information, see [Trash or delete files and folders](https://developers.google.com/workspace/drive/api/guides/delete). */
       emptyTrash(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2277,7 +2277,7 @@ declare namespace gapi.client {
         callback?: 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. */
+        /** Deprecated: If an item isn't in a shared drive and its last parent is deleted but the item itself isn't, the item will be placed under its owner's root. */
         enforceSingleParent?: boolean;
         /** Selector specifying which fields to include in a partial response. */
         fields?: string;
@@ -2294,7 +2294,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<void>;
-      /** Exports a Google Workspace document to the requested MIME type and returns exported byte content. Note that the exported content is limited to 10MB. */
+      /** Exports a Google Workspace document to the requested MIME type and returns exported byte content. For more information, see [Download and export files](https://developers.google.com/workspace/drive/api/guides/manage-downloads). Note that the exported content is limited to 10 MB. */
       export(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2310,7 +2310,7 @@ declare namespace gapi.client {
         fileId: string;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
-        /** Required. The MIME type of the format requested for this export. */
+        /** Required. The MIME type of the format requested for this export. For a list of supported MIME types, see [Export MIME types for Google Workspace documents](/workspace/drive/api/guides/ref-export-formats). */
         mimeType: string;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
@@ -2323,7 +2323,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<void>;
-      /** Generates a set of file IDs which can be provided in create or copy requests. */
+      /** Generates a set of file IDs which can be provided in create or copy requests. For more information, see [Create and manage files](https://developers.google.com/workspace/drive/api/guides/create-file). */
       generateIds(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2345,16 +2345,16 @@ declare namespace gapi.client {
         prettyPrint?: boolean;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** The space in which the IDs can be used to create new files. Supported values are 'drive' and 'appDataFolder'. (Default: 'drive') */
+        /** The space in which the IDs can be used to create files. Supported values are `drive` and `appDataFolder`. (Default: `drive`.) For more information, see [File organization](https://developers.google.com/workspace/drive/api/guides/about-files#file-organization). */
         space?: string;
-        /** The type of items which the IDs can be used for. Supported values are 'files' and 'shortcuts'. Note that 'shortcuts' are only supported in the `drive` 'space'. (Default: 'files') */
+        /** The type of items which the IDs can be used for. Supported values are `files` and `shortcuts`. Note that `shortcuts` are only supported in the `drive` `space`. (Default: `files`.) For more information, see [File organization](https://developers.google.com/workspace/drive/api/guides/about-files#file-organization). */
         type?: string;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<GeneratedIds>;
-      /** 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`](/workspace/drive/api/reference/rest/v3/files/export) instead. For more information, see [Download & export files](/workspace/drive/api/guides/manage-downloads). */
+      /** Gets a file's metadata or content by ID. For more information, see [Search for files and folders](/workspace/drive/api/guides/search-files). 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`](/workspace/drive/api/reference/rest/v3/files/export) instead. For more information, see [Download and export files](/workspace/drive/api/guides/manage-downloads). */
       get(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2372,7 +2372,7 @@ declare namespace gapi.client {
         fileId: string;
         /** A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. */
         includeLabels?: string;
-        /** Specifies which additional view's permissions to include in the response. Only 'published' is supported. */
+        /** Specifies which additional view's permissions to include in the response. Only `published` is supported. */
         includePermissionsForView?: string;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
@@ -2391,7 +2391,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<File>;
-      /** Lists the user's files. This method accepts the `q` parameter, which is a search query combining one or more search terms. For more information, see the [Search for files & folders](/workspace/drive/api/guides/search-files) guide. *Note:* This method returns *all* files by default, including trashed files. If you don't want trashed files to appear in the list, use the `trashed=false` query parameter to remove trashed files from the results. */
+      /** Lists the user's files. For more information, see [Search for files and folders](/workspace/drive/api/guides/search-files). This method accepts the `q` parameter, which is a search query combining one or more search terms. This method returns *all* files by default, including trashed files. If you don't want trashed files to appear in the list, use the `trashed=false` query parameter to remove trashed files from the results. */
       list(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2401,9 +2401,9 @@ declare namespace gapi.client {
         alt?: string;
         /** JSONP */
         callback?: string;
-        /** Bodies of items (files/documents) to which the query applies. Supported bodies are 'user', 'domain', 'drive', and 'allDrives'. Prefer 'user' or 'drive' to 'allDrives' for efficiency. By default, corpora is set to 'user'. However, this can change depending on the filter set through the 'q' parameter. */
+        /** Bodies of items (files or documents) to which the query applies. Supported bodies are: * `user` * `domain` * `drive` * `allDrives` Prefer `user` or `drive` to `allDrives` for efficiency. By default, corpora is set to `user`. However, this can change depending on the filter set through the `q` parameter. For more information, see [File organization](https://developers.google.com/workspace/drive/api/guides/about-files#file-organization). */
         corpora?: string;
-        /** Deprecated: The source of files to list. Use 'corpora' instead. */
+        /** Deprecated: The source of files to list. Use `corpora` instead. */
         corpus?: string;
         /** ID of the shared drive to search. */
         driveId?: string;
@@ -2413,7 +2413,7 @@ declare namespace gapi.client {
         includeItemsFromAllDrives?: boolean;
         /** A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. */
         includeLabels?: string;
-        /** Specifies which additional view's permissions to include in the response. Only 'published' is supported. */
+        /** Specifies which additional view's permissions to include in the response. Only `published` is supported. */
         includePermissionsForView?: string;
         /** Deprecated: Use `includeItemsFromAllDrives` instead. */
         includeTeamDriveItems?: boolean;
@@ -2421,19 +2421,19 @@ declare namespace gapi.client {
         key?: string;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
-        /** A comma-separated list of sort keys. Valid keys are: * `createdTime`: When the file was created. * `folder`: The folder ID. This field is sorted using alphabetical ordering. * `modifiedByMeTime`: The last time the file was modified by the user. * `modifiedTime`: The last time the file was modified by anyone. * `name`: The name of the file. This field is sorted using alphabetical ordering, so 1, 12, 2, 22. * `name_natural`: The name of the file. This field is sorted using natural sort ordering, so 1, 2, 12, 22. * `quotaBytesUsed`: The number of storage quota bytes used by the file. * `recency`: The most recent timestamp from the file's date-time fields. * `sharedWithMeTime`: When the file was shared with the user, if applicable. * `starred`: Whether the user has starred the file. * `viewedByMeTime`: The last time the file was viewed by the user. Each key sorts ascending by default, but can be reversed with the 'desc' modifier. Example usage: `?orderBy=folder,modifiedTime desc,name`. */
+        /** A comma-separated list of sort keys. Valid keys are: * `createdTime`: When the file was created. * `folder`: The folder ID. This field is sorted using alphabetical ordering. * `modifiedByMeTime`: The last time the file was modified by the user. * `modifiedTime`: The last time the file was modified by anyone. * `name`: The name of the file. This field is sorted using alphabetical ordering, so 1, 12, 2, 22. * `name_natural`: The name of the file. This field is sorted using natural sort ordering, so 1, 2, 12, 22. * `quotaBytesUsed`: The number of storage quota bytes used by the file. * `recency`: The most recent timestamp from the file's date-time fields. * `sharedWithMeTime`: When the file was shared with the user, if applicable. * `starred`: Whether the user has starred the file. * `viewedByMeTime`: The last time the file was viewed by the user. Each key sorts ascending by default, but can be reversed with the `desc` modifier. Example usage: `?orderBy=folder,modifiedTime desc,name`. */
         orderBy?: string;
         /** The maximum number of files to return per page. Partial or empty result pages are possible even before the end of the files list has been reached. */
         pageSize?: number;
-        /** The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response. */
+        /** The token for continuing a previous list request on the next page. This should be set to the value of `nextPageToken` from the previous response. */
         pageToken?: string;
         /** Returns response with indentations and line breaks. */
         prettyPrint?: boolean;
-        /** A query for filtering the file results. See the "Search for files & folders" guide for supported syntax. */
+        /** A query for filtering the file results. For supported syntax, see [Search for files and folders](/workspace/drive/api/guides/search-files). */
         q?: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'. */
+        /** A comma-separated list of spaces to query within the corpora. Supported values are `drive` and `appDataFolder`. For more information, see [File organization](https://developers.google.com/workspace/drive/api/guides/about-files#file-organization). */
         spaces?: string;
         /** Whether the requesting application supports both My Drives and shared drives. */
         supportsAllDrives?: boolean;
@@ -2446,7 +2446,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<FileList>;
-      /** Lists the labels on a file. */
+      /** Lists the labels on a file. For more information, see [List labels on a file](https://developers.google.com/workspace/drive/api/guides/list-labels). */
       listLabels(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2466,7 +2466,7 @@ declare namespace gapi.client {
         maxResults?: number;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
-        /** The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response. */
+        /** The token for continuing a previous list request on the next page. This should be set to the value of `nextPageToken` from the previous response. */
         pageToken?: string;
         /** Returns response with indentations and line breaks. */
         prettyPrint?: boolean;
@@ -2477,7 +2477,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<LabelList>;
-      /** Modifies the set of labels applied to a file. Returns a list of the labels that were added or modified. */
+      /** Modifies the set of labels applied to a file. For more information, see [Set a label field on a file](https://developers.google.com/workspace/drive/api/guides/set-label). Returns a list of the labels that were added or modified. */
       modifyLabels(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2535,7 +2535,7 @@ declare namespace gapi.client {
         },
         body: ModifyLabelsRequest,
       ): Request<ModifyLabelsResponse>;
-      /** Updates a file's metadata and/or content. When calling this method, only populate fields in the request that you want to modify. When updating fields, some fields might be changed automatically, such as `modifiedDate`. This method supports patch semantics. This method supports an *‍/upload* URI and accepts uploaded media with the following characteristics: - *Maximum file size:* 5,120 GB - *Accepted Media MIME types:*`*‍/*` Note: Specify a valid MIME type, rather than the literal `*‍/*` value. The literal `*‍/*` is only used to indicate that any valid MIME type can be uploaded. For more information on uploading files, see [Upload file data](/workspace/drive/api/guides/manage-uploads). */
+      /** Updates a file's metadata, content, or both. When calling this method, only populate fields in the request that you want to modify. When updating fields, some fields might be changed automatically, such as `modifiedDate`. This method supports patch semantics. This method supports an *‍/upload* URI and accepts uploaded media with the following characteristics: - *Maximum file size:* 5,120 GB - *Accepted Media MIME types:* `*‍/*` (Specify a valid MIME type, rather than the literal `*‍/*` value. The literal `*‍/*` is only used to indicate that any valid MIME type can be uploaded. For more information, see [Google Workspace and Google Drive supported MIME types](/workspace/drive/api/guides/mime-types).) For more information on uploading files, see [Upload file data](/workspace/drive/api/guides/manage-uploads). */
       update(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2555,9 +2555,9 @@ declare namespace gapi.client {
         fileId: string;
         /** A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. */
         includeLabels?: string;
-        /** Specifies which additional view's permissions to include in the response. Only 'published' is supported. */
+        /** Specifies which additional view's permissions to include in the response. Only `published` is supported. */
         includePermissionsForView?: string;
-        /** Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions. */
+        /** Whether to set the `keepForever` field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions. */
         keepRevisionForever?: boolean;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
@@ -2604,9 +2604,9 @@ declare namespace gapi.client {
           fileId: string;
           /** A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. */
           includeLabels?: string;
-          /** Specifies which additional view's permissions to include in the response. Only 'published' is supported. */
+          /** Specifies which additional view's permissions to include in the response. Only `published` is supported. */
           includePermissionsForView?: string;
-          /** Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions. */
+          /** Whether to set the `keepForever` field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions. */
           keepRevisionForever?: boolean;
           /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
           key?: string;
@@ -2633,7 +2633,7 @@ declare namespace gapi.client {
         },
         body: File,
       ): Request<File>;
-      /** Subscribes to changes to a file. */
+      /** Subscribes to changes to a file. For more information, see [Notifications for resource changes](https://developers.google.com/workspace/drive/api/guides/push). */
       watch(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2651,7 +2651,7 @@ declare namespace gapi.client {
         fileId: string;
         /** A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. */
         includeLabels?: string;
-        /** Specifies which additional view's permissions to include in the response. Only 'published' is supported. */
+        /** Specifies which additional view's permissions to include in the response. Only `published` is supported. */
         includePermissionsForView?: string;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
@@ -2690,7 +2690,7 @@ declare namespace gapi.client {
           fileId: string;
           /** A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. */
           includeLabels?: string;
-          /** Specifies which additional view's permissions to include in the response. Only 'published' is supported. */
+          /** Specifies which additional view's permissions to include in the response. Only `published` is supported. */
           includePermissionsForView?: string;
           /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
           key?: string;
@@ -2772,7 +2772,7 @@ declare namespace gapi.client {
         prettyPrint?: boolean;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Whether to send a notification email when sharing to users or groups. This defaults to true for users and groups, and is not allowed for other requests. It must not be disabled for ownership transfers. */
+        /** Whether to send a notification email when sharing to users or groups. This defaults to `true` for users and groups, and is not allowed for other requests. It must not be disabled for ownership transfers. */
         sendNotificationEmail?: boolean;
         /** Whether the requesting application supports both My Drives and shared drives. */
         supportsAllDrives?: boolean;
@@ -2819,7 +2819,7 @@ declare namespace gapi.client {
           prettyPrint?: boolean;
           /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
           quotaUser?: string;
-          /** Whether to send a notification email when sharing to users or groups. This defaults to true for users and groups, and is not allowed for other requests. It must not be disabled for ownership transfers. */
+          /** Whether to send a notification email when sharing to users or groups. This defaults to `true` for users and groups, and is not allowed for other requests. It must not be disabled for ownership transfers. */
           sendNotificationEmail?: boolean;
           /** Whether the requesting application supports both My Drives and shared drives. */
           supportsAllDrives?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.drive-v3",
-  "version": "0.1.20250821",
+  "version": "0.1.20250829",
   "description": "TypeScript typings for Google Drive API v3",
   "repository": {
     "type": "git",

package/readme.md

@@ -208,67 +208,67 @@ Updates the metadata for a shared drive. For more information, see [Manage share
 await gapi.client.drive.drives.update({ driveId: "driveId",  });
 
 /*
-Creates a copy of a file and applies any requested updates with patch semantics.
+Creates a copy of a file and applies any requested updates with patch semantics. For more information, see [Create and manage files](https://developers.google.com/workspace/drive/api/guides/create-file).
 */
 await gapi.client.drive.files.copy({ fileId: "fileId",  });
 
 /*
- Creates a new file. This method supports an */upload* URI and accepts uploaded media with the following characteristics: - *Maximum file size:* 5,120 GB - *Accepted Media MIME types:*`*/*` Note: Specify a valid MIME type, rather than the literal `*/*` value. The literal `*/*` is only used to indicate that any valid MIME type can be uploaded. For more information on uploading files, see [Upload file data](/workspace/drive/api/guides/manage-uploads). Apps creating shortcuts with `files.create` must specify the MIME type `application/vnd.google-apps.shortcut`. Apps should specify a file extension in the `name` property when inserting files with the API. For example, an operation to insert a JPEG file should specify something like `"name": "cat.jpg"` in the metadata. Subsequent `GET` requests include the read-only `fileExtension` property populated with the extension originally specified in the `title` property. When a Google Drive user requests to download a file, or when the file is downloaded through the sync client, Drive builds a full filename (with extension) based on the title. In cases where the extension is missing, Drive attempts to determine the extension based on the file's MIME type.
+ Creates a file. For more information, see [Create and manage files](/workspace/drive/api/guides/create-file). This method supports an */upload* URI and accepts uploaded media with the following characteristics: - *Maximum file size:* 5,120 GB - *Accepted Media MIME types:* `*/*` (Specify a valid MIME type, rather than the literal `*/*` value. The literal `*/*` is only used to indicate that any valid MIME type can be uploaded. For more information, see [Google Workspace and Google Drive supported MIME types](/workspace/drive/api/guides/mime-types).) For more information on uploading files, see [Upload file data](/workspace/drive/api/guides/manage-uploads). Apps creating shortcuts with the `create` method must specify the MIME type `application/vnd.google-apps.shortcut`. Apps should specify a file extension in the `name` property when inserting files with the API. For example, an operation to insert a JPEG file should specify something like `"name": "cat.jpg"` in the metadata. Subsequent `GET` requests include the read-only `fileExtension` property populated with the extension originally specified in the `name` property. When a Google Drive user requests to download a file, or when the file is downloaded through the sync client, Drive builds a full filename (with extension) based on the name. In cases where the extension is missing, Drive attempts to determine the extension based on the file's MIME type.
 */
 await gapi.client.drive.files.create({  });
 
 /*
-Permanently deletes a file owned by the user without moving it to the trash. If the file belongs to a shared drive, the user must be an `organizer` on the parent folder. If the target is a folder, all descendants owned by the user are also deleted.
+Permanently deletes a file owned by the user without moving it to the trash. For more information, see [Trash or delete files and folders](https://developers.google.com/workspace/drive/api/guides/delete). If the file belongs to a shared drive, the user must be an `organizer` on the parent folder. If the target is a folder, all descendants owned by the user are also deleted.
 */
 await gapi.client.drive.files.delete({ fileId: "fileId",  });
 
 /*
-Downloads content of a file. Operations are valid for 24 hours from the time of creation.
+Downloads the content of a file. For more information, see [Download and export files](https://developers.google.com/workspace/drive/api/guides/manage-downloads). Operations are valid for 24 hours from the time of creation.
 */
 await gapi.client.drive.files.download({ fileId: "fileId",  });
 
 /*
-Permanently deletes all of the user's trashed files.
+Permanently deletes all of the user's trashed files. For more information, see [Trash or delete files and folders](https://developers.google.com/workspace/drive/api/guides/delete).
 */
 await gapi.client.drive.files.emptyTrash({  });
 
 /*
-Exports a Google Workspace document to the requested MIME type and returns exported byte content. Note that the exported content is limited to 10MB.
+Exports a Google Workspace document to the requested MIME type and returns exported byte content. For more information, see [Download and export files](https://developers.google.com/workspace/drive/api/guides/manage-downloads). Note that the exported content is limited to 10 MB.
 */
 await gapi.client.drive.files.export({ fileId: "fileId", mimeType: "mimeType",  });
 
 /*
-Generates a set of file IDs which can be provided in create or copy requests.
+Generates a set of file IDs which can be provided in create or copy requests. For more information, see [Create and manage files](https://developers.google.com/workspace/drive/api/guides/create-file).
 */
 await gapi.client.drive.files.generateIds({  });
 
 /*
- 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`](/workspace/drive/api/reference/rest/v3/files/export) instead. For more information, see [Download & export files](/workspace/drive/api/guides/manage-downloads).
+ Gets a file's metadata or content by ID. For more information, see [Search for files and folders](/workspace/drive/api/guides/search-files). 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`](/workspace/drive/api/reference/rest/v3/files/export) instead. For more information, see [Download and export files](/workspace/drive/api/guides/manage-downloads).
 */
 await gapi.client.drive.files.get({ fileId: "fileId",  });
 
 /*
- Lists the user's files. This method accepts the `q` parameter, which is a search query combining one or more search terms. For more information, see the [Search for files & folders](/workspace/drive/api/guides/search-files) guide. *Note:* This method returns *all* files by default, including trashed files. If you don't want trashed files to appear in the list, use the `trashed=false` query parameter to remove trashed files from the results.
+ Lists the user's files. For more information, see [Search for files and folders](/workspace/drive/api/guides/search-files). This method accepts the `q` parameter, which is a search query combining one or more search terms. This method returns *all* files by default, including trashed files. If you don't want trashed files to appear in the list, use the `trashed=false` query parameter to remove trashed files from the results.
 */
 await gapi.client.drive.files.list({  });
 
 /*
-Lists the labels on a file.
+Lists the labels on a file. For more information, see [List labels on a file](https://developers.google.com/workspace/drive/api/guides/list-labels).
 */
 await gapi.client.drive.files.listLabels({ fileId: "fileId",  });
 
 /*
-Modifies the set of labels applied to a file. Returns a list of the labels that were added or modified.
+Modifies the set of labels applied to a file. For more information, see [Set a label field on a file](https://developers.google.com/workspace/drive/api/guides/set-label). Returns a list of the labels that were added or modified.
 */
 await gapi.client.drive.files.modifyLabels({ fileId: "fileId",  });
 
 /*
- Updates a file's metadata and/or content. When calling this method, only populate fields in the request that you want to modify. When updating fields, some fields might be changed automatically, such as `modifiedDate`. This method supports patch semantics. This method supports an */upload* URI and accepts uploaded media with the following characteristics: - *Maximum file size:* 5,120 GB - *Accepted Media MIME types:*`*/*` Note: Specify a valid MIME type, rather than the literal `*/*` value. The literal `*/*` is only used to indicate that any valid MIME type can be uploaded. For more information on uploading files, see [Upload file data](/workspace/drive/api/guides/manage-uploads).
+ Updates a file's metadata, content, or both. When calling this method, only populate fields in the request that you want to modify. When updating fields, some fields might be changed automatically, such as `modifiedDate`. This method supports patch semantics. This method supports an */upload* URI and accepts uploaded media with the following characteristics: - *Maximum file size:* 5,120 GB - *Accepted Media MIME types:* `*/*` (Specify a valid MIME type, rather than the literal `*/*` value. The literal `*/*` is only used to indicate that any valid MIME type can be uploaded. For more information, see [Google Workspace and Google Drive supported MIME types](/workspace/drive/api/guides/mime-types).) For more information on uploading files, see [Upload file data](/workspace/drive/api/guides/manage-uploads).
 */
 await gapi.client.drive.files.update({ fileId: "fileId",  });
 
 /*
-Subscribes to changes to a file.
+Subscribes to changes to a file. For more information, see [Notifications for resource changes](https://developers.google.com/workspace/drive/api/guides/push).
 */
 await gapi.client.drive.files.watch({ fileId: "fileId",  });