google-apis-gmail_v1 0.46.0 → 0.53.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21f474372e39827cc468cffeced87cd08ac3be96f7c051c275e745420e225818
-  data.tar.gz: 61cf4f187a095fc1838d98564b7fdd12fad2b558459aba6b71e3577f91fdfd17
+  metadata.gz: 7d4ccaada39f12bfff345379ac51b61388887bc8b9a6c322567b39af99582d46
+  data.tar.gz: 8e8497d7067ad19397785b963e98c1b08579bf645eb9c6e728576571652d6445
 SHA512:
-  metadata.gz: c088d7b7607b14f5c1ff1b5f0411b695823851d1a535c6fb91569382388a1638db6166e477d4bf6e28c31f82b216fae0172123229c8debfc23d83aea5b34e05e
-  data.tar.gz: cdf44576d199d832b15d61714c105e927c4dcf831780d5c636e552543c1e677d3771eb0c1a9f6ddffd7eeaa50e9f755cb0f5a3410687fd677e6a96d254132a09
+  metadata.gz: a8fb9beb4611f23bdd0a681e452cfebf8fb8ebdb4ef1750fd2e8e387f78ad19c1c6d25edbe8d7758dd31ccc5691376c4ba35354224806e5475cea7686d0d73a4
+  data.tar.gz: 71b2708afe55bcb55ef3b29db6ae759b9feef934da5a19c1e3e406dd4ce3b58a057abd3c53ccd7912c7f8e0af165b4179e96c6f4a2764ae82287f098e3a732d5

data/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Release history for google-apis-gmail_v1
 
+### v0.53.0 (2026-08-02)
+
+* Regenerated from discovery document revision 20260727
+
+### v0.52.0 (2026-06-14)
+
+* Regenerated using generator version 0.19.0
+
+### v0.51.0 (2026-05-31)
+
+* Regenerated from discovery document revision 20260525
+
+### 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
+
+### v0.47.0 (2025-12-07)
+
+* Regenerated from discovery document revision 20251201
+
 ### v0.46.0 (2025-11-16)
 
 * Regenerated from discovery document revision 20251110

data/OVERVIEW.md

