google-apis-retail_v2alpha 0.85.0 → 0.87.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cbd3edc5f0cbaf4278c58d0bf44bf3bab493d44432feee8ff28940d5b9fce433
-  data.tar.gz: 849e0b88e0318fc16d93559947c2fec533f87662795a12d294852e228139073f
+  metadata.gz: 7c1d1e52c4a450cb4f0de4f5a988e43253196191c077a2ab701dc244ab1bc348
+  data.tar.gz: f06e9dd22a06907872c752bc8b88529a8338577f5314d98fc9c634c41fe12f7c
 SHA512:
-  metadata.gz: 1674b9c9110c2f44256003872299978dfaaf30c7145604b7e4af1103fd34790ebde9cd0adeda675e7ce8e662b49a91cb03ad8414af93c604bfbd1d7bc301862f
-  data.tar.gz: 275112551718726225362cb11dab2cafaad10af41ffb3eacb0b0068360ad32330e6a39c6aadf5025e8eb8182b47569ce77ae5dd2621e352c05e7fa4e4b584172
+  metadata.gz: cc5419cf515c5eb27aa1babd75f4dc732b63c661954092f5fe7be1f5e997d17a037aabb0b1368c6a6e827616f24a6b31c510107b2ae1411c9c6bad8916f11774
+  data.tar.gz: e925eb4f82ef631ccc5a8d1e6cb9b46b19aa5bcff42621fb007a161e28bed0e1bf0d7c6b52f024a57d50f8e921b889f8b295d2139ae6a58a566db18db3167c0d

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-retail_v2alpha
 
+### v0.87.0 (2023-10-22)
+
+* Regenerated from discovery document revision 20231012
+
+### v0.86.0 (2023-10-15)
+
+* Regenerated from discovery document revision 20231005
+
 ### v0.85.0 (2023-09-10)
 
 * Regenerated from discovery document revision 20230831

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

@@ -1631,7 +1631,8 @@ module Google
         # only paths of length 1 are accepted. In other words, if "dark_blue" merged
         # into "BLUE", then the latter can't merge into "blues" because this would
         # create a path of length 2. The maximum number of instances of MergedFacetValue
-        # per CatalogAttribute is 100.
+        # per CatalogAttribute is 100. This feature is available only for textual custom
+        # attributes.
         # Corresponds to the JSON property `mergedFacetValues`
         # @return [Array<Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaCatalogAttributeFacetConfigMergedFacetValue>]
         attr_accessor :merged_facet_values
@@ -1670,7 +1671,7 @@ module Google
       
         # List of facet values to ignore for the following time range. The facet values
         # are the same as the attribute values. There is a limit of 10 values per
-        # instance of IgnoredFacetValues. Each value can have at most 60 characters.
+        # instance of IgnoredFacetValues. Each value can have at most 128 characters.
         # Corresponds to the JSON property `values`
         # @return [Array<String>]
         attr_accessor :values
@@ -1687,21 +1688,21 @@ module Google
         end
       end
       
-      # Replaces a set of facet values by the same (possibly different) merged facet
-      # value. Each facet value should appear at most once as a value per
-      # CatalogAttribute.
+      # Replaces a set of textual facet values by the same (possibly different) merged
+      # facet value. Each facet value should appear at most once as a value per
+      # CatalogAttribute. This feature is available only for textual custom attributes.
       class GoogleCloudRetailV2alphaCatalogAttributeFacetConfigMergedFacetValue
         include Google::Apis::Core::Hashable
       
         # All the previous values are replaced by this merged facet value. This
-        # merged_value must be non-empty and can have up to 60 characters.
+        # merged_value must be non-empty and can have up to 128 characters.
         # Corresponds to the JSON property `mergedValue`
         # @return [String]
         attr_accessor :merged_value
       
         # All the facet values that are replaces by the same merged_value that follows.
         # The maximum number of values per MergedFacetValue is 25. Each value can have
-        # up to 60 characters.
+        # up to 128 characters.
         # Corresponds to the JSON property `values`
         # @return [Array<String>]
         attr_accessor :values
@@ -3249,6 +3250,98 @@ module Google
         end
       end
       
