google-apis-gmail_v1 0.48.0 → 0.50.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0f425de0b273e36c19da0edb538f9bb0f112bfe3c27878a58d4c6333daf9d47
-  data.tar.gz: 7cea496de0354bc231073dedf83e1633d1a4b4e48823c51010bef145377bf797
+  metadata.gz: 67ad2f52dcabcfec8813c6a51386129488980cd879c35a10725058996b34c2c3
+  data.tar.gz: d0c1b920bac90bf273565f636808de25cb6782d03d29a670eacd8e2758461e01
 SHA512:
-  metadata.gz: 56503b372e3c748855e6d844edfe6ed2545c1ad9f3f6b2b79d59735a7140fa12fdd19984e19b603799d3f6be27144957d5863ff5670a23aba321ae3697daaf36
-  data.tar.gz: d96f9ddf6528df67b5ff86929186861c5786d37c19de1de4566d0d0fe638e091b87336aa75f6aea809aff2458492643e1a0d31a70781ab6c4ba3356400c05110
+  metadata.gz: 36a8ae0559f8ddc280a0a2888172122e77330a3028f9adcf4fa1c80b5fed20099ca6e6434416766f2e085ec3c474dc262342edcdc7557a05917a0d9e96264984
+  data.tar.gz: 63ad60d7e0e5f0f0e338b024077b2a16c4f8049723494d58f39e11a59525499321c47e5a29037db09638621c89998b538c1c638a9422c28ede421dfdc54ca107

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-gmail_v1
 
+### v0.50.0 (2026-05-17)
+
+* Regenerated from discovery document revision 20260511
+
+### v0.49.0 (2026-05-03)
+
+* Regenerated from discovery document revision 20260427
+
 ### v0.48.0 (2026-04-19)
 
 * Regenerated from discovery document revision 20260413

data/lib/google/apis/gmail_v1/classes.rb

@@ -78,6 +78,17 @@ module Google
       class BatchModifyMessagesRequest
         include Google::Apis::Core::Hashable
       
+        # A list of Classification Label values to add. If a Classification Label with
+        # the same label ID is already applied to the message, fields with existing
+        # field IDs will be updated and fields with new field IDs will be added. There's
+        # a limit of 20 Classification Label values per request. If the message is
+        # already classified and the final total number of Classification Label values
+        # exceeds the maximum allowed number of Classification Label values per message,
+        # the modification fails.
+        # Corresponds to the JSON property `addClassificationLabels`
+        # @return [Array<Google::Apis::GmailV1::ClassificationLabelValue>]
+        attr_accessor :add_classification_labels
+      
         # A list of label IDs to add to messages.
         # Corresponds to the JSON property `addLabelIds`
         # @return [Array<String>]
@@ -88,6 +99,11 @@ module Google
         # @return [Array<String>]
         attr_accessor :ids
       
+        # A list of Classification Label values to remove from messages.
+        # Corresponds to the JSON property `removeClassificationLabelIds`
+        # @return [Array<String>]
+        attr_accessor :remove_classification_label_ids
+      
         # A list of label IDs to remove from messages.
         # Corresponds to the JSON property `removeLabelIds`
         # @return [Array<String>]
@@ -99,8 +115,10 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @add_classification_labels = args[:add_classification_labels] if args.key?(:add_classification_labels)
           @add_label_ids = args[:add_label_ids] if args.key?(:add_label_ids)
           @ids = args[:ids] if args.key?(:ids)
+          @remove_classification_label_ids = args[:remove_classification_label_ids] if args.key?(:remove_classification_label_ids)
           @remove_label_ids = args[:remove_label_ids] if args.key?(:remove_label_ids)
         end
       end
@@ -437,7 +455,9 @@ module Google
         # @return [Array<String>]
         attr_accessor :add_label_ids
       
-        # Email address that the message should be forwarded to.
+        # 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.
         # Corresponds to the JSON property `forward`
         # @return [String]
         attr_accessor :forward
@@ -1279,7 +1299,9 @@ module Google
         # schemas can be queried using the Google Drive Labels API. Each classification
         # label ID must be unique. If duplicate IDs are provided, only one will be
         # retained, and the selection is arbitrary. Only used for Google Workspace
-        # accounts.
+        # accounts. There's a limit of 20 Classification Label values per request. If
+        # the Classification Label values exceeds the maximum allowed number, the
+        # request fails.
         # Corresponds to the JSON property `classificationLabelValues`
         # @return [Array<Google::Apis::GmailV1::ClassificationLabelValue>]
         attr_accessor :classification_label_values
