feat: Automated regeneration of gmail v1 client (googleapis#23515)

Auto-created at 2025-06-22 10:33:19 +0000 using the toys pull request generator.

Author: yoshi-code-bot

generated/google-apis-gmail_v1/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release history for google-apis-gmail_v1
 
+### v0.44.0 (2025-06-22)
+
+* Regenerated from discovery document revision 20250616
+* Regenerated using generator version 0.18.0
+
 ### v0.43.0 (2025-05-04)
 
 * Regenerated using generator version 0.17.0

generated/google-apis-gmail_v1/lib/google/apis/gmail_v1/classes.rb

@@ -108,6 +108,15 @@ def update!(**args)
       # The client-side encryption (CSE) configuration for the email address of an
       # authenticated user. Gmail uses CSE configurations to save drafts of client-
       # side encrypted email messages, and to sign and send encrypted email messages.
+      # For administrators managing identities and keypairs 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.settings.basic` scope. For users
+      # managing their own identities and keypairs, requests require [hardware key
+      # encryption](https://support.google.com/a/answer/14153163) turned on and
+      # configured.
       class CseIdentity
         include Google::Apis::Core::Hashable
 
@@ -145,7 +154,15 @@ def update!(**args)
       # key pair to complete the following tasks: - Sign outgoing client-side
       # encrypted messages. - Save and reopen drafts of client-side encrypted messages.
       # - Save and reopen sent messages. - Decrypt incoming or archived S/MIME
-      # messages.
+      # messages. For administrators managing identities and keypairs 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.settings.basic` scope. For users
+      # managing their own identities and keypairs, requests require [hardware key
+      # encryption](https://support.google.com/a/answer/14153163) turned on and
+      # configured.
       class CseKeyPair
         include Google::Apis::Core::Hashable
 
@@ -210,7 +227,11 @@ def update!(**args)
       class CsePrivateKeyMetadata
         include Google::Apis::Core::Hashable
 
-        # Metadata for hardware keys.
+        # Metadata for hardware keys. If [hardware key encryption](https://support.
+        # google.com/a/answer/14153163) is set up for the Google Workspace organization,
+        # users can optionally store their private key on their smart card and use it to
+        # sign and decrypt email messages in Gmail by inserting their smart card into a
+        # reader attached to their Windows device.
         # Corresponds to the JSON property `hardwareKeyMetadata`
         # @return [Google::Apis::GmailV1::HardwareKeyMetadata]
         attr_accessor :hardware_key_metadata
@@ -485,7 +506,11 @@ def update!(**args)
         end
       end
 
-      # Metadata for hardware keys.
+      # Metadata for hardware keys. If [hardware key encryption](https://support.
+      # google.com/a/answer/14153163) is set up for the Google Workspace organization,
+      # users can optionally store their private key on their smart card and use it to
+      # sign and decrypt email messages in Gmail by inserting their smart card into a
+      # reader attached to their Windows device.
       class HardwareKeyMetadata
         include Google::Apis::Core::Hashable
 

generated/google-apis-gmail_v1/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.43.0"
+      GEM_VERSION = "0.44.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.17.0"
+      GENERATOR_VERSION = "0.18.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20250331"
+      REVISION = "20250616"
     end
   end
 end

generated/google-apis-gmail_v1/lib/google/apis/gmail_v1/service.rb

@@ -1492,7 +1492,15 @@ def update_user_setting_vacation(user_id, vacation_settings_object = nil, fields
         # Creates and configures a client-side encryption identity that's authorized to
         # send mail from the user account. Google publishes the S/MIME certificate to a
         # shared domain-wide directory so that people within a Google Workspace
-        # organization can encrypt and send mail to the identity.
+        # organization can encrypt and send mail to the identity. For administrators
+        # managing identities and keypairs 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.settings.basic` scope. For users managing
+        # their own identities and keypairs, requests require [hardware key encryption](
+        # https://support.google.com/a/answer/14153163) turned on and configured.
         # @param [String] user_id
         #   The requester's primary email address. To indicate the authenticated user, you
         #   can use the special value `me`.
@@ -1529,7 +1537,15 @@ def create_user_setting_cse_identity(user_id, cse_identity_object = nil, fields:
         # Deletes a client-side encryption identity. The authenticated user can no
         # longer use the identity to send encrypted messages. You cannot restore the
         # identity after you delete it. Instead, use the CreateCseIdentity method to
-        # create another identity with the same configuration.
+        # create another identity with the same configuration. For administrators
+        # managing identities and keypairs 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.settings.basic` scope. For users managing
+        # their own identities and keypairs, requests require [hardware key encryption](
+        # https://support.google.com/a/answer/14153163) turned on and configured.
         # @param [String] user_id
         #   The requester's primary email address. To indicate the authenticated user, you
         #   can use the special value `me`.
@@ -1562,7 +1578,15 @@ def delete_user_setting_cse_identity(user_id, cse_email_address, fields: nil, qu
           execute_or_queue_command(command, &block)
         end
 
-        # Retrieves a client-side encryption identity configuration.
+        # Retrieves a client-side encryption identity configuration. For administrators
+        # managing identities and keypairs 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.settings.basic` scope. For users managing
+        # their own identities and keypairs, requests require [hardware key encryption](
+        # https://support.google.com/a/answer/14153163) turned on and configured.
         # @param [String] user_id
         #   The requester's primary email address. To indicate the authenticated user, you
         #   can use the special value `me`.
@@ -1597,7 +1621,16 @@ def get_user_setting_cse_identity(user_id, cse_email_address, fields: nil, quota
           execute_or_queue_command(command, &block)
         end
 
-        # Lists the client-side encrypted identities for an authenticated user.
+        # Lists the client-side encrypted identities for an authenticated user. For
+        # administrators managing identities and keypairs 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.settings.basic` scope. For users
+        # managing their own identities and keypairs, requests require [hardware key
+        # encryption](https://support.google.com/a/answer/14153163) turned on and
+        # configured.
         # @param [String] user_id
         #   The requester's primary email address. To indicate the authenticated user, you
         #   can use the special value `me`.
@@ -1638,7 +1671,16 @@ def list_user_setting_cse_identities(user_id, page_size: nil, page_token: nil, f
 
         # Associates a different key pair with an existing client-side encryption
         # identity. The updated key pair must validate against Google's [S/MIME
-        # certificate profiles](https://support.google.com/a/answer/7300887).
+        # certificate profiles](https://support.google.com/a/answer/7300887). For
+        # administrators managing identities and keypairs 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.settings.basic` scope. For users
+        # managing their own identities and keypairs, requests require [hardware key
+        # encryption](https://support.google.com/a/answer/14153163) turned on and
+        # configured.
         # @param [String] user_id
         #   The requester's primary email address. To indicate the authenticated user, you
         #   can use the special value `me`.
@@ -1676,7 +1718,15 @@ def patch_user_setting_cse_identity(user_id, email_address, cse_identity_object
         end
 
         # Creates and uploads a client-side encryption S/MIME public key certificate
-        # chain and private key metadata for the authenticated user.
+        # chain and private key metadata for the authenticated user. For administrators
+        # managing identities and keypairs 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.settings.basic` scope. For users managing
+        # their own identities and keypairs, requests require [hardware key encryption](
+        # https://support.google.com/a/answer/14153163) turned on and configured.
         # @param [String] user_id
         #   The requester's primary email address. To indicate the authenticated user, you
         #   can use the special value `me`.
@@ -1714,7 +1764,15 @@ def create_user_setting_cse_keypair(user_id, cse_key_pair_object = nil, fields:
         # longer use the key pair to decrypt incoming CSE message texts or sign outgoing
         # CSE mail. To regain access, use the EnableCseKeyPair to turn on the key pair.
         # After 30 days, you can permanently delete the key pair by using the
-        # ObliterateCseKeyPair method.
+        # ObliterateCseKeyPair method. For administrators managing identities and
+        # keypairs 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.settings.basic` scope. For users managing their own identities and
+        # keypairs, requests require [hardware key encryption](https://support.google.
+        # com/a/answer/14153163) turned on and configured.
         # @param [String] user_id
         #   The requester's primary email address. To indicate the authenticated user, you
         #   can use the special value `me`.
@@ -1752,7 +1810,16 @@ def disable_keypair_cse_key_pair(user_id, key_pair_id, disable_cse_key_pair_requ
         end
 
         # Turns on a client-side encryption key pair that was turned off. The key pair
-        # becomes active again for any associated client-side encryption identities.
+        # becomes active again for any associated client-side encryption identities. For
+        # administrators managing identities and keypairs 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.settings.basic` scope. For users
+        # managing their own identities and keypairs, requests require [hardware key
+        # encryption](https://support.google.com/a/answer/14153163) turned on and
+        # configured.
         # @param [String] user_id
         #   The requester's primary email address. To indicate the authenticated user, you
         #   can use the special value `me`.
@@ -1789,7 +1856,15 @@ def enable_keypair_cse_key_pair(user_id, key_pair_id, enable_cse_key_pair_reques
           execute_or_queue_command(command, &block)
         end
 
-        # Retrieves an existing client-side encryption key pair.
+        # Retrieves an existing client-side encryption key pair. For administrators
+        # managing identities and keypairs 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.settings.basic` scope. For users managing
+        # their own identities and keypairs, requests require [hardware key encryption](
+        # https://support.google.com/a/answer/14153163) turned on and configured.
         # @param [String] user_id
         #   The requester's primary email address. To indicate the authenticated user, you
         #   can use the special value `me`.
@@ -1823,7 +1898,16 @@ def get_user_setting_cse_keypair(user_id, key_pair_id, fields: nil, quota_user:
           execute_or_queue_command(command, &block)
         end
 
-        # Lists client-side encryption key pairs for an authenticated user.
+        # Lists client-side encryption key pairs for an authenticated user. For
+        # administrators managing identities and keypairs 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.settings.basic` scope. For users
+        # managing their own identities and keypairs, requests require [hardware key
+        # encryption](https://support.google.com/a/answer/14153163) turned on and
+        # configured.
         # @param [String] user_id
         #   The requester's primary email address. To indicate the authenticated user, you
         #   can use the special value `me`.
@@ -1867,7 +1951,15 @@ def list_user_setting_cse_keypairs(user_id, page_size: nil, page_token: nil, fie
         # days. To turn off a key pair, use the DisableCseKeyPair method. Gmail can't
         # restore or decrypt any messages that were encrypted by an obliterated key.
         # Authenticated users and Google Workspace administrators lose access to reading
-        # the encrypted messages.
+        # the encrypted messages. For administrators managing identities and keypairs
+        # 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.settings.basic` scope. For users managing their own identities and
+        # keypairs, requests require [hardware key encryption](https://support.google.
+        # com/a/answer/14153163) turned on and configured.
         # @param [String] user_id
         #   The requester's primary email address. To indicate the authenticated user, you
         #   can use the special value `me`.