google-apis-gmail_v1 0.20.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 52d54d98a33bcb4321e1529c1b15c8176d3067344fb6f715e1eb5f9031088023
-  data.tar.gz: d3de37d7809df84c0a79d7babe9606bbc4b3177d1cf5d89c80515f8fa8c175c2
+  metadata.gz: '0414582245300ecf8d2a89cea73b7fccc144452c17a4ee6bf12b747a053b1609'
+  data.tar.gz: 459962a61d9135e9f91f57e5404a36bc4ecae6141e4867004fce0b2466503d97
 SHA512:
-  metadata.gz: de0d7c57889a42fa97d8ffcdd28b34a115657838798be386400cbfcdb3cb83eed90e75702a38698c9dcef348e61784272b914888bfb337dc3c2555d4db903516
-  data.tar.gz: 3e86dbb3be799bf2cc09294442aaccbee1036438cf6e2147e5abee67974114c78312b0b25ab324be5e25347377a085b3ee498bff2305ebc88e342af840db4bed
+  metadata.gz: 6d75dd5d09ae07e156fbe81a0aacaec4d88fe0147b2331570a26db1253388d4dd78dd61eaec25df9176f1526546f04bc2fa8131cbfb57f134924471548911593
+  data.tar.gz: dfcafedfbf4885343fd63fb7da7b39c3373719c20722a3d05db0294ec63877c52a84021127b4d2e319bd0acb6f006500dce05be64d32415f7c16df6f27cdee7e

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-gmail_v1
 
+### v0.21.0 (2022-12-22)
+
+* Regenerated from discovery document revision 20221219
+
 ### v0.20.0 (2022-10-27)
 
 * Regenerated using generator version 0.11.0

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

@@ -105,6 +105,128 @@ module Google
         end
       end
       
+      # [Beta](https://workspace.google.com/terms/service-terms/index.html). 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.
+      class CseIdentity
+        include Google::Apis::Core::Hashable
+      
+        # The email address for the sending identity. The email address must be the
+        # primary email address of the authenticated user.
+        # Corresponds to the JSON property `emailAddress`
+        # @return [String]
+        attr_accessor :email_address
+      
+        # If a key pair is associated, the identifier of the key pair, CseKeyPair.
+        # Corresponds to the JSON property `primaryKeyPairId`
+        # @return [String]
+        attr_accessor :primary_key_pair_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @email_address = args[:email_address] if args.key?(:email_address)
+          @primary_key_pair_id = args[:primary_key_pair_id] if args.key?(:primary_key_pair_id)
+        end
+      end
+      
+      # [Beta](https://workspace.google.com/terms/service-terms/index.html). A client-
+      # side encryption S/MIME key pair, which is comprised of a public key, its
+      # certificate chain, and metadata for its paired private key. Gmail uses the 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.
+      class CseKeyPair
+        include Google::Apis::Core::Hashable
+      
+        # Output only. If a key pair is set to `DISABLED`, the time that the key pair's
+        # state changed from `ENABLED` to `DISABLED`. This field is present only when
+        # the key pair is in state `DISABLED`.
+        # Corresponds to the JSON property `disableTime`
+        # @return [String]
+        attr_accessor :disable_time
+      
+        # Output only. The current state of the key pair.
+        # Corresponds to the JSON property `enablementState`
+        # @return [String]
+        attr_accessor :enablement_state
+      
+        # Output only. The immutable ID for the client-side encryption S/MIME key pair.
+        # Corresponds to the JSON property `keyPairId`
+        # @return [String]
+        attr_accessor :key_pair_id
+      
+        # Output only. The public key and its certificate chain, in [PEM](https://en.
+        # wikipedia.org/wiki/Privacy-Enhanced_Mail) format.
+        # Corresponds to the JSON property `pem`
+        # @return [String]
+        attr_accessor :pem
+      
+        # Input only. The public key and its certificate chain. The chain must be in [
+        # PKCS#7](https://en.wikipedia.org/wiki/PKCS_7) format and use PEM encoding and
+        # ASCII armor.
+        # Corresponds to the JSON property `pkcs7`
+        # @return [String]
+        attr_accessor :pkcs7
+      
+        # Metadata for instances of this key pair's private key.
+        # Corresponds to the JSON property `privateKeyMetadata`
+        # @return [Array<Google::Apis::GmailV1::CsePrivateKeyMetadata>]
+        attr_accessor :private_key_metadata
+      
+        # Output only. The email address identities that are specified on the leaf
+        # certificate.
+        # Corresponds to the JSON property `subjectEmailAddresses`
+        # @return [Array<String>]
+        attr_accessor :subject_email_addresses
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @disable_time = args[:disable_time] if args.key?(:disable_time)
+          @enablement_state = args[:enablement_state] if args.key?(:enablement_state)
+          @key_pair_id = args[:key_pair_id] if args.key?(:key_pair_id)
+          @pem = args[:pem] if args.key?(:pem)
+          @pkcs7 = args[:pkcs7] if args.key?(:pkcs7)
+          @private_key_metadata = args[:private_key_metadata] if args.key?(:private_key_metadata)
+          @subject_email_addresses = args[:subject_email_addresses] if args.key?(:subject_email_addresses)
+        end
+      end
+      
+      # Metadata for a private key instance.
+      class CsePrivateKeyMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Metadata for private keys managed by an external key access control list
+        # service. For details about managing key access, see [Google Workspace CSE API
+        # Reference](https://developers.google.com/workspace/cse/reference).
+        # Corresponds to the JSON property `kaclsKeyMetadata`
+        # @return [Google::Apis::GmailV1::KaclsKeyMetadata]
+        attr_accessor :kacls_key_metadata
+      
+        # Output only. The immutable ID for the private key metadata instance.
+        # Corresponds to the JSON property `privateKeyMetadataId`
+        # @return [String]
+        attr_accessor :private_key_metadata_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kacls_key_metadata = args[:kacls_key_metadata] if args.key?(:kacls_key_metadata)
+          @private_key_metadata_id = args[:private_key_metadata_id] if args.key?(:private_key_metadata_id)
+        end
+      end
+      
       # Settings for a delegate. Delegates can read, send, and delete messages, as
       # well as view and add contacts, for the delegator's account. See "Set up mail
       # delegation" for more information about delegates.
