google-apis-retail_v2alpha 0.85.0 → 0.86.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cbd3edc5f0cbaf4278c58d0bf44bf3bab493d44432feee8ff28940d5b9fce433
-  data.tar.gz: 849e0b88e0318fc16d93559947c2fec533f87662795a12d294852e228139073f
+  metadata.gz: 528165472c875a99bf4a7ec4e90cd496d14066233eb1d58a1eb892eab13b7e60
+  data.tar.gz: 9f9f5711a2717e4697a8f6b4c817ffeade1ceb818604a9e996d718c6e084cc3d
 SHA512:
-  metadata.gz: 1674b9c9110c2f44256003872299978dfaaf30c7145604b7e4af1103fd34790ebde9cd0adeda675e7ce8e662b49a91cb03ad8414af93c604bfbd1d7bc301862f
-  data.tar.gz: 275112551718726225362cb11dab2cafaad10af41ffb3eacb0b0068360ad32330e6a39c6aadf5025e8eb8182b47569ce77ae5dd2621e352c05e7fa4e4b584172
+  metadata.gz: '0315319ad0abd171ad175d48ff13a1b425f3943dfaebbcbab1a47e93a75905c97dafb88651d5a52f8de0a976b5e959da2965eb47050ef58957986de235233dcc'
+  data.tar.gz: 6b05a9cf87b65de032c9dd1bf91050144833e1cf782201e9b4e3370d509a8bbf176ffa7150b761a3c37f93ec551335ef4c4132d1398c4add48b9140f6c218a87

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-retail_v2alpha
 
+### 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

@@ -3249,6 +3249,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.86.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 = "20231005"
     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.86.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-17 00:00:00.000000000 Z
+date: 2023-10-15 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.86.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-retail_v2alpha
 post_install_message: 
 rdoc_options: []