@@ -83,7 +83,7 @@ The [product documentation](https://developers.google.com/workspace/gmail/api/)
 
 ## Supported Ruby versions
 
-This library is supported on Ruby 3.1+.
+This library is supported on Ruby 3.2+.
 
 Google provides official support for Ruby versions that are actively supported by Ruby Core -- that is, Ruby versions that are either in normal maintenance or in security maintenance, and not end of life. Older versions of Ruby _may_ still work, but are unsupported and not recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby support schedule.
 

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
@@ -895,12 +915,13 @@ module Google
         # 44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, \#cc3a21, #eaa041, #f2c960, #
         # 149e60, #3dc789, #3c78d8, #8e63ce, #e07798, \#ac2b16, #cf8933, #d5ae49, #
         # 0b804b, #2a9c68, #285bac, #653e9b, #b65775, \#822111, #a46a21, #aa8831, #
-        # 076239, #1a764d, #1c4587, #41236d, #83334c \#464646, #e7e7e7, #0d3472, #b6cff5,
-        # #0d3b44, #98d7e4, #3d188e, #e3d7ff, \#711a36, #fbd3e0, #8a1c0a, #f2b2a8, #
-        # 7a2e0b, #ffc8af, #7a4706, #ffdeb5, \#594c05, #fbe983, #684e07, #fdedc1, #
-        # 0b4f30, #b3efd3, #04502e, #a2dcc1, \#c2c2c2, #4986e7, #2da2bb, #b99aff, #
-        # 994a64, #f691b2, #ff7537, #ffad46, \#662e37, #ebdbde, #cca6ac, #094228, #
-        # 42d692, #16a765
+        # 076239, #1a764d, #1c4587, #41236d, #83334c, \#464646, #e7e7e7, #0d3472, #
+        # b6cff5, #0d3b44, #98d7e4, #3d188e, #e3d7ff, \#711a36, #fbd3e0, #8a1c0a, #
+        # f2b2a8, #7a2e0b, #ffc8af, #7a4706, #ffdeb5, \#594c05, #fbe983, #684e07, #
+        # fdedc1, #0b4f30, #b3efd3, #04502e, #a2dcc1, \#c2c2c2, #4986e7, #2da2bb, #
+        # b99aff, #994a64, #f691b2, #ff7537, #ffad46, \#662e37, #ebdbde, #cca6ac, #
+        # 094228, #42d692, #16a765, #757575, #1e53b8, \#007286, #7858c3, #c2185b, #
+        # d93025, #54240e, #633e04, #521d28, #202124, \#083018
         # Corresponds to the JSON property `backgroundColor`
         # @return [String]
         attr_accessor :background_color
@@ -915,11 +936,13 @@ module Google
         # 6d9eeb, #b694e8, #f7a7c0, \#cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #
         # 3c78d8, #8e63ce, #e07798, \#ac2b16, #cf8933, #d5ae49, #0b804b, #2a9c68, #
         # 285bac, #653e9b, #b65775, \#822111, #a46a21, #aa8831, #076239, #1a764d, #
-        # 1c4587, #41236d, #83334c \#464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #98d7e4,
-        # #3d188e, #e3d7ff, \#711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #
-        # 7a4706, #ffdeb5, \#594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #b3efd3, #
-        # 04502e, #a2dcc1, \#c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #
-        # ff7537, #ffad46, \#662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765
+        # 1c4587, #41236d, #83334c, \#464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #
+        # 98d7e4, #3d188e, #e3d7ff, \#711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #
+        # ffc8af, #7a4706, #ffdeb5, \#594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #
+        # b3efd3, #04502e, #a2dcc1, \#c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #
+        # f691b2, #ff7537, #ffad46, \#662e37, #ebdbde, #cca6ac, #094228, #42d692, #
+        # 16a765, #757575, #1e53b8, \#007286, #7858c3, #c2185b, #d93025, #54240e, #
+        # 633e04, #521d28, #202124, \#083018
         # Corresponds to the JSON property `textColor`
         # @return [String]
         attr_accessor :text_color
@@ -1278,7 +1301,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
@@ -1314,7 +1339,8 @@ module Google
       
         # The entire email message in an RFC 2822 formatted and base64url encoded string.
         # Returned in `messages.get` and `drafts.get` responses when the `format=RAW`
-        # parameter is supplied.
+        # parameter is supplied. @required gmail.users.drafts.create gmail.users.drafts.
+        # update
         # Corresponds to the JSON property `raw`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -1481,12 +1507,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`
@@ -1499,7 +1541,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
@@ -1609,7 +1653,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.46.0"
+      GEM_VERSION = "0.53.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.18.0"
+      GENERATOR_VERSION = "0.19.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20251110"
+      REVISION = "20260727"
     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,6 +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 150 MB.
         # @param [String] user_id
         #   The user's email address. The special value `me` can be used to indicate the
         #   authenticated user.
@@ -865,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.
@@ -915,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
@@ -971,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.
@@ -1009,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.
@@ -1159,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.
@@ -1190,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.
@@ -1221,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.
@@ -1252,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.
@@ -1283,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.
@@ -1315,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.
@@ -1351,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.
@@ -1385,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.
@@ -1423,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.
@@ -1457,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.
@@ -1733,6 +1787,10 @@ module Google
         #   The requester's primary email address. To indicate the authenticated user, you
         #   can use the special value `me`.
         # @param [Google::Apis::GmailV1::CseKeyPair] cse_key_pair_object
+        # @param [String] chain_validation
+        #   The type of certificate chain validation to perform at creation. The request
+        #   will be rejected if the uploaded chain fails to satisfy the requested
+        #   validation checks. When unspecified, this parameter defaults to `all`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1750,13 +1808,14 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def create_user_setting_cse_keypair(user_id, cse_key_pair_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+        def create_user_setting_cse_keypair(user_id, cse_key_pair_object = nil, chain_validation: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:post, 'gmail/v1/users/{userId}/settings/cse/keypairs', options)
           command.request_representation = Google::Apis::GmailV1::CseKeyPair::Representation
           command.request_object = cse_key_pair_object
           command.response_representation = Google::Apis::GmailV1::CseKeyPair::Representation
           command.response_class = Google::Apis::GmailV1::CseKeyPair
           command.params['userId'] = user_id unless user_id.nil?
+          command.query['chainValidation'] = chain_validation unless chain_validation.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -1998,15 +2057,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.
@@ -2041,10 +2101,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.
@@ -2076,10 +2138,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.
@@ -2113,8 +2176,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.
@@ -2145,7 +2210,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.
@@ -2179,7 +2246,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.
@@ -2211,7 +2280,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.
@@ -2245,7 +2315,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.
@@ -2279,8 +2351,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.
@@ -2315,8 +2389,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.
@@ -2348,7 +2424,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.
@@ -2382,7 +2460,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.
@@ -2419,8 +2499,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
@@ -2456,8 +2538,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.
@@ -2490,7 +2574,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.
@@ -2526,7 +2612,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.
@@ -2557,7 +2645,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.
@@ -2595,9 +2685,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.
@@ -2635,8 +2727,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.
@@ -2668,7 +2763,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.
@@ -2704,7 +2801,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.
@@ -2743,7 +2842,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.
@@ -2781,7 +2882,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.
@@ -2816,7 +2919,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.
@@ -2854,7 +2959,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.
@@ -2886,7 +2992,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.
@@ -2926,7 +3033,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.
@@ -2977,7 +3085,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.
@@ -3015,7 +3124,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.
@@ -3050,7 +3160,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.46.0
+  version: 0.53.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.46.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-gmail_v1/v0.53.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-gmail_v1
 rdoc_options: []
 require_paths:
@@ -66,7 +66,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="