google-api-python-client 2.195.0__py3-none-any.whl → 2.196.0__py3-none-any.whl

googleapiclient/discovery_cache/documents/gmail.v1.json

@@ -175,7 +175,7 @@
 ]
 },
 "stop": {
-"description": "Stop receiving push notifications for the given user mailbox.",
+"description": "Turn off push notification delivery for the given user mailbox. For more information, see [Configure push notifications in Gmail API](https://developers.google.com/workspace/gmail/api/guides/push).",
 "flatPath": "gmail/v1/users/{userId}/stop",
 "httpMethod": "POST",
 "id": "gmail.users.stop",
@@ -200,7 +200,7 @@
 ]
 },
 "watch": {
-"description": "Set up or update a push notification watch on the given user mailbox.",
+"description": "Set up or update a push notification watch on the given user mailbox. For more information, see [Configure push notifications in Gmail API](https://developers.google.com/workspace/gmail/api/guides/push).",
 "flatPath": "gmail/v1/users/{userId}/watch",
 "httpMethod": "POST",
 "id": "gmail.users.watch",
@@ -235,7 +235,7 @@
 "drafts": {
 "methods": {
 "create": {
-"description": "Creates a new draft with the `DRAFT` label.",
+"description": "Creates a draft with the `DRAFT` label. For more information, see [Create and send draft emails](https://developers.google.com/workspace/gmail/api/guides/drafts).",
 "flatPath": "gmail/v1/users/{userId}/drafts",
 "httpMethod": "POST",
 "id": "gmail.users.drafts.create",
@@ -283,7 +283,7 @@
 "supportsMediaUpload": true
 },
 "delete": {
-"description": "Immediately and permanently deletes the specified draft. Does not simply trash it.",
+"description": "Immediately and permanently deletes the specified draft. Does not simply trash it. For more information, see [Create and send draft emails](https://developers.google.com/workspace/gmail/api/guides/drafts).",
 "flatPath": "gmail/v1/users/{userId}/drafts/{id}",
 "httpMethod": "DELETE",
 "id": "gmail.users.drafts.delete",
@@ -315,7 +315,7 @@
 ]
 },
 "get": {
-"description": "Gets the specified draft.",
+"description": "Gets the specified draft. For more information, see [Create and send draft emails](https://developers.google.com/workspace/gmail/api/guides/drafts).",
 "flatPath": "gmail/v1/users/{userId}/drafts/{id}",
 "httpMethod": "GET",
 "id": "gmail.users.drafts.get",
@@ -368,7 +368,7 @@
 ]
 },
 "list": {
-"description": "Lists the drafts in the user's mailbox.",
+"description": "Lists the drafts in the user's mailbox. For more information, see [Create and send draft emails](https://developers.google.com/workspace/gmail/api/guides/drafts).",
 "flatPath": "gmail/v1/users/{userId}/drafts",
 "httpMethod": "GET",
 "id": "gmail.users.drafts.list",
@@ -419,7 +419,7 @@
 ]
 },
 "send": {
-"description": "Sends the specified, existing draft to the recipients in the `To`, `Cc`, and `Bcc` headers.",
+"description": "Sends the specified, existing draft to the recipients in the `To`, `Cc`, and `Bcc` headers. For more information, see [Create and send draft emails](https://developers.google.com/workspace/gmail/api/guides/drafts).",
 "flatPath": "gmail/v1/users/{userId}/drafts/send",
 "httpMethod": "POST",
 "id": "gmail.users.drafts.send",
@@ -467,7 +467,7 @@
 "supportsMediaUpload": true
 },
 "update": {
-"description": "Replaces a draft's content.",
+"description": "Replaces a draft's content. For more information, see [Create and send draft emails](https://developers.google.com/workspace/gmail/api/guides/drafts).",
 "flatPath": "gmail/v1/users/{userId}/drafts/{id}",
 "httpMethod": "PUT",
 "id": "gmail.users.drafts.update",
@@ -526,7 +526,7 @@
 "history": {
 "methods": {
 "list": {
-"description": "Lists the history of all changes to the given mailbox. History results are returned in chronological order (increasing `historyId`).",
+"description": "Lists the history of all changes to the given mailbox. History results are returned in chronological order (increasing `historyId`). For more information, see [Synchronize clients with Gmail](https://developers.google.com/workspace/gmail/api/guides/sync).",
 "flatPath": "gmail/v1/users/{userId}/history",
 "httpMethod": "GET",
 "id": "gmail.users.history.list",
@@ -599,7 +599,7 @@
 "labels": {
 "methods": {
 "create": {
-"description": "Creates a new label.",
+"description": "Creates a label. For more information, see [Manage labels](https://developers.google.com/workspace/gmail/api/guides/labels).",
 "flatPath": "gmail/v1/users/{userId}/labels",
 "httpMethod": "POST",
 "id": "gmail.users.labels.create",
@@ -629,7 +629,7 @@
 ]
 },
 "delete": {
-"description": "Immediately and permanently deletes the specified label and removes it from any messages and threads that it is applied to.",
+"description": "Immediately and permanently deletes the specified label and removes it from any messages and threads that it's applied to. For more information, see [Manage labels](https://developers.google.com/workspace/gmail/api/guides/labels).",
 "flatPath": "gmail/v1/users/{userId}/labels/{id}",
 "httpMethod": "DELETE",
 "id": "gmail.users.labels.delete",
@@ -660,7 +660,7 @@
 ]
 },
 "get": {
-"description": "Gets the specified label.",
+"description": "Gets the specified label. For more information, see [Manage labels](https://developers.google.com/workspace/gmail/api/guides/labels).",
 "flatPath": "gmail/v1/users/{userId}/labels/{id}",
 "httpMethod": "GET",
 "id": "gmail.users.labels.get",
@@ -696,7 +696,7 @@
 ]
 },
 "list": {
-"description": "Lists all labels in the user's mailbox.",
+"description": "Lists all labels in the user's mailbox. For more information, see [Manage labels](https://developers.google.com/workspace/gmail/api/guides/labels).",
 "flatPath": "gmail/v1/users/{userId}/labels",
 "httpMethod": "GET",
 "id": "gmail.users.labels.list",
@@ -725,7 +725,7 @@
 ]
 },
 "patch": {
-"description": "Patch the specified label.",
+"description": "Patch the specified label. For more information, see [Manage labels](https://developers.google.com/workspace/gmail/api/guides/labels).",
 "flatPath": "gmail/v1/users/{userId}/labels/{id}",
 "httpMethod": "PATCH",
 "id": "gmail.users.labels.patch",
@@ -762,7 +762,7 @@
 ]
 },
 "update": {
-"description": "Updates the specified label.",
+"description": "Updates the specified label. For more information, see [Manage labels](https://developers.google.com/workspace/gmail/api/guides/labels).",
 "flatPath": "gmail/v1/users/{userId}/labels/{id}",
 "httpMethod": "PUT",
 "id": "gmail.users.labels.update",
@@ -945,7 +945,7 @@
 ]
 },
 "import": {
-"description": "Imports a message into only this user's mailbox, with standard email delivery scanning and classification similar to receiving via SMTP. This method doesn't perform SPF checks, so it might not work for some spam messages, such as those attempting to perform domain spoofing. This method does not send a message. Note that the maximum size of the message is 150MB.",
+"description": "Imports a message into only this user's mailbox, with standard email delivery scanning and classification similar to receiving via SMTP. This method doesn't perform SPF checks, so it might not work for some spam messages, such as those attempting to perform domain spoofing. This method does not send a message. Note that the maximum size of the message is 150 MB.",
 "flatPath": "gmail/v1/users/{userId}/messages/import",
 "httpMethod": "POST",
 "id": "gmail.users.messages.import",
@@ -1024,7 +1024,7 @@
 "supportsMediaUpload": true
 },
 "insert": {
-"description": "Directly inserts a message into only this user's mailbox similar to `IMAP APPEND`, bypassing most scanning and classification. Does not send a message.",
+"description": "Directly inserts a message into only this user's mailbox similar to `IMAP APPEND`, bypassing most scanning and classification. Does not send a message. For more information, see [Create and send email messages](https://developers.google.com/workspace/gmail/api/guides/sending).",
 "flatPath": "gmail/v1/users/{userId}/messages",
 "httpMethod": "POST",
 "id": "gmail.users.messages.insert",
@@ -1091,7 +1091,7 @@
 "supportsMediaUpload": true
 },
 "list": {
-"description": "Lists the messages in the user's mailbox. For example usage, see [List Gmail messages](https://developers.google.com/workspace/gmail/api/guides/list-messages).",
+"description": "Lists the messages in the user's mailbox. For more information, see [List Gmail messages](https://developers.google.com/workspace/gmail/api/guides/list-messages).",
 "flatPath": "gmail/v1/users/{userId}/messages",
 "httpMethod": "GET",
 "id": "gmail.users.messages.list",
@@ -1184,7 +1184,7 @@
 ]
 },
 "send": {
-"description": "Sends the specified message to the recipients in the `To`, `Cc`, and `Bcc` headers. For example usage, see [Sending email](https://developers.google.com/workspace/gmail/api/guides/sending).",
+"description": "Sends the specified message to the recipients in the `To`, `Cc`, and `Bcc` headers. For more information, see [Create and send email messages](https://developers.google.com/workspace/gmail/api/guides/sending).",
 "flatPath": "gmail/v1/users/{userId}/messages/send",
 "httpMethod": "POST",
 "id": "gmail.users.messages.send",
@@ -1352,7 +1352,7 @@
 "settings": {
 "methods": {
 "getAutoForwarding": {
-"description": "Gets the auto-forwarding setting for the specified account.",
+"description": "Gets the auto-forwarding setting for the specified account. For more information, see [Manage email forwarding](https://developers.google.com/workspace/gmail/api/guides/forwarding_settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/autoForwarding",
 "httpMethod": "GET",
 "id": "gmail.users.settings.getAutoForwarding",
@@ -1380,7 +1380,7 @@
 ]
 },
 "getImap": {
-"description": "Gets IMAP settings.",
+"description": "Gets IMAP settings. For more information, see [Configure POP and IMAP settings with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/pop_imap_settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/imap",
 "httpMethod": "GET",
 "id": "gmail.users.settings.getImap",
@@ -1408,7 +1408,7 @@
 ]
 },
 "getLanguage": {
-"description": "Gets language settings.",
+"description": "Gets language settings. For more information, see [Manage language settings](https://developers.google.com/workspace/gmail/api/guides/language-settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/language",
 "httpMethod": "GET",
 "id": "gmail.users.settings.getLanguage",
@@ -1436,7 +1436,7 @@
 ]
 },
 "getPop": {
-"description": "Gets POP settings.",
+"description": "Gets POP settings. For more information, see [Configure POP and IMAP settings with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/pop_imap_settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/pop",
 "httpMethod": "GET",
 "id": "gmail.users.settings.getPop",
@@ -1464,7 +1464,7 @@
 ]
 },
 "getVacation": {
-"description": "Gets vacation responder settings.",
+"description": "Gets vacation responder settings. For more information, see [Manage vacation settings with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/vacation_settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/vacation",
 "httpMethod": "GET",
 "id": "gmail.users.settings.getVacation",
@@ -1492,7 +1492,7 @@
 ]
 },
 "updateAutoForwarding": {
-"description": "Updates the auto-forwarding setting for the specified account. A verified forwarding address must be specified when auto-forwarding is enabled. This method is only available to service account clients that have been delegated domain-wide authority.",
+"description": "Updates the auto-forwarding setting for the specified account. A verified forwarding address must be specified when auto-forwarding is enabled. For more information, see [Manage email forwarding](https://developers.google.com/workspace/gmail/api/guides/forwarding_settings). This method is only available to service account clients that have been delegated domain-wide authority.",
 "flatPath": "gmail/v1/users/{userId}/settings/autoForwarding",
 "httpMethod": "PUT",
 "id": "gmail.users.settings.updateAutoForwarding",
@@ -1520,7 +1520,7 @@
 ]
 },
 "updateImap": {
-"description": "Updates IMAP settings.",
+"description": "Updates IMAP settings. For more information, see [Configure POP and IMAP settings with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/pop_imap_settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/imap",
 "httpMethod": "PUT",
 "id": "gmail.users.settings.updateImap",
@@ -1548,7 +1548,7 @@
 ]
 },
 "updateLanguage": {
-"description": "Updates language settings. If successful, the return object contains the `displayLanguage` that was saved for the user, which may differ from the value passed into the request. This is because the requested `displayLanguage` may not be directly supported by Gmail but have a close variant that is, and so the variant may be chosen and saved instead.",
+"description": "Updates language settings. For more information, see [Manage language settings](https://developers.google.com/workspace/gmail/api/guides/language-settings). If successful, the return object contains the `displayLanguage` that was saved for the user, which may differ from the value passed into the request. This is because the requested `displayLanguage` may not be directly supported by Gmail but have a close variant that is, and so the variant may be chosen and saved instead.",
 "flatPath": "gmail/v1/users/{userId}/settings/language",
 "httpMethod": "PUT",
 "id": "gmail.users.settings.updateLanguage",
@@ -1576,7 +1576,7 @@
 ]
 },
 "updatePop": {
-"description": "Updates POP settings.",
+"description": "Updates POP settings. For more information, see [Configure POP and IMAP settings with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/pop_imap_settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/pop",
 "httpMethod": "PUT",
 "id": "gmail.users.settings.updatePop",
@@ -1604,7 +1604,7 @@
 ]
 },
 "updateVacation": {
-"description": "Updates vacation responder settings.",
+"description": "Updates vacation responder settings. For more information, see [Manage vacation settings with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/vacation_settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/vacation",
 "httpMethod": "PUT",
 "id": "gmail.users.settings.updateVacation",
@@ -2031,7 +2031,7 @@
 "delegates": {
 "methods": {
 "create": {
-"description": "Adds a delegate with its verification status set directly to `accepted`, without sending any verification email. The delegate user must be a member of the same Google Workspace organization as the delegator user. Gmail imposes limitations on the number of delegates and delegators each user in a Google Workspace organization can have. These limits depend on your organization, but in general each user can have up to 25 delegates and up to 10 delegators. Note that a delegate user must be referred to by their primary email address, and not an email alias. Also note that when a new delegate is created, there may be up to a one minute delay before the new delegate is available for use. This method is only available to service account clients that have been delegated domain-wide authority.",
+"description": "Adds a delegate with its verification status set directly to `accepted`, without sending any verification email. The delegate user must be a member of the same Google Workspace organization as the delegator user. For more information, see [Manage delegates](https://developers.google.com/workspace/gmail/api/guides/delegate_settings). Gmail imposes limitations on the number of delegates and delegators each user in a Google Workspace organization can have. These limits depend on your organization, but in general each user can have up to 25 delegates and up to 10 delegators. A delegate user must be referred to by their primary email address, and not an email alias. When a new delegate is created, there may be up to a one minute delay before the new delegate is available for use. This method is only available to service account clients that have been delegated domain-wide authority.",
 "flatPath": "gmail/v1/users/{userId}/settings/delegates",
 "httpMethod": "POST",
 "id": "gmail.users.settings.delegates.create",
@@ -2059,7 +2059,7 @@
 ]
 },
 "delete": {
-"description": "Removes the specified delegate (which can be of any verification status), and revokes any verification that may have been required for using it. Note that a delegate user must be referred to by their primary email address, and not an email alias. This method is only available to service account clients that have been delegated domain-wide authority.",
+"description": "Removes the specified delegate (which can be of any verification status), and revokes any verification that may have been required for using it. For more information, see [Manage delegates](https://developers.google.com/workspace/gmail/api/guides/delegate_settings). A delegate user must be referred to by their primary email address, and not an email alias. This method is only available to service account clients that have been delegated domain-wide authority.",
 "flatPath": "gmail/v1/users/{userId}/settings/delegates/{delegateEmail}",
 "httpMethod": "DELETE",
 "id": "gmail.users.settings.delegates.delete",
@@ -2088,7 +2088,7 @@
 ]
 },
 "get": {
-"description": "Gets the specified delegate. Note that a delegate user must be referred to by their primary email address, and not an email alias. This method is only available to service account clients that have been delegated domain-wide authority.",
+"description": "Gets the specified delegate. For more information, see [Manage delegates](https://developers.google.com/workspace/gmail/api/guides/delegate_settings). A delegate user must be referred to by their primary email address, and not an email alias. This method is only available to service account clients that have been delegated domain-wide authority.",
 "flatPath": "gmail/v1/users/{userId}/settings/delegates/{delegateEmail}",
 "httpMethod": "GET",
 "id": "gmail.users.settings.delegates.get",
@@ -2123,7 +2123,7 @@
 ]
 },
 "list": {
-"description": "Lists the delegates for the specified account. This method is only available to service account clients that have been delegated domain-wide authority.",
+"description": "Lists the delegates for the specified account. For more information, see [Manage delegates](https://developers.google.com/workspace/gmail/api/guides/delegate_settings). This method is only available to service account clients that have been delegated domain-wide authority.",
 "flatPath": "gmail/v1/users/{userId}/settings/delegates",
 "httpMethod": "GET",
 "id": "gmail.users.settings.delegates.list",
@@ -2155,7 +2155,7 @@
 "filters": {
 "methods": {
 "create": {
-"description": "Creates a filter. Note: you can only create a maximum of 1,000 filters.",
+"description": "Creates a filter. Note: you can only create a maximum of 1,000 filters. For more information, see [Manage Gmail filters](https://developers.google.com/workspace/gmail/api/guides/filter_settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/filters",
 "httpMethod": "POST",
 "id": "gmail.users.settings.filters.create",
@@ -2183,7 +2183,7 @@
 ]
 },
 "delete": {
-"description": "Immediately and permanently deletes the specified filter.",
+"description": "Immediately and permanently deletes the specified filter. For more information, see [Manage Gmail filters](https://developers.google.com/workspace/gmail/api/guides/filter_settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/filters/{id}",
 "httpMethod": "DELETE",
 "id": "gmail.users.settings.filters.delete",
@@ -2212,7 +2212,7 @@
 ]
 },
 "get": {
-"description": "Gets a filter.",
+"description": "Gets a filter. For more information, see [Manage Gmail filters](https://developers.google.com/workspace/gmail/api/guides/filter_settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/filters/{id}",
 "httpMethod": "GET",
 "id": "gmail.users.settings.filters.get",
@@ -2247,7 +2247,7 @@
 ]
 },
 "list": {
-"description": "Lists the message filters of a Gmail user.",
+"description": "Lists the message filters of a Gmail user. For more information, see [Manage Gmail filters](https://developers.google.com/workspace/gmail/api/guides/filter_settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/filters",
 "httpMethod": "GET",
 "id": "gmail.users.settings.filters.list",
@@ -2279,7 +2279,7 @@
 "forwardingAddresses": {
 "methods": {
 "create": {
-"description": "Creates a forwarding address. If ownership verification is required, a message will be sent to the recipient and the resource's verification status will be set to `pending`; otherwise, the resource will be created with verification status set to `accepted`. This method is only available to service account clients that have been delegated domain-wide authority.",
+"description": "Creates a forwarding address. If ownership verification is required, a message will be sent to the recipient and the resource's verification status will be set to `pending`; otherwise, the resource will be created with verification status set to `accepted`. For more information, see [Manage email forwarding](https://developers.google.com/workspace/gmail/api/guides/forwarding_settings). This method is only available to service account clients that have been delegated domain-wide authority.",
 "flatPath": "gmail/v1/users/{userId}/settings/forwardingAddresses",
 "httpMethod": "POST",
 "id": "gmail.users.settings.forwardingAddresses.create",
@@ -2307,7 +2307,7 @@
 ]
 },
 "delete": {
-"description": "Deletes the specified forwarding address and revokes any verification that may have been required. This method is only available to service account clients that have been delegated domain-wide authority.",
+"description": "Deletes the specified forwarding address and revokes any verification that may have been required. For more information, see [Manage email forwarding](https://developers.google.com/workspace/gmail/api/guides/forwarding_settings). This method is only available to service account clients that have been delegated domain-wide authority.",
 "flatPath": "gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}",
 "httpMethod": "DELETE",
 "id": "gmail.users.settings.forwardingAddresses.delete",
@@ -2336,7 +2336,7 @@
 ]
 },
 "get": {
-"description": "Gets the specified forwarding address.",
+"description": "Gets the specified forwarding address. For more information, see [Manage email forwarding](https://developers.google.com/workspace/gmail/api/guides/forwarding_settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}",
 "httpMethod": "GET",
 "id": "gmail.users.settings.forwardingAddresses.get",
@@ -2371,7 +2371,7 @@
 ]
 },
 "list": {
-"description": "Lists the forwarding addresses for the specified account.",
+"description": "Lists the forwarding addresses for the specified account. For more information, see [Manage email forwarding](https://developers.google.com/workspace/gmail/api/guides/forwarding_settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/forwardingAddresses",
 "httpMethod": "GET",
 "id": "gmail.users.settings.forwardingAddresses.list",
@@ -2403,7 +2403,7 @@
 "sendAs": {
 "methods": {
 "create": {
-"description": "Creates a custom \"from\" send-as alias. If an SMTP MSA is specified, Gmail will attempt to connect to the SMTP service to validate the configuration before creating the alias. If ownership verification is required for the alias, a message will be sent to the email address and the resource's verification status will be set to `pending`; otherwise, the resource will be created with verification status set to `accepted`. If a signature is provided, Gmail will sanitize the HTML before saving it with the alias. This method is only available to service account clients that have been delegated domain-wide authority.",
+"description": "Creates a custom \"from\" send-as alias. If an SMTP MSA is specified, Gmail will attempt to connect to the SMTP service to validate the configuration before creating the alias. If ownership verification is required for the alias, a message will be sent to the email address and the resource's verification status will be set to `pending`; otherwise, the resource will be created with verification status set to `accepted`. If a signature is provided, Gmail will sanitize the HTML before saving it with the alias. For more information, see [Manage aliases and signatures with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/alias_and_signature_settings). This method is only available to service account clients that have been delegated domain-wide authority.",
 "flatPath": "gmail/v1/users/{userId}/settings/sendAs",
 "httpMethod": "POST",
 "id": "gmail.users.settings.sendAs.create",
@@ -2431,7 +2431,7 @@
 ]
 },
 "delete": {
-"description": "Deletes the specified send-as alias. Revokes any verification that may have been required for using it. This method is only available to service account clients that have been delegated domain-wide authority.",
+"description": "Deletes the specified send-as alias. Revokes any verification that may have been required for using it. For more information, see [Manage aliases and signatures with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/alias_and_signature_settings). This method is only available to service account clients that have been delegated domain-wide authority.",
 "flatPath": "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}",
 "httpMethod": "DELETE",
 "id": "gmail.users.settings.sendAs.delete",
@@ -2460,7 +2460,7 @@
 ]
 },
 "get": {
-"description": "Gets the specified send-as alias. Fails with an HTTP 404 error if the specified address is not a member of the collection.",
+"description": "Gets the specified send-as alias. Fails with an HTTP 404 error if the specified address is not a member of the collection. For more information, see [Manage aliases and signatures with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/alias_and_signature_settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}",
 "httpMethod": "GET",
 "id": "gmail.users.settings.sendAs.get",
@@ -2495,7 +2495,7 @@
 ]
 },
 "list": {
-"description": "Lists the send-as aliases for the specified account. The result includes the primary send-as address associated with the account as well as any custom \"from\" aliases.",
+"description": "Lists the send-as aliases for the specified account. The result includes the primary send-as address associated with the account as well as any custom \"from\" aliases. For more information, see [Manage aliases and signatures with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/alias_and_signature_settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/sendAs",
 "httpMethod": "GET",
 "id": "gmail.users.settings.sendAs.list",
@@ -2523,7 +2523,7 @@
 ]
 },
 "patch": {
-"description": "Patch the specified send-as alias.",
+"description": "Patch the specified send-as alias. For more information, see [Manage aliases and signatures with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/alias_and_signature_settings).",
 "flatPath": "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}",
 "httpMethod": "PATCH",
 "id": "gmail.users.settings.sendAs.patch",
@@ -2559,7 +2559,7 @@
 ]
 },
 "update": {
-"description": "Updates a send-as alias. If a signature is provided, Gmail will sanitize the HTML before saving it with the alias. Addresses other than the primary address for the account can only be updated by service account clients that have been delegated domain-wide authority.",
+"description": "Updates a send-as alias. If a signature is provided, Gmail will sanitize the HTML before saving it with the alias. For more information, see [Manage aliases and signatures with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/alias_and_signature_settings). Addresses other than the primary address for the account can only be updated by service account clients that have been delegated domain-wide authority.",
 "flatPath": "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}",
 "httpMethod": "PUT",
 "id": "gmail.users.settings.sendAs.update",
@@ -2595,7 +2595,7 @@
 ]
 },
 "verify": {
-"description": "Sends a verification email to the specified send-as alias address. The verification status must be `pending`. This method is only available to service account clients that have been delegated domain-wide authority.",
+"description": "Sends a verification email to the specified send-as alias address. The verification status must be `pending`. For more information, see [Manage aliases and signatures with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/alias_and_signature_settings). This method is only available to service account clients that have been delegated domain-wide authority.",
 "flatPath": "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/verify",
 "httpMethod": "POST",
 "id": "gmail.users.settings.sendAs.verify",
@@ -2628,7 +2628,7 @@
 "smimeInfo": {
 "methods": {
 "delete": {
-"description": "Deletes the specified S/MIME config for the specified send-as alias.",
+"description": "Deletes the specified S/MIME config for the specified send-as alias. For more information, see [Manage S/MIME certificates with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/smime_certs).",
 "flatPath": "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}",
 "httpMethod": "DELETE",
 "id": "gmail.users.settings.sendAs.smimeInfo.delete",
@@ -2665,7 +2665,7 @@
 ]
 },
 "get": {
-"description": "Gets the specified S/MIME config for the specified send-as alias.",
+"description": "Gets the specified S/MIME config for the specified send-as alias. For more information, see [Manage S/MIME certificates with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/smime_certs).",
 "flatPath": "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}",
 "httpMethod": "GET",
 "id": "gmail.users.settings.sendAs.smimeInfo.get",
@@ -2708,7 +2708,7 @@
 ]
 },
 "insert": {
-"description": "Insert (upload) the given S/MIME config for the specified send-as alias. Note that pkcs12 format is required for the key.",
+"description": "Insert (upload) the given S/MIME config for the specified send-as alias. Note that `pkcs12` format is required for the key. For more information, see [Manage S/MIME certificates with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/smime_certs).",
 "flatPath": "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo",
 "httpMethod": "POST",
 "id": "gmail.users.settings.sendAs.smimeInfo.insert",
@@ -2744,7 +2744,7 @@
 ]
 },
 "list": {
-"description": "Lists S/MIME configs for the specified send-as alias.",
+"description": "Lists S/MIME configs for the specified send-as alias. For more information, see [Manage S/MIME certificates with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/smime_certs).",
 "flatPath": "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo",
 "httpMethod": "GET",
 "id": "gmail.users.settings.sendAs.smimeInfo.list",
@@ -2780,7 +2780,7 @@
 ]
 },
 "setDefault": {
-"description": "Sets the default S/MIME config for the specified send-as alias.",
+"description": "Sets the default S/MIME config for the specified send-as alias. For more information, see [Manage S/MIME certificates with the Gmail API](https://developers.google.com/workspace/gmail/api/guides/smime_certs).",
 "flatPath": "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault",
 "httpMethod": "POST",
 "id": "gmail.users.settings.sendAs.smimeInfo.setDefault",
@@ -2825,7 +2825,7 @@
 "threads": {
 "methods": {
 "delete": {
-"description": "Immediately and permanently deletes the specified thread. Any messages that belong to the thread are also deleted. This operation cannot be undone. Prefer `threads.trash` instead.",
+"description": "Immediately and permanently deletes the specified thread. Any messages that belong to the thread are also deleted. This operation cannot be undone. Prefer `threads.trash` instead. For more information, see [Manage threads](https://developers.google.com/workspace/gmail/api/guides/threads).",
 "flatPath": "gmail/v1/users/{userId}/threads/{id}",
 "httpMethod": "DELETE",
 "id": "gmail.users.threads.delete",
@@ -2854,7 +2854,7 @@
 ]
 },
 "get": {
-"description": "Gets the specified thread.",
+"description": "Gets the specified thread. For more information, see [Manage threads](https://developers.google.com/workspace/gmail/api/guides/threads).",
 "flatPath": "gmail/v1/users/{userId}/threads/{id}",
 "httpMethod": "GET",
 "id": "gmail.users.threads.get",
@@ -2914,7 +2914,7 @@
 ]
 },
 "list": {
-"description": "Lists the threads in the user's mailbox.",
+"description": "Lists the threads in the user's mailbox. For more information, see [Manage threads](https://developers.google.com/workspace/gmail/api/guides/threads).",
 "flatPath": "gmail/v1/users/{userId}/threads",
 "httpMethod": "GET",
 "id": "gmail.users.threads.list",
@@ -2971,7 +2971,7 @@
 ]
 },
 "modify": {
-"description": "Modifies the labels applied to the thread. This applies to all messages in the thread.",
+"description": "Modifies the labels applied to the thread. This applies to all messages in the thread. For more information, see [Manage threads](https://developers.google.com/workspace/gmail/api/guides/threads).",
 "flatPath": "gmail/v1/users/{userId}/threads/{id}/modify",
 "httpMethod": "POST",
 "id": "gmail.users.threads.modify",
@@ -3007,7 +3007,7 @@
 ]
 },
 "trash": {
-"description": "Moves the specified thread to the trash. Any messages that belong to the thread are also moved to the trash.",
+"description": "Moves the specified thread to the trash. Any messages that belong to the thread are also moved to the trash. For more information, see [Manage threads](https://developers.google.com/workspace/gmail/api/guides/threads).",
 "flatPath": "gmail/v1/users/{userId}/threads/{id}/trash",
 "httpMethod": "POST",
 "id": "gmail.users.threads.trash",
@@ -3040,7 +3040,7 @@
 ]
 },
 "untrash": {
-"description": "Removes the specified thread from the trash. Any messages that belong to the thread are also removed from the trash.",
+"description": "Removes the specified thread from the trash. Any messages that belong to the thread are also removed from the trash. For more information, see [Manage threads](https://developers.google.com/workspace/gmail/api/guides/threads).",
 "flatPath": "gmail/v1/users/{userId}/threads/{id}/untrash",
 "httpMethod": "POST",
 "id": "gmail.users.threads.untrash",
@@ -3077,7 +3077,7 @@
 }
 }
 },
-"revision": "20260413",
+"revision": "20260427",
 "rootUrl": "https://gmail.googleapis.com/",
 "schemas": {
 "AutoForwarding": {
@@ -3374,7 +3374,7 @@
 "type": "array"
 },
 "forward": {
-"description": "Email address that the message should be forwarded to.",
+"description": "Email address that the message should be forwarded to. This effectively redirects the message to the address specified in this field, maintaining the original sender in the \"From\" field.",
 "type": "string"
 },
 "removeLabelIds": {
@@ -4205,7 +4205,7 @@
 "type": "object"
 },
 "SendAs": {
-"description": "Settings associated with a send-as alias, which can be either the primary login address associated with the account or a custom \"from\" address. Send-as aliases correspond to the \"Send Mail As\" feature in the web interface.",
+"description": "Settings associated with a send-as alias, which can be either the primary login address associated with the account or a custom \"from\" address. Send-as aliases correspond to the \"Send Mail As\" feature in the web interface. The send-as alias must be a valid email address.",
 "id": "SendAs",
 "properties": {
 "displayName": {