@@ -1482,12 +1504,28 @@ module Google
       class ModifyMessageRequest
         include Google::Apis::Core::Hashable
       
+        # A list of classification label values to add. If a Classification Label with
+        # the same label ID is already applied to the message, fields with existing
+        # field IDs will be updated and fields with new field IDs will be added. There's
+        # a limit of 20 Classification Label values per request. If the message is
+        # already classified and the final total number of Classification Label values
+        # exceeds the maximum allowed number of Classification Label values per message,
+        # the modification fails.
+        # Corresponds to the JSON property `addClassificationLabels`
+        # @return [Array<Google::Apis::GmailV1::ClassificationLabelValue>]
+        attr_accessor :add_classification_labels
+      
         # A list of IDs of labels to add to this message. You can add up to 100 labels
         # with each update.
         # Corresponds to the JSON property `addLabelIds`
         # @return [Array<String>]
         attr_accessor :add_label_ids
       
+        # A list of Classification Label values to remove from this message.
+        # Corresponds to the JSON property `removeClassificationLabelIds`
+        # @return [Array<String>]
+        attr_accessor :remove_classification_label_ids
+      
         # A list IDs of labels to remove from this message. You can remove up to 100
         # labels with each update.
         # Corresponds to the JSON property `removeLabelIds`
@@ -1500,7 +1538,9 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @add_classification_labels = args[:add_classification_labels] if args.key?(:add_classification_labels)
           @add_label_ids = args[:add_label_ids] if args.key?(:add_label_ids)
+          @remove_classification_label_ids = args[:remove_classification_label_ids] if args.key?(:remove_classification_label_ids)
           @remove_label_ids = args[:remove_label_ids] if args.key?(:remove_label_ids)
         end
       end
@@ -1610,7 +1650,8 @@ module Google
       
       # 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.
+      # aliases correspond to the "Send Mail As" feature in the web interface. The
+      # send-as alias must be a valid email address.
       class SendAs
         include Google::Apis::Core::Hashable
       

data/lib/google/apis/gmail_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module GmailV1
       # Version of the google-apis-gmail_v1 gem
-      GEM_VERSION = "0.48.0"
+      GEM_VERSION = "0.50.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.18.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20260413"
+      REVISION = "20260511"
     end
   end
 end

data/lib/google/apis/gmail_v1/representations.rb

@@ -377,8 +377,11 @@ module Google
       class BatchModifyMessagesRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          collection :add_classification_labels, as: 'addClassificationLabels', class: Google::Apis::GmailV1::ClassificationLabelValue, decorator: Google::Apis::GmailV1::ClassificationLabelValue::Representation
+      
           collection :add_label_ids, as: 'addLabelIds'
           collection :ids, as: 'ids'
+          collection :remove_classification_label_ids, as: 'removeClassificationLabelIds'
           collection :remove_label_ids, as: 'removeLabelIds'
         end
       end
@@ -774,7 +777,10 @@ module Google
       class ModifyMessageRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          collection :add_classification_labels, as: 'addClassificationLabels', class: Google::Apis::GmailV1::ClassificationLabelValue, decorator: Google::Apis::GmailV1::ClassificationLabelValue::Representation
+      
           collection :add_label_ids, as: 'addLabelIds'
+          collection :remove_classification_label_ids, as: 'removeClassificationLabelIds'
           collection :remove_label_ids, as: 'removeLabelIds'
         end
       end

data/lib/google/apis/gmail_v1/service.rb

@@ -83,7 +83,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Stop receiving push notifications for the given user mailbox.
+        # 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).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -112,7 +114,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Set up or update a push notification watch on the given user mailbox.
+        # 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).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -146,7 +150,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new draft with the `DRAFT` label.
+        # 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).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -191,7 +197,8 @@ module Google
         end
         
         # Immediately and permanently deletes the specified draft. Does not simply trash
-        # it.
+        # it. For more information, see [Create and send draft emails](https://
+        # developers.google.com/workspace/gmail/api/guides/drafts).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -223,7 +230,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the specified draft.
+        # Gets the specified draft. For more information, see [Create and send draft
+        # emails](https://developers.google.com/workspace/gmail/api/guides/drafts).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -260,7 +268,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the drafts in the user's mailbox.
+        # 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).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -307,7 +317,8 @@ module Google
         end
         
         # Sends the specified, existing draft to the recipients in the `To`, `Cc`, and `