@@ -133,6 +255,19 @@ module Google
         end
       end
       
+      # Requests to turn off a client-side encryption key pair.
+      class DisableCseKeyPairRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # A draft email in the user's mailbox.
       class Draft
         include Google::Apis::Core::Hashable
@@ -158,6 +293,19 @@ module Google
         end
       end
       
+      # Requests to turn on a client-side encryption key pair.
+      class EnableCseKeyPairRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Resource definition for Gmail filters. Filters apply to specific messages
       # instead of an entire email thread.
       class Filter
@@ -509,6 +657,34 @@ module Google
         end
       end
       
+      # Metadata for private keys managed by an external key access control list
+      # service. For details about managing key access, see [Google Workspace CSE API
+      # Reference](https://developers.google.com/workspace/cse/reference).
+      class KaclsKeyMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Opaque data generated and used by the key access control list service. Maximum
+        # size: 8 KiB.
+        # Corresponds to the JSON property `kaclsData`
+        # @return [String]
+        attr_accessor :kacls_data
+      
+        # The URI of the key access control list service that manages the private key.
+        # Corresponds to the JSON property `kaclsUri`
+        # @return [String]
+        attr_accessor :kacls_uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kacls_data = args[:kacls_data] if args.key?(:kacls_data)
+          @kacls_uri = args[:kacls_uri] if args.key?(:kacls_uri)
+        end
+      end
+      
       # Labels are used to categorize messages and threads within the user's mailbox.
       # The maximum number of labels supported for a user's mailbox is 10,000.
       class Label
@@ -675,6 +851,60 @@ module Google
         end
       end
       
+      # 
+      class ListCseIdentitiesResponse
+        include Google::Apis::Core::Hashable
+      
+        # One page of the list of CSE identities configured for the user.
+        # Corresponds to the JSON property `cseIdentities`
+        # @return [Array<Google::Apis::GmailV1::CseIdentity>]
+        attr_accessor :cse_identities
+      
+        # Pagination token to be passed to a subsequent ListCseIdentities call in order
+        # to retrieve the next page of identities. If this value is not returned or is
+        # the empty string, then no further pages remain.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cse_identities = args[:cse_identities] if args.key?(:cse_identities)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
+      # 
+      class ListCseKeyPairsResponse
+        include Google::Apis::Core::Hashable
+      
+        # One page of the list of CSE key pairs installed for the user.
+        # Corresponds to the JSON property `cseKeyPairs`
+        # @return [Array<Google::Apis::GmailV1::CseKeyPair>]
+        attr_accessor :cse_key_pairs
+      
+        # Pagination token to be passed to a subsequent ListCseKeyPairs call in order to
+        # retrieve the next page of key pairs. If this value is not returned, then no
+        # further pages remain.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cse_key_pairs = args[:cse_key_pairs] if args.key?(:cse_key_pairs)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # Response for the ListDelegates method.
       class ListDelegatesResponse
         include Google::Apis::Core::Hashable