+      # Project level logging config to control what level of log will be generated
+      # and written to Cloud Logging.
+      class GoogleCloudRetailV2alphaLoggingConfig
+        include Google::Apis::Core::Hashable
+      
+        # The logging configurations for services supporting log generation.
+        # Corresponds to the JSON property `defaultLogGenerationRule`
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule]
+        attr_accessor :default_log_generation_rule
+      
+        # Required. Immutable. The name of the LoggingConfig singleton resource. Format:
+        # projects/*/loggingConfig
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Controls logging configurations more granularly for each supported service.
+        # This overrides the default_log_generation_rule for the services specified. For
+        # those not mentioned, they will fallback to the default log generation rule.
+        # Corresponds to the JSON property `serviceLogGenerationRules`
+        # @return [Array<Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfigServiceLogGenerationRule>]
+        attr_accessor :service_log_generation_rules
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @default_log_generation_rule = args[:default_log_generation_rule] if args.key?(:default_log_generation_rule)
+          @name = args[:name] if args.key?(:name)
+          @service_log_generation_rules = args[:service_log_generation_rules] if args.key?(:service_log_generation_rules)
+        end
+      end
+      
+      # The logging configurations for services supporting log generation.
+      class GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule
+        include Google::Apis::Core::Hashable
+      
+        # The log sample rate for INFO level log entries. You can use this to reduce the
+        # number of entries generated for INFO level logs. DO NOT set this field if the
+        # logging_level is not LoggingLevel.LOG_ALL. Otherwise, an INVALID_ARGUMENT
+        # error is returned. Sample rate for INFO logs defaults to 1 when unset (
+        # generate and send all INFO logs to Cloud Logging). Its value must be greater
+        # than 0 and less than or equal to 1.
+        # Corresponds to the JSON property `infoLogSampleRate`
+        # @return [Float]
+        attr_accessor :info_log_sample_rate
+      
+        # The logging level. By default it is set to `LOG_WARNINGS_AND_ABOVE`.
+        # Corresponds to the JSON property `loggingLevel`
+        # @return [String]
+        attr_accessor :logging_level
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @info_log_sample_rate = args[:info_log_sample_rate] if args.key?(:info_log_sample_rate)
+          @logging_level = args[:logging_level] if args.key?(:logging_level)
+        end
+      end
+      
+      # The granular logging configurations for supported services.
+      class GoogleCloudRetailV2alphaLoggingConfigServiceLogGenerationRule
+        include Google::Apis::Core::Hashable
+      
+        # The logging configurations for services supporting log generation.
+        # Corresponds to the JSON property `logGenerationRule`
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule]
+        attr_accessor :log_generation_rule
+      
+        # Required. Supported service names: "CatalogService", "CompletionService", "
+        # ControlService", "MerchantCenterStreaming", "ModelService", "PredictionService"
+        # , "ProductService", "ServingConfigService", "UserEventService",
+        # Corresponds to the JSON property `serviceName`
+        # @return [String]
+        attr_accessor :service_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @log_generation_rule = args[:log_generation_rule] if args.key?(:log_generation_rule)
+          @service_name = args[:service_name] if args.key?(:service_name)
+        end
+      end
+      
       # Represents a link between a Merchant Center account and a branch. After a link
       # is established, products from the linked Merchant Center account are streamed
       # to the linked branch.

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module RetailV2alpha
       # Version of the google-apis-retail_v2alpha gem
-      GEM_VERSION = "0.85.0"
+      GEM_VERSION = "0.87.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230831"
+      REVISION = "20231012"
     end
   end
 end

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

@@ -634,6 +634,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2alphaLoggingConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2alphaLoggingConfigServiceLogGenerationRule
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2alphaMerchantCenterAccountLink
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -2329,6 +2347,34 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2alphaLoggingConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :default_log_generation_rule, as: 'defaultLogGenerationRule', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule::Representation
+      
+          property :name, as: 'name'
+          collection :service_log_generation_rules, as: 'serviceLogGenerationRules', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfigServiceLogGenerationRule, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfigServiceLogGenerationRule::Representation
+      
+        end
+      end
+      
+      class GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :info_log_sample_rate, as: 'infoLogSampleRate'
+          property :logging_level, as: 'loggingLevel'
+        end
+      end
+      
+      class GoogleCloudRetailV2alphaLoggingConfigServiceLogGenerationRule
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :log_generation_rule, as: 'logGenerationRule', class: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule, decorator: Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule::Representation
+      
+          property :service_name, as: 'serviceName'
+        end
+      end
+      
       class GoogleCloudRetailV2alphaMerchantCenterAccountLink
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -88,6 +88,37 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets the LoggingConfig of the requested project.
+        # @param [String] name
+        #   Required. Full LoggingConfig resource name. Format: projects/`project_number`/
+        #   loggingConfig
+        # @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::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfig] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfig]
+        #
+        # @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_project_logging_config(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2alpha/{+name}', options)
+          command.response_representation = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfig::Representation
+          command.response_class = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfig
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets the project. Throws `NOT_FOUND` if the project wasn't initialized for the
         # Retail API service.
         # @param [String] name
@@ -151,6 +182,45 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Updates the LoggingConfig of the requested project.
+        # @param [String] name
+        #   Required. Immutable. The name of the LoggingConfig singleton resource. Format:
+        #   projects/*/loggingConfig
+        # @param [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfig] google_cloud_retail_v2alpha_logging_config_object
+        # @param [String] update_mask
+        #   Indicates which fields in the provided LoggingConfig to update. The following
+        #   are the only supported fields: * default_log_generation_rule *
+        #   per_service_log_generation_rules If not set, all supported fields are updated.
+        # @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::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfig] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfig]
+        #
+        # @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 update_project_logging_config(name, google_cloud_retail_v2alpha_logging_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v2alpha/{+name}', options)
+          command.request_representation = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfig::Representation
+          command.request_object = google_cloud_retail_v2alpha_logging_config_object
+          command.response_representation = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfig::Representation
+          command.response_class = Google::Apis::RetailV2alpha::GoogleCloudRetailV2alphaLoggingConfig
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Completes the specified prefix with keyword suggestions. This feature is only
         # available for users who have Retail Search enabled. Enable Retail Search on
         # Cloud Console before using this feature.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-retail_v2alpha
 version: !ruby/object:Gem::Version
-  version: 0.85.0
+  version: 0.87.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-17 00:00:00.000000000 Z
+date: 2023-10-29 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-retail_v2alpha/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2alpha/v0.85.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2alpha/v0.87.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-retail_v2alpha
 post_install_message: 
 rdoc_options: []