-        # Bcc` headers.
+        # Bcc` headers. For more information, see [Create and send draft emails](https://
+        # developers.google.com/workspace/gmail/api/guides/drafts).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -351,7 +362,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Replaces a draft's content.
+        # Replaces a draft's content. For more information, see [Create and send draft
+        # emails](https://developers.google.com/workspace/gmail/api/guides/drafts).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -399,7 +411,9 @@ module Google
         end
         
         # Lists the history of all changes to the given mailbox. History results are
-        # returned in chronological order (increasing `historyId`).
+        # returned in chronological order (increasing `historyId`). For more information,
+        # see [Synchronize clients with Gmail](https://developers.google.com/workspace/
+        # gmail/api/guides/sync).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -455,7 +469,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new label.
+        # Creates a label. For more information, see [Manage labels](https://developers.
+        # google.com/workspace/gmail/api/guides/labels).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -490,7 +505,9 @@ module Google
         end
         
         # Immediately and permanently deletes the specified label and removes it from
-        # any messages and threads that it is applied to.
+        # any messages and threads that it's applied to. For more information, see [
+        # Manage labels](https://developers.google.com/workspace/gmail/api/guides/labels)
+        # .
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -522,7 +539,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the specified label.
+        # Gets the specified label. For more information, see [Manage labels](https://
+        # developers.google.com/workspace/gmail/api/guides/labels).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -556,7 +574,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists all labels in the user's mailbox.
+        # Lists all labels in the user's mailbox. For more information, see [Manage
+        # labels](https://developers.google.com/workspace/gmail/api/guides/labels).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -587,7 +606,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Patch the specified label.
+        # Patch the specified label. For more information, see [Manage labels](https://
+        # developers.google.com/workspace/gmail/api/guides/labels).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -624,7 +644,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the specified label.
+        # Updates the specified label. For more information, see [Manage labels](https://
+        # developers.google.com/workspace/gmail/api/guides/labels).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -694,7 +715,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Modifies the labels on the specified messages.
+        # Modifies the labels and the Classification Label values on the specified
+        # messages. For administrators modifying messages for users in their
+        # organization, requests require authorization with a [service account](https://
+        # developers.google.com/identity/protocols/OAuth2ServiceAccount) that has [
+        # domain-wide delegation authority](https://developers.google.com/identity/
+        # protocols/OAuth2ServiceAccount#delegatingauthority) to impersonate users with
+        # the `https://www.googleapis.com/auth/gmail.modify.restricted` scope.
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -805,7 +832,7 @@ module Google
         # 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.
+        # Note that the maximum size of the message is 150 MB.
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -866,6 +893,8 @@ module Google
         
         # 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).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -916,8 +945,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the messages in the user's mailbox. For example usage, see [List Gmail
-        # messages](https://developers.google.com/workspace/gmail/api/guides/list-
+        # 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).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
@@ -972,7 +1001,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Modifies the labels on the specified message.
+        # Modifies the labels and the Classification Label values on the specified
+        # message. For administrators modifying message for users in their organization,
+        # requests require authorization with a [service account](https://developers.
+        # google.com/identity/protocols/OAuth2ServiceAccount) that has [domain-wide
+        # delegation authority](https://developers.google.com/identity/protocols/
+        # OAuth2ServiceAccount#delegatingauthority) to impersonate users with the `https:
+        # //www.googleapis.com/auth/gmail.modify.restricted` scope.
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -1010,8 +1045,8 @@ module Google
         end
         
         # 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).
+        # headers. For more information, see [Create and send email messages](https://
+        # developers.google.com/workspace/gmail/api/guides/sending).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -1160,7 +1195,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the auto-forwarding setting for the specified account.
+        # 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).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -1191,7 +1228,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets IMAP settings.
+        # 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).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -1222,7 +1261,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets language settings.
+        # Gets language settings. For more information, see [Manage language settings](
+        # https://developers.google.com/workspace/gmail/api/guides/language-settings).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -1253,7 +1293,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets POP settings.
+        # 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).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -1284,7 +1326,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets vacation responder settings.
+        # 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).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -1316,9 +1360,10 @@ module Google
         end
         
         # 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.
+        # 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.
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -1352,7 +1397,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates IMAP settings.
+        # 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).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -1386,11 +1433,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # 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.
+        # 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.
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -1424,7 +1473,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates POP settings.
+        # 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).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -1458,7 +1509,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates vacation responder settings.
+        # 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).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -1999,15 +2052,16 @@ module Google
         
         # 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.
+        # 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.
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2042,10 +2096,12 @@ module Google
         end
         
         # 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.
