@maxim_mazurok/gapi.client.drive-v3 0.1.20251007 → 0.1.20251024

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: 20251007
+// Revision: 20251024
 
 /// <reference types="gapi.client" />
 
@@ -224,6 +224,8 @@ declare namespace gapi.client {
     interface Comment {
       /** A region of the document represented as a JSON string. For details on defining anchor properties, refer to [Manage comments and replies](https://developers.google.com/workspace/drive/api/v3/manage-comments). */
       anchor?: string;
+      /** Output only. The email of the user who is assigned to this comment, if none is assigned this will be unset. */
+      assigneeEmailAddress?: string;
       /** Output only. The author of the comment. The author's email address and permission ID will not be populated. */
       author?: User;
       /** The plain text content of the comment. This field is used for setting the content, while `htmlContent` should be displayed. */
@@ -238,6 +240,8 @@ declare namespace gapi.client {
       id?: string;
       /** Output only. Identifies what kind of resource this is. Value: the fixed string `"drive#comment"`. */
       kind?: string;
+      /** Output only. The emails of the users who were mentioned in this comment, if none were mentioned this will be an empty list. */
+      mentionedEmailAddresses?: string[];
       /** The last time the comment or any of its replies was modified (RFC 3339 date-time). */
       modifiedTime?: string;
       /** The file content to which the comment refers, typically within the anchor region. For a text file, for example, this would be the text at the location of the comment. */
@@ -809,9 +813,9 @@ declare namespace gapi.client {
     interface Permission {
       /** Whether the permission allows the file to be discovered through search. This is only applicable for permissions of type `domain` or `anyone`. */
       allowFileDiscovery?: boolean;
-      /** Output only. Whether the account associated with this permission has been deleted. This field only pertains to user and group permissions. */
+      /** Output only. Whether the account associated with this permission has been deleted. This field only pertains to permissions of type `user` or `group`. */
       deleted?: boolean;
-      /** Output only. The "pretty" name of the value of the permission. The following is a list of examples for each type of permission: * `user` - User's full name, as defined for their Google account, such as "Joe Smith." * `group` - Name of the Google Group, such as "The Company Administrators." * `domain` - String domain name, such as "thecompany.com." * `anyone` - No `displayName` is present. */
+      /** Output only. The "pretty" name of the value of the permission. The following is a list of examples for each type of permission: * `user` - User's full name, as defined for their Google Account, such as "Dana A." * `group` - Name of the Google Group, such as "The Company Administrators." * `domain` - String domain name, such as "cymbalgroup.com." * `anyone` - No `displayName` is present. */
       displayName?: string;
       /** The domain to which this permission refers. */
       domain?: string;
@@ -819,28 +823,28 @@ declare namespace gapi.client {
       emailAddress?: string;
       /** The time at which this permission will expire (RFC 3339 date-time). Expiration times have the following restrictions: - They can only be set on user and group permissions - The time must be in the future - The time cannot be more than a year in the future */
       expirationTime?: string;
-      /** Output only. The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as `permissionId`. IDs should be treated as opaque values. */
+      /** Output only. The ID of this permission. This is a unique identifier for the grantee, and is published in the [User resource](https://developers.google.com/workspace/drive/api/reference/rest/v3/User) as `permissionId`. IDs should be treated as opaque values. */
       id?: string;
-      /** When true, only organizers, owners, and users with permissions added directly on the item can access it. */
+      /** When `true`, only organizers, owners, and users with permissions added directly on the item can access it. */
       inheritedPermissionsDisabled?: boolean;
       /** Output only. Identifies what kind of resource this is. Value: the fixed string `"drive#permission"`. */
       kind?: string;
-      /** Whether the account associated with this permission is a pending owner. Only populated for `user` type permissions for files that are not in a shared drive. */
+      /** Whether the account associated with this permission is a pending owner. Only populated for permissions of type `user` for files that aren't in a shared drive. */
       pendingOwner?: boolean;
-      /** Output only. Details of whether the permissions on this item are inherited or directly on this item. */
+      /** Output only. Details of whether the permissions on this item are inherited or are directly on this item. */
       permissionDetails?: Array<{
         /** Output only. Whether this permission is inherited. This field is always populated. This is an output-only field. */
         inherited?: boolean;
         /** Output only. The ID of the item from which this permission is inherited. This is only populated for items in shared drives. */
         inheritedFrom?: string;
-        /** Output only. The permission type for this user. While new values may be added in future, the following are currently possible: * `file` * `member` */
+        /** Output only. The permission type for this user. Supported values include: * `file` * `member` */
         permissionType?: string;
-        /** Output only. The primary role for this user. While new values may be added in the future, the following are currently possible: * `owner` * `organizer` * `fileOrganizer` * `writer` * `commenter` * `reader` */
+        /** Output only. The primary role for this user. Supported values include: * `owner` * `organizer` * `fileOrganizer` * `writer` * `commenter` * `reader` For more information, see [Roles and permissions](https://developers.google.com/workspace/drive/api/guides/ref-roles). */
         role?: string;
       }>;
       /** Output only. A link to the user's profile photo, if available. */
       photoLink?: string;
-      /** The role granted by this permission. While new values may be supported in the future, the following are currently allowed: * `owner` * `organizer` * `fileOrganizer` * `writer` * `commenter` * `reader` */
+      /** The role granted by this permission. Supported values include: * `owner` * `organizer` * `fileOrganizer` * `writer` * `commenter` * `reader` For more information, see [Roles and permissions](https://developers.google.com/workspace/drive/api/guides/ref-roles). */
       role?: string;
       /** Output only. Deprecated: Output only. Use `permissionDetails` instead. */
       teamDrivePermissionDetails?: Array<{
@@ -853,9 +857,9 @@ declare namespace gapi.client {
         /** Deprecated: Output only. Use `permissionDetails/permissionType` instead. */
         teamDrivePermissionType?: string;
       }>;
-      /** The type of the grantee. Valid values are: * `user` * `group` * `domain` * `anyone` When creating a permission, if `type` is `user` or `group`, you must provide an `emailAddress` for the user or group. When `type` is `domain`, you must provide a `domain`. There isn't extra information required for an `anyone` type. */
+      /** The type of the grantee. Supported values include: * `user` * `group` * `domain` * `anyone` When creating a permission, if `type` is `user` or `group`, you must provide an `emailAddress` for the user or group. If `type` is `domain`, you must provide a `domain`. If `type` is `anyone`, no extra information is required. */
       type?: string;
-      /** Indicates the view for this permission. Only populated for permissions that belong to a view. published and metadata are the only supported values. - published: The permission's role is published_reader. - metadata: The item is only visible to the metadata view because the item has limited access and the scope has at least read access to the parent. Note: The metadata view is currently only supported on folders. */
+      /** Indicates the view for this permission. Only populated for permissions that belong to a view. The only supported values are `published` and `metadata`: * `published`: The permission's role is `publishedReader`. * `metadata`: The item is only visible to the `metadata` view because the item has limited access and the scope has at least read access to the parent. The `metadata` view is only supported on folders. For more information, see [Views](https://developers.google.com/workspace/drive/api/guides/ref-roles#views). */
       view?: string;
     }
     interface PermissionList {
@@ -863,12 +867,14 @@ declare namespace gapi.client {
       kind?: string;
       /** The page token for the next page of permissions. This field will be absent if the end of the permissions list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ. */
       nextPageToken?: string;
-      /** The list of permissions. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched. */
+      /** The list of permissions. If `nextPageToken` is populated, then this list may be incomplete and an additional page of results should be fetched. */
       permissions?: Permission[];
     }
     interface Reply {
       /** The action the reply performed to the parent comment. Valid values are: * `resolve` * `reopen` */
       action?: string;
+      /** Output only. The email of the user who is assigned to this reply, if none is assigned this will be unset. */
+      assigneeEmailAddress?: string;
       /** Output only. The author of the reply. The author's email address and permission ID will not be populated. */
       author?: User;
       /** The plain text content of the reply. This field is used for setting the content, while `htmlContent` should be displayed. This is required on creates if no `action` is specified. */
@@ -883,6 +889,8 @@ declare namespace gapi.client {
       id?: string;
       /** Output only. Identifies what kind of resource this is. Value: the fixed string `"drive#reply"`. */
       kind?: string;
+      /** Output only. The emails of the users who were mentioned in this reply, if none were mentioned this will be an empty list. */
+      mentionedEmailAddresses?: string[];
       /** The last time the reply was modified (RFC 3339 date-time). */
       modifiedTime?: string;
     }
@@ -2742,7 +2750,7 @@ declare namespace gapi.client {
       }): Request<Operation>;
     }
     interface PermissionsResource {
-      /** Creates a permission for a file or shared drive. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied. */
+      /** Creates a permission for a file or shared drive. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied. */
       create(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2764,7 +2772,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;
-        /** This parameter will only take effect if the item is not in a shared drive and the request is attempting to transfer the ownership of the item. If set to `true`, the item will be moved to the new owner's My Drive root folder and all prior parents removed. If set to `false`, parents are not changed. */
+        /** This parameter only takes effect if the item isn't in a shared drive and the request is attempting to transfer the ownership of the item. If set to `true`, the item is moved to the new owner's My Drive root folder and all prior parents removed. If set to `false`, parents aren't changed. */
         moveToNewOwnersRoot?: boolean;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
@@ -2778,13 +2786,13 @@ declare namespace gapi.client {
         supportsAllDrives?: boolean;
         /** Deprecated: Use `supportsAllDrives` instead. */
         supportsTeamDrives?: boolean;
-        /** Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect. */
+        /** Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect. For more information, see [Transfer file ownership](https://developers.google.com/workspace/drive/api/guides/transfer-file). */
         transferOwnership?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs. */
+        /** Issue the request as a domain administrator. If set to `true`, and if the following additional conditions are met, the requester is granted access: 1. The file ID parameter refers to a shared drive. 2. The requester is an administrator of the domain to which the shared drive belongs. For more information, see [Manage shared drives as domain administrators](https://developers.google.com/workspace/drive/api/guides/manage-shareddrives#manage-administrators). */
         useDomainAdminAccess?: boolean;
         /** Request body */
         resource: Permission;
@@ -2811,7 +2819,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;
-          /** This parameter will only take effect if the item is not in a shared drive and the request is attempting to transfer the ownership of the item. If set to `true`, the item will be moved to the new owner's My Drive root folder and all prior parents removed. If set to `false`, parents are not changed. */
+          /** This parameter only takes effect if the item isn't in a shared drive and the request is attempting to transfer the ownership of the item. If set to `true`, the item is moved to the new owner's My Drive root folder and all prior parents removed. If set to `false`, parents aren't changed. */
           moveToNewOwnersRoot?: boolean;
           /** OAuth 2.0 token for the current user. */
           oauth_token?: string;
@@ -2825,18 +2833,18 @@ declare namespace gapi.client {
           supportsAllDrives?: boolean;
           /** Deprecated: Use `supportsAllDrives` instead. */
           supportsTeamDrives?: boolean;
-          /** Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect. */
+          /** Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect. For more information, see [Transfer file ownership](https://developers.google.com/workspace/drive/api/guides/transfer-file). */
           transferOwnership?: boolean;
           /** Upload protocol for media (e.g. "raw", "multipart"). */
           upload_protocol?: string;
           /** Legacy upload protocol for media (e.g. "media", "multipart"). */
           uploadType?: string;
-          /** Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs. */
+          /** Issue the request as a domain administrator. If set to `true`, and if the following additional conditions are met, the requester is granted access: 1. The file ID parameter refers to a shared drive. 2. The requester is an administrator of the domain to which the shared drive belongs. For more information, see [Manage shared drives as domain administrators](https://developers.google.com/workspace/drive/api/guides/manage-shareddrives#manage-administrators). */
           useDomainAdminAccess?: boolean;
         },
         body: Permission,
       ): Request<Permission>;
-      /** Deletes a permission. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied. */
+      /** Deletes a permission. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied. */
       delete(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2870,10 +2878,10 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs. */
+        /** Issue the request as a domain administrator. If set to `true`, and if the following additional conditions are met, the requester is granted access: 1. The file ID parameter refers to a shared drive. 2. The requester is an administrator of the domain to which the shared drive belongs. For more information, see [Manage shared drives as domain administrators](https://developers.google.com/workspace/drive/api/guides/manage-shareddrives#manage-administrators). */
         useDomainAdminAccess?: boolean;
       }): Request<void>;
-      /** Gets a permission by ID. */
+      /** Gets a permission by ID. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). */
       get(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2905,10 +2913,10 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs. */
+        /** Issue the request as a domain administrator. If set to `true`, and if the following additional conditions are met, the requester is granted access: 1. The file ID parameter refers to a shared drive. 2. The requester is an administrator of the domain to which the shared drive belongs. For more information, see [Manage shared drives as domain administrators](https://developers.google.com/workspace/drive/api/guides/manage-shareddrives#manage-administrators). */
         useDomainAdminAccess?: boolean;
       }): Request<Permission>;
-      /** Lists a file's or shared drive's permissions. */
+      /** Lists a file's or shared drive's permissions. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). */
       list(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2922,7 +2930,7 @@ declare namespace gapi.client {
         fields?: string;
         /** The ID of the file or shared drive. */
         fileId: 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;
@@ -2930,7 +2938,7 @@ declare namespace gapi.client {
         oauth_token?: string;
         /** The maximum number of permissions to return per page. When not set for files in a shared drive, at most 100 results will be returned. When not set for files that are not in a shared drive, the entire list will be returned. */
         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;
@@ -2944,10 +2952,10 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs. */
+        /** Issue the request as a domain administrator. If set to `true`, and if the following additional conditions are met, the requester is granted access: 1. The file ID parameter refers to a shared drive. 2. The requester is an administrator of the domain to which the shared drive belongs. For more information, see [Manage shared drives as domain administrators](https://developers.google.com/workspace/drive/api/guides/manage-shareddrives#manage-administrators). */
         useDomainAdminAccess?: boolean;
       }): Request<PermissionList>;
-      /** Updates a permission with patch semantics. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied. */
+      /** Updates a permission with patch semantics. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied. */
       update(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -2979,13 +2987,13 @@ declare namespace gapi.client {
         supportsAllDrives?: boolean;
         /** Deprecated: Use `supportsAllDrives` instead. */
         supportsTeamDrives?: boolean;
-        /** Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect. */
+        /** Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect. For more information, see [Transfer file ownership](https://developers.google.com//workspace/drive/api/guides/transfer-file). */
         transferOwnership?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs. */
+        /** Issue the request as a domain administrator. If set to `true`, and if the following additional conditions are met, the requester is granted access: 1. The file ID parameter refers to a shared drive. 2. The requester is an administrator of the domain to which the shared drive belongs. For more information, see [Manage shared drives as domain administrators](https://developers.google.com/workspace/drive/api/guides/manage-shareddrives#manage-administrators). */
         useDomainAdminAccess?: boolean;
         /** Request body */
         resource: Permission;
@@ -3022,13 +3030,13 @@ declare namespace gapi.client {
           supportsAllDrives?: boolean;
           /** Deprecated: Use `supportsAllDrives` instead. */
           supportsTeamDrives?: boolean;
-          /** Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect. */
+          /** Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect. For more information, see [Transfer file ownership](https://developers.google.com//workspace/drive/api/guides/transfer-file). */
           transferOwnership?: boolean;
           /** Upload protocol for media (e.g. "raw", "multipart"). */
           upload_protocol?: string;
           /** Legacy upload protocol for media (e.g. "media", "multipart"). */
           uploadType?: string;
-          /** Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs. */
+          /** Issue the request as a domain administrator. If set to `true`, and if the following additional conditions are met, the requester is granted access: 1. The file ID parameter refers to a shared drive. 2. The requester is an administrator of the domain to which the shared drive belongs. For more information, see [Manage shared drives as domain administrators](https://developers.google.com/workspace/drive/api/guides/manage-shareddrives#manage-administrators). */
           useDomainAdminAccess?: boolean;
         },
         body: Permission,

package/package.json

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

package/readme.md

@@ -278,27 +278,27 @@ Gets the latest state of a long-running operation. Clients can use this method t
 await gapi.client.drive.operations.get({ name: "name",  });
 
 /*
-Creates a permission for a file or shared drive. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.
+Creates a permission for a file or shared drive. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied.
 */
 await gapi.client.drive.permissions.create({ fileId: "fileId",  });
 
 /*
-Deletes a permission. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.
+Deletes a permission. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied.
 */
 await gapi.client.drive.permissions.delete({ fileId: "fileId", permissionId: "permissionId",  });
 
 /*
-Gets a permission by ID.
+Gets a permission by ID. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing).
 */
 await gapi.client.drive.permissions.get({ fileId: "fileId", permissionId: "permissionId",  });
 
 /*
-Lists a file's or shared drive's permissions.
+Lists a file's or shared drive's permissions. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing).
 */
 await gapi.client.drive.permissions.list({ fileId: "fileId",  });
 
 /*
-Updates a permission with patch semantics. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.
+Updates a permission with patch semantics. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied.
 */
 await gapi.client.drive.permissions.update({ fileId: "fileId", permissionId: "permissionId",  });