@@ -1174,6 +1404,19 @@ module Google
         end
       end
       
+      # Request to obliterate a CSE key pair.
+      class ObliterateCseKeyPairRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # POP settings for an account.
       class PopSettings
         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.20.0"
+      GEM_VERSION = "0.21.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.11.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20220404"
+      REVISION = "20221219"
     end
   end
 end

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

@@ -40,18 +40,48 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CseIdentity
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class CseKeyPair
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class CsePrivateKeyMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Delegate
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class DisableCseKeyPairRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Draft
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class EnableCseKeyPairRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Filter
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -112,6 +142,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class KaclsKeyMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Label
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -130,6 +166,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListCseIdentitiesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ListCseKeyPairsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListDelegatesResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -226,6 +274,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ObliterateCseKeyPairRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class PopSettings
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -305,6 +359,37 @@ module Google
         end
       end
       
+      class CseIdentity
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :email_address, as: 'emailAddress'
+          property :primary_key_pair_id, as: 'primaryKeyPairId'
+        end
+      end
+      
+      class CseKeyPair
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :disable_time, as: 'disableTime'
+          property :enablement_state, as: 'enablementState'
+          property :key_pair_id, as: 'keyPairId'
+          property :pem, as: 'pem'
+          property :pkcs7, as: 'pkcs7'
+          collection :private_key_metadata, as: 'privateKeyMetadata', class: Google::Apis::GmailV1::CsePrivateKeyMetadata, decorator: Google::Apis::GmailV1::CsePrivateKeyMetadata::Representation
+      
+          collection :subject_email_addresses, as: 'subjectEmailAddresses'
+        end
+      end
+      
+      class CsePrivateKeyMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :kacls_key_metadata, as: 'kaclsKeyMetadata', class: Google::Apis::GmailV1::KaclsKeyMetadata, decorator: Google::Apis::GmailV1::KaclsKeyMetadata::Representation
+      
+          property :private_key_metadata_id, as: 'privateKeyMetadataId'
+        end
+      end
+      
       class Delegate
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -313,6 +398,12 @@ module Google
         end
       end
       
+      class DisableCseKeyPairRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class Draft
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -322,6 +413,12 @@ module Google
         end
       end
       
+      class EnableCseKeyPairRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class Filter
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -426,6 +523,14 @@ module Google
         end
       end
       
+      class KaclsKeyMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :kacls_data, as: 'kaclsData'
+          property :kacls_uri, as: 'kaclsUri'
+        end
+      end
+      
       class Label
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -458,6 +563,24 @@ module Google
         end
       end
       
+      class ListCseIdentitiesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :cse_identities, as: 'cseIdentities', class: Google::Apis::GmailV1::CseIdentity, decorator: Google::Apis::GmailV1::CseIdentity::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
+      class ListCseKeyPairsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :cse_key_pairs, as: 'cseKeyPairs', class: Google::Apis::GmailV1::CseKeyPair, decorator: Google::Apis::GmailV1::CseKeyPair::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
       class ListDelegatesResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -610,6 +733,12 @@ module Google
         end
       end
       
+      class ObliterateCseKeyPairRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class PopSettings
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -1484,6 +1484,430 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # 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. [Beta](https://
+        # workspace.google.com/terms/service-terms/index.html).
+        # @param [String] user_id
+        #   The requester's primary email address. To indicate the authenticated user, you
+        #   can use the special value `me`.
+        # @param [Google::Apis::GmailV1::CseIdentity] cse_identity_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GmailV1::CseIdentity] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GmailV1::CseIdentity]
+        #
+        # @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_identity(user_id, cse_identity_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'gmail/v1/users/{userId}/settings/cse/identities', options)
+          command.request_representation = Google::Apis::GmailV1::CseIdentity::Representation
+          command.request_object = cse_identity_object
+          command.response_representation = Google::Apis::GmailV1::CseIdentity::Representation
+          command.response_class = Google::Apis::GmailV1::CseIdentity
+          command.params['userId'] = user_id unless user_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # 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. [Beta](https://workspace.
+        # google.com/terms/service-terms/index.html).
+        # @param [String] user_id
+        #   The requester's primary email address. To indicate the authenticated user, you
+        #   can use the special value `me`.
+        # @param [String] cse_email_address
+        #   The primary email address associated with the client-side encryption identity
+        #   configuration that's removed.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [NilClass] No result returned for this method
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [void]
+        #
+        # @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 delete_user_setting_cse_identity(user_id, cse_email_address, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}', options)
+          command.params['userId'] = user_id unless user_id.nil?
+          command.params['cseEmailAddress'] = cse_email_address unless cse_email_address.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Retrieves a client-side encryption identity configuration. [Beta](https://
+        # workspace.google.com/terms/service-terms/index.html).
+        # @param [String] user_id
+        #   The requester's primary email address. To indicate the authenticated user, you
+        #   can use the special value `me`.
+        # @param [String] cse_email_address
+        #   The primary email address associated with the client-side encryption identity
+        #   configuration that's retrieved.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GmailV1::CseIdentity] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GmailV1::CseIdentity]
+        #
+        # @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 get_user_setting_cse_identity(user_id, cse_email_address, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}', options)
+          command.response_representation = Google::Apis::GmailV1::CseIdentity::Representation
+          command.response_class = Google::Apis::GmailV1::CseIdentity
+          command.params['userId'] = user_id unless user_id.nil?
+          command.params['cseEmailAddress'] = cse_email_address unless cse_email_address.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists the client-side encrypted identities for an authenticated user. [Beta](
+        # https://workspace.google.com/terms/service-terms/index.html).
+        # @param [String] user_id
+        #   The requester's primary email address. To indicate the authenticated user, you
+        #   can use the special value `me`.
+        # @param [Fixnum] page_size
+        #   The number of identities to return. If not provided, the page size will
+        #   default to 20 entries.
+        # @param [String] page_token
+        #   Pagination token indicating which page of identities to return. If the token
+        #   is not supplied, then the API will return the first page of results.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GmailV1::ListCseIdentitiesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GmailV1::ListCseIdentitiesResponse]
+        #
+        # @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 list_user_setting_cse_identities(user_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/cse/identities', options)
+          command.response_representation = Google::Apis::GmailV1::ListCseIdentitiesResponse::Representation
+          command.response_class = Google::Apis::GmailV1::ListCseIdentitiesResponse
+          command.params['userId'] = user_id unless user_id.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # 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). [Beta](
+        # https://workspace.google.com/terms/service-terms/index.html).
+        # @param [String] user_id
+        #   The requester's primary email address. To indicate the authenticated user, you
+        #   can use the special value `me`.
+        # @param [String] email_address
+        #   The email address of the client-side encryption identity to update.
+        # @param [Google::Apis::GmailV1::CseIdentity] cse_identity_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GmailV1::CseIdentity] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GmailV1::CseIdentity]
+        #
+        # @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 patch_user_setting_cse_identity(user_id, email_address, cse_identity_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'gmail/v1/users/{userId}/settings/cse/identities/{emailAddress}', options)
+          command.request_representation = Google::Apis::GmailV1::CseIdentity::Representation
+          command.request_object = cse_identity_object
+          command.response_representation = Google::Apis::GmailV1::CseIdentity::Representation
+          command.response_class = Google::Apis::GmailV1::CseIdentity
+          command.params['userId'] = user_id unless user_id.nil?
+          command.params['emailAddress'] = email_address unless email_address.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Creates and uploads a client-side encryption S/MIME public key certificate
+        # chain and private key metadata for the authenticated user. [Beta](https://
+        # workspace.google.com/terms/service-terms/index.html).
+        # @param [String] user_id
+        #   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] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GmailV1::CseKeyPair] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GmailV1::CseKeyPair]
+        #
+        # @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)
+          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['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Turns off a client-side encryption key pair. The authenticated user can no
+        # 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. [Beta](https://workspace.google.com/terms/service-
+        # terms/index.html).
+        # @param [String] user_id
+        #   The requester's primary email address. To indicate the authenticated user, you
+        #   can use the special value `me`.
+        # @param [String] key_pair_id
+        #   The identifier of the key pair to turn off.
+        # @param [Google::Apis::GmailV1::DisableCseKeyPairRequest] disable_cse_key_pair_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GmailV1::CseKeyPair] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GmailV1::CseKeyPair]
+        #
+        # @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 disable_keypair_cse_key_pair(user_id, key_pair_id, disable_cse_key_pair_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:disable', options)
+          command.request_representation = Google::Apis::GmailV1::DisableCseKeyPairRequest::Representation
+          command.request_object = disable_cse_key_pair_request_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.params['keyPairId'] = key_pair_id unless key_pair_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        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. [
+        # Beta](https://workspace.google.com/terms/service-terms/index.html).
+        # @param [String] user_id
+        #   The requester's primary email address. To indicate the authenticated user, you
+        #   can use the special value `me`.
+        # @param [String] key_pair_id
+        #   The identifier of the key pair to turn on.
+        # @param [Google::Apis::GmailV1::EnableCseKeyPairRequest] enable_cse_key_pair_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GmailV1::CseKeyPair] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GmailV1::CseKeyPair]
+        #
+        # @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 enable_keypair_cse_key_pair(user_id, key_pair_id, enable_cse_key_pair_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:enable', options)
+          command.request_representation = Google::Apis::GmailV1::EnableCseKeyPairRequest::Representation
+          command.request_object = enable_cse_key_pair_request_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.params['keyPairId'] = key_pair_id unless key_pair_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Retrieves an existing client-side encryption key pair. [Beta](https://
+        # workspace.google.com/terms/service-terms/index.html).
+        # @param [String] user_id
+        #   The requester's primary email address. To indicate the authenticated user, you
+        #   can use the special value `me`.
+        # @param [String] key_pair_id
+        #   The identifier of the key pair to retrieve.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GmailV1::CseKeyPair] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GmailV1::CseKeyPair]
+        #
+        # @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 get_user_setting_cse_keypair(user_id, key_pair_id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}', options)
+          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.params['keyPairId'] = key_pair_id unless key_pair_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists client-side encryption key pairs for an authenticated user. [Beta](https:
+        # //workspace.google.com/terms/service-terms/index.html).
+        # @param [String] user_id
+        #   The requester's primary email address. To indicate the authenticated user, you
+        #   can use the special value `me`.
+        # @param [Fixnum] page_size
+        #   The number of key pairs to return. If not provided, the page size will default
+        #   to 20 entries.
+        # @param [String] page_token
+        #   Pagination token indicating which page of key pairs to return. If the token is
+        #   not supplied, then the API will return the first page of results.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GmailV1::ListCseKeyPairsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GmailV1::ListCseKeyPairsResponse]
+        #
+        # @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 list_user_setting_cse_keypairs(user_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'gmail/v1/users/{userId}/settings/cse/keypairs', options)
+          command.response_representation = Google::Apis::GmailV1::ListCseKeyPairsResponse::Representation
+          command.response_class = Google::Apis::GmailV1::ListCseKeyPairsResponse
+          command.params['userId'] = user_id unless user_id.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes a client-side encryption key pair permanently and immediately. You can
+        # only permanently delete key pairs that have been turned off for more than 30
+        # 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. [Beta](https://workspace.google.com/terms/service-
+        # terms/index.html).
+        # @param [String] user_id
+        #   The requester's primary email address. To indicate the authenticated user, you
+        #   can use the special value `me`.
+        # @param [String] key_pair_id
+        #   The identifier of the key pair to obliterate.
+        # @param [Google::Apis::GmailV1::ObliterateCseKeyPairRequest] obliterate_cse_key_pair_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [NilClass] No result returned for this method
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [void]
+        #
+        # @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 obliterate_keypair_cse_key_pair(user_id, key_pair_id, obliterate_cse_key_pair_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate', options)
+          command.request_representation = Google::Apis::GmailV1::ObliterateCseKeyPairRequest::Representation
+          command.request_object = obliterate_cse_key_pair_request_object
+          command.params['userId'] = user_id unless user_id.nil?
+          command.params['keyPairId'] = key_pair_id unless key_pair_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # 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 G Suite organization as the delegator user. Gmail imposes limitations

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-gmail_v1
 version: !ruby/object:Gem::Version
-  version: 0.20.0
+  version: 0.21.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-10-31 00:00:00.000000000 Z
+date: 2023-01-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,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.20.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-gmail_v1/v0.21.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-gmail_v1
 post_install_message: 
 rdoc_options: []