+        # 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.
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2077,10 +2133,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # 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.
+        # 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.
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2114,8 +2171,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the delegates for the specified account. This method is only available
-        # to service account clients that have been delegated domain-wide authority.
+        # 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.
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2146,7 +2205,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a filter. Note: you can only create a maximum of 1,000 filters.
+        # 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).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2180,7 +2241,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Immediately and permanently deletes the specified filter.
+        # Immediately and permanently deletes the specified filter. For more information,
+        # see [Manage Gmail filters](https://developers.google.com/workspace/gmail/api/
+        # guides/filter_settings).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2212,7 +2275,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a filter.
+        # Gets a filter. For more information, see [Manage Gmail filters](https://
+        # developers.google.com/workspace/gmail/api/guides/filter_settings).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2246,7 +2310,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the message filters of a Gmail user.
+        # 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).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2280,8 +2346,10 @@ module Google
         # 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.
+        # 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.
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2316,8 +2384,10 @@ module Google
         end
         
         # 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.
+        # 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.
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2349,7 +2419,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the specified forwarding address.
+        # Gets the specified forwarding address. For more information, see [Manage email
+        # forwarding](https://developers.google.com/workspace/gmail/api/guides/
+        # forwarding_settings).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2383,7 +2455,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the forwarding addresses for the specified account.
+        # 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).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2420,8 +2494,10 @@ module Google
         # 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
+        # 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.
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
@@ -2457,8 +2533,10 @@ module Google
         end
         
         # 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.
+        # 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.
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2491,7 +2569,9 @@ module Google
         end
         
         # Gets the specified send-as alias. Fails with an HTTP 404 error if the
-        # specified address is not a member of the collection.
+        # 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).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2527,7 +2607,9 @@ module Google
         
         # 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.
+        # 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).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2558,7 +2640,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Patch the specified send-as alias.
+        # 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).
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2596,9 +2680,11 @@ module Google
         end
         
         # 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.
+        # 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.
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2636,8 +2722,11 @@ module Google
         end
         
         # 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.
+        # 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.
         # @param [String] user_id
         #   User's email address. The special value "me" can be used to indicate the
         #   authenticated user.
@@ -2669,7 +2758,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified S/MIME config for the specified send-as alias.
+        # 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).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -2705,7 +2796,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the specified S/MIME config for the specified send-as alias.
+        # 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).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -2744,7 +2837,9 @@ module Google
         end
         
         # Insert (upload) the given S/MIME config for the specified send-as alias. Note
-        # that pkcs12 format is required for the key.
+        # 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).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -2782,7 +2877,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists S/MIME configs for the specified send-as alias.
+        # 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).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -2817,7 +2914,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the default S/MIME config for the specified send-as alias.
+        # 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).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -2855,7 +2954,8 @@ module Google
         
         # 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.
+        # `threads.trash` instead. For more information, see [Manage threads](https://
+        # developers.google.com/workspace/gmail/api/guides/threads).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -2887,7 +2987,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the specified thread.
+        # Gets the specified thread. For more information, see [Manage threads](https://
+        # developers.google.com/workspace/gmail/api/guides/threads).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -2927,7 +3028,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the threads in the user's mailbox.
+        # Lists the threads in the user's mailbox. For more information, see [Manage
+        # threads](https://developers.google.com/workspace/gmail/api/guides/threads).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -2978,7 +3080,8 @@ module Google
         end
         
         # Modifies the labels applied to the thread. This applies to all messages in the
-        # thread.
+        # thread. For more information, see [Manage threads](https://developers.google.
+        # com/workspace/gmail/api/guides/threads).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -3016,7 +3119,8 @@ module Google
         end
         
         # Moves the specified thread to the trash. Any messages that belong to the
-        # thread are also moved to the trash.
+        # thread are also moved to the trash. For more information, see [Manage threads](
+        # https://developers.google.com/workspace/gmail/api/guides/threads).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -3051,7 +3155,8 @@ module Google
         end
         
         # Removes the specified thread from the trash. Any messages that belong to the
-        # thread are also removed from the trash.
+        # thread are also removed from the trash. For more information, see [Manage
+        # threads](https://developers.google.com/workspace/gmail/api/guides/threads).
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-gmail_v1
 version: !ruby/object:Gem::Version
-  version: 0.48.0
+  version: 0.50.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-gmail_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-gmail_v1/v0.48.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-gmail_v1/v0.50.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-gmail_v1
 rdoc_options: []
 require_paths: