feat(drive): update the API

#### drive:v2

The following keys were added:
- schemas.User.properties.displayName.readOnly
- schemas.User.properties.emailAddress.readOnly
- schemas.User.properties.isAuthenticatedUser.readOnly
- schemas.User.properties.kind.readOnly
- schemas.User.properties.permissionId.readOnly
- schemas.User.properties.picture.properties.url.readOnly
- schemas.User.properties.picture.readOnly

The following keys were changed:
- documentationLink
- resources.drives.methods.list.description
- resources.files.methods.get.description
- resources.files.methods.insert.description
- resources.files.methods.list.description
- resources.files.methods.update.description
- schemas.Comment.properties.anchor.description
- schemas.User.properties.emailAddress.description
- schemas.User.properties.kind.description
- schemas.User.properties.permissionId.description
- schemas.User.properties.picture.properties.url.description

#### drive:v3

The following keys were added:
- schemas.User.properties.displayName.readOnly
- schemas.User.properties.emailAddress.readOnly
- schemas.User.properties.kind.readOnly
- schemas.User.properties.me.readOnly
- schemas.User.properties.permissionId.readOnly
- schemas.User.properties.photoLink.readOnly

The following keys were changed:
- documentationLink
- resources.about.methods.get.description
- resources.apps.methods.get.description
- resources.apps.methods.list.description
- resources.changes.methods.getStartPageToken.description
- resources.changes.methods.list.description
- resources.changes.methods.watch.description
- resources.channels.methods.stop.description
- resources.comments.methods.create.description
- resources.comments.methods.delete.description
- resources.comments.methods.get.description
- resources.comments.methods.list.description
- resources.comments.methods.update.description
- resources.drives.methods.list.description
- resources.files.methods.create.description
- resources.files.methods.get.description
- resources.files.methods.list.description
- resources.files.methods.update.description
- schemas.Comment.properties.anchor.description
- schemas.Permission.description
- schemas.User.properties.kind.description

Author: yoshi-automation

discovery/drive-v2.json

@@ -40,7 +40,7 @@
   "batchPath": "batch/drive/v2",
   "description": "The Google Drive API allows clients to access resources from Google Drive.",
   "discoveryVersion": "v1",
-  "documentationLink": "https://developers.google.com/drive/",
+  "documentationLink": "https://developers.google.com/workspace/drive/",
   "icons": {
     "x16": "http://www.google.com/images/icons/product/search-16.gif",
     "x32": "http://www.google.com/images/icons/product/search-32.gif"
@@ -1134,7 +1134,7 @@
           ]
         },
         "list": {
-          "description": " Lists the user's shared drives. This method accepts the `q` parameter, which is a search query combining one or more search terms. For more information, see the [Search for shared drives](/drive/api/guides/search-shareddrives) guide.",
+          "description": " Lists the user's shared drives. This method accepts the `q` parameter, which is a search query combining one or more search terms. For more information, see the [Search for shared drives](/workspace/drive/api/guides/search-shareddrives) guide.",
           "flatPath": "drives",
           "httpMethod": "GET",
           "id": "drive.drives.list",
@@ -1485,7 +1485,7 @@
           ]
         },
         "get": {
-          "description": " Gets a file's metadata or content by ID. If you provide the URL parameter `alt=media`, then the response includes the file contents in the response body. Downloading content with `alt=media` only works if the file is stored in Drive. To download Google Docs, Sheets, and Slides use [`files.export`](/drive/api/reference/rest/v2/files/export) instead. For more information, see [Download & export files](/drive/api/guides/manage-downloads).",
+          "description": " 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/v2/files/export) instead. For more information, see [Download & export files](/workspace/drive/api/guides/manage-downloads).",
           "flatPath": "files/{fileId}",
           "httpMethod": "GET",
           "id": "drive.files.get",
@@ -1574,7 +1574,7 @@
           "useMediaDownloadService": true
         },
         "insert": {
-          "description": " Inserts 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](/drive/api/guides/manage-uploads). Apps creating shortcuts with `files.insert` must specify the MIME type `application/vnd.google-apps.shortcut`. Apps should specify a file extension in the `title` property when inserting files with the API. For example, an operation to insert a JPEG file should specify something like `\"title\": \"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.",
+          "description": " Inserts 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.insert` must specify the MIME type `application/vnd.google-apps.shortcut`. Apps should specify a file extension in the `title` property when inserting files with the API. For example, an operation to insert a JPEG file should specify something like `\"title\": \"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.",
           "flatPath": "files",
           "httpMethod": "POST",
           "id": "drive.files.insert",
@@ -1696,7 +1696,7 @@
           "supportsMediaUpload": true
         },
         "list": {
-          "description": " 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](/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.",
+          "description": " 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.",
           "flatPath": "files",
           "httpMethod": "GET",
           "id": "drive.files.list",
@@ -2202,7 +2202,7 @@
           ]
         },
         "update": {
-          "description": " 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](/drive/api/guides/manage-uploads).",
+          "description": " 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).",
           "flatPath": "files/{fileId}",
           "httpMethod": "PUT",
           "id": "drive.files.update",
@@ -3887,7 +3887,7 @@
       }
     }
   },
-  "revision": "20250216",
+  "revision": "20250427",
   "rootUrl": "https://www.googleapis.com/",
   "schemas": {
     "About": {
@@ -4559,7 +4559,7 @@
       "id": "Comment",
       "properties": {
         "anchor": {
-          "description": "A region of the document represented as a JSON string. For details on defining anchor properties, refer to [Add comments and replies](https://developers.google.com/drive/api/v2/manage-comments).",
+          "description": "A region of the document represented as a JSON string. For details on defining anchor properties, refer to [Add comments and replies](https://developers.google.com/workspace/drive/api/v2/manage-comments).",
           "type": "string"
         },
         "author": {
@@ -6743,33 +6743,40 @@
       "properties": {
         "displayName": {
           "description": "Output only. A plain text displayable name for this user.",
+          "readOnly": true,
           "type": "string"
         },
         "emailAddress": {
-          "description": "Output only. The email address of the user.",
+          "description": "Output only. The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester.",
+          "readOnly": true,
           "type": "string"
         },
         "isAuthenticatedUser": {
           "description": "Output only. Whether this user is the same as the authenticated user for whom the request was made.",
+          "readOnly": true,
           "type": "boolean"
         },
         "kind": {
           "default": "drive#user",
-          "description": "Output only. This is always `drive#user`.",
+          "description": "Output only. Identifies what kind of resource this is. Value: the fixed string `drive#user`.",
+          "readOnly": true,
           "type": "string"
         },
         "permissionId": {
-          "description": "Output only. The user's ID as visible in the permissions collection.",
+          "description": "Output only. The user's ID as visible in Permission resources.",
+          "readOnly": true,
           "type": "string"
         },
         "picture": {
           "description": "Output only. The user's profile picture.",
           "properties": {
             "url": {
-              "description": "Output Only. A URL that points to a profile picture of this user.",
+              "description": "Output only. A URL that points to a profile picture of this user.",
+              "readOnly": true,
               "type": "string"
             }
           },
+          "readOnly": true,
           "type": "object"
         }
       },