google-shopping-css-v1 0.2.1 → 0.4.0

data/lib/google/shopping/css/v1/css_products_service/client.rb

@@ -168,8 +168,28 @@ module Google
                 universe_domain: @config.universe_domain,
                 channel_args: @config.channel_args,
                 interceptors: @config.interceptors,
-                channel_pool_config: @config.channel_pool
+                channel_pool_config: @config.channel_pool,
+                logger: @config.logger
               )
+
+              @css_products_service_stub.stub_logger&.info do |entry|
+                entry.set_system_name
+                entry.set_service
+                entry.message = "Created client for #{entry.service}"
+                entry.set_credentials_fields credentials
+                entry.set "customEndpoint", @config.endpoint if @config.endpoint
+                entry.set "defaultTimeout", @config.timeout if @config.timeout
+                entry.set "quotaProject", @quota_project_id if @quota_project_id
+              end
+            end
+
+            ##
+            # The logger used for request/response debug logging.
+            #
+            # @return [Logger]
+            #
+            def logger
+              @css_products_service_stub.logger
             end
 
             # Service calls
@@ -256,7 +276,6 @@ module Google
 
               @css_products_service_stub.call_rpc :get_css_product, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -365,7 +384,7 @@ module Google
               @css_products_service_stub.call_rpc :list_css_products, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @css_products_service_stub, :list_css_products, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -454,6 +473,11 @@ module Google
             #   default endpoint URL. The default value of nil uses the environment
             #   universe (usually the default "googleapis.com" universe).
             #   @return [::String,nil]
+            # @!attribute [rw] logger
+            #   A custom logger to use for request/response debug logging, or the value
+            #   `:default` (the default) to construct a default logger, or `nil` to
+            #   explicitly disable logging.
+            #   @return [::Logger,:default,nil]
             #
             class Configuration
               extend ::Gapic::Config
@@ -478,6 +502,7 @@ module Google
               config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
               config_attr :quota_project, nil, ::String, nil
               config_attr :universe_domain, nil, ::String, nil
+              config_attr :logger, :default, ::Logger, nil, :default
 
               # @private
               def initialize parent_config = nil

data/lib/google/shopping/css/v1/css_products_service/rest/client.rb

@@ -161,8 +161,28 @@ module Google
                   endpoint: @config.endpoint,
                   endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
                   universe_domain: @config.universe_domain,
-                  credentials: credentials
+                  credentials: credentials,
+                  logger: @config.logger
                 )
+
+                @css_products_service_stub.logger(stub: true)&.info do |entry|
+                  entry.set_system_name
+                  entry.set_service
+                  entry.message = "Created client for #{entry.service}"
+                  entry.set_credentials_fields credentials
+                  entry.set "customEndpoint", @config.endpoint if @config.endpoint
+                  entry.set "defaultTimeout", @config.timeout if @config.timeout
+                  entry.set "quotaProject", @quota_project_id if @quota_project_id
+                end
+              end
+
+              ##
+              # The logger used for request/response debug logging.
+              #
+              # @return [Logger]
+              #
+              def logger
+                @css_products_service_stub.logger
               end
 
               # Service calls
@@ -242,7 +262,6 @@ module Google
 
                 @css_products_service_stub.get_css_product request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -344,7 +363,7 @@ module Google
                 @css_products_service_stub.list_css_products request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @css_products_service_stub, :list_css_products, "css_products", request, result, options
                   yield result, operation if block_given?
-                  return result
+                  throw :response, result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -424,6 +443,11 @@ module Google
               #   default endpoint URL. The default value of nil uses the environment
               #   universe (usually the default "googleapis.com" universe).
               #   @return [::String,nil]
+              # @!attribute [rw] logger
+              #   A custom logger to use for request/response debug logging, or the value
+              #   `:default` (the default) to construct a default logger, or `nil` to
+              #   explicitly disable logging.
+              #   @return [::Logger,:default,nil]
               #
               class Configuration
                 extend ::Gapic::Config
@@ -445,6 +469,7 @@ module Google
                 config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
                 config_attr :quota_project, nil, ::String, nil
                 config_attr :universe_domain, nil, ::String, nil
+                config_attr :logger, :default, ::Logger, nil, :default
 
                 # @private
                 def initialize parent_config = nil

data/lib/google/shopping/css/v1/css_products_service/rest/service_stub.rb

@@ -30,7 +30,8 @@ module Google
             # including transcoding, making the REST call, and deserialing the response.
             #
             class ServiceStub
-              def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
+              # @private
+              def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
                 # These require statements are intentionally placed here to initialize
                 # the REST modules only when it's required.
                 require "gapic/rest"
@@ -40,7 +41,9 @@ module Google
                                                              universe_domain: universe_domain,
                                                              credentials: credentials,
                                                              numeric_enums: true,
-                                                             raise_faraday_errors: false
+                                                             service_name: self.class,
+                                                             raise_faraday_errors: false,
+                                                             logger: logger
               end
 
               ##
@@ -61,6 +64,15 @@ module Google
                 @client_stub.endpoint
               end
 
+              ##
+              # The logger used for request/response debug logging.
+              #
+              # @return [Logger]
+              #
+              def logger stub: false
+                stub ? @client_stub.stub_logger : @client_stub.logger
+              end
+
               ##
               # Baseline implementation for the get_css_product REST call
               #
@@ -87,16 +99,18 @@ module Google
 
                 response = @client_stub.make_http_request(
                   verb,
-                  uri:     uri,
-                  body:    body || "",
-                  params:  query_string_params,
+                  uri: uri,
+                  body: body || "",
+                  params: query_string_params,
+                  method_name: "get_css_product",
                   options: options
                 )
                 operation = ::Gapic::Rest::TransportOperation.new response
                 result = ::Google::Shopping::Css::V1::CssProduct.decode_json response.body, ignore_unknown_fields: true
-
-                yield result, operation if block_given?
-                result
+                catch :response do
+                  yield result, operation if block_given?
+                  result
+                end
               end
 
               ##
@@ -125,16 +139,18 @@ module Google
 
                 response = @client_stub.make_http_request(
                   verb,
-                  uri:     uri,
-                  body:    body || "",
-                  params:  query_string_params,
+                  uri: uri,
+                  body: body || "",
+                  params: query_string_params,
+                  method_name: "list_css_products",
                   options: options
                 )
                 operation = ::Gapic::Rest::TransportOperation.new response
                 result = ::Google::Shopping::Css::V1::ListCssProductsResponse.decode_json response.body, ignore_unknown_fields: true
-
-                yield result, operation if block_given?
-                result
+                catch :response do
+                  yield result, operation if block_given?
+                  result
+                end
               end
 
               ##

data/lib/google/shopping/css/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Shopping
     module Css
       module V1
-        VERSION = "0.2.1"
+        VERSION = "0.4.0"
       end
     end
   end

data/proto_docs/google/api/client.rb

@@ -306,9 +306,28 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] renamed_services
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map of service names to renamed services. Keys are the package relative
+    #     service names and values are the name to be used for the service client
+    #     and call options.
+    #
+    #     publishing:
+    #       go_settings:
+    #         renamed_services:
+    #           Publisher: TopicAdmin
     class GoSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedServicesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
     end
 
     # Describes the generator configuration for a method.

data/proto_docs/google/protobuf/field_mask.rb

@@ -0,0 +1,229 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Protobuf
+    # `FieldMask` represents a set of symbolic field paths, for example:
+    #
+    #     paths: "f.a"
+    #     paths: "f.b.d"
+    #
+    # Here `f` represents a field in some root message, `a` and `b`
+    # fields in the message found in `f`, and `d` a field found in the
+    # message in `f.b`.
+    #
+    # Field masks are used to specify a subset of fields that should be
+    # returned by a get operation or modified by an update operation.
+    # Field masks also have a custom JSON encoding (see below).
+    #
+    # # Field Masks in Projections
+    #
+    # When used in the context of a projection, a response message or
+    # sub-message is filtered by the API to only contain those fields as
+    # specified in the mask. For example, if the mask in the previous
+    # example is applied to a response message as follows:
+    #
+    #     f {
+    #       a : 22
+    #       b {
+    #         d : 1
+    #         x : 2
+    #       }
+    #       y : 13
+    #     }
+    #     z: 8
+    #
+    # The result will not contain specific values for fields x,y and z
+    # (their value will be set to the default, and omitted in proto text
+    # output):
+    #
+    #
+    #     f {
+    #       a : 22
+    #       b {
+    #         d : 1
+    #       }
+    #     }
+    #
+    # A repeated field is not allowed except at the last position of a
+    # paths string.
+    #
+    # If a FieldMask object is not present in a get operation, the
+    # operation applies to all fields (as if a FieldMask of all fields
+    # had been specified).
+    #
+    # Note that a field mask does not necessarily apply to the
+    # top-level response message. In case of a REST get operation, the
+    # field mask applies directly to the response, but in case of a REST
+    # list operation, the mask instead applies to each individual message
+    # in the returned resource list. In case of a REST custom method,
+    # other definitions may be used. Where the mask applies will be
+    # clearly documented together with its declaration in the API.  In
+    # any case, the effect on the returned resource/resources is required
+    # behavior for APIs.
+    #
+    # # Field Masks in Update Operations
+    #
+    # A field mask in update operations specifies which fields of the
+    # targeted resource are going to be updated. The API is required
+    # to only change the values of the fields as specified in the mask
+    # and leave the others untouched. If a resource is passed in to
+    # describe the updated values, the API ignores the values of all
+    # fields not covered by the mask.
+    #
+    # If a repeated field is specified for an update operation, new values will
+    # be appended to the existing repeated field in the target resource. Note that
+    # a repeated field is only allowed in the last position of a `paths` string.
+    #
+    # If a sub-message is specified in the last position of the field mask for an
+    # update operation, then new value will be merged into the existing sub-message
+    # in the target resource.
+    #
+    # For example, given the target message:
+    #
+    #     f {
+    #       b {
+    #         d: 1
+    #         x: 2
+    #       }
+    #       c: [1]
+    #     }
+    #
+    # And an update message:
+    #
+    #     f {
+    #       b {
+    #         d: 10
+    #       }
+    #       c: [2]
+    #     }
+    #
+    # then if the field mask is:
+    #
+    #  paths: ["f.b", "f.c"]
+    #
+    # then the result will be:
+    #
+    #     f {
+    #       b {
+    #         d: 10
+    #         x: 2
+    #       }
+    #       c: [1, 2]
+    #     }
+    #
+    # An implementation may provide options to override this default behavior for
+    # repeated and message fields.
+    #
+    # In order to reset a field's value to the default, the field must
+    # be in the mask and set to the default value in the provided resource.
+    # Hence, in order to reset all fields of a resource, provide a default
+    # instance of the resource and set all fields in the mask, or do
+    # not provide a mask as described below.
+    #
+    # If a field mask is not present on update, the operation applies to
+    # all fields (as if a field mask of all fields has been specified).
+    # Note that in the presence of schema evolution, this may mean that
+    # fields the client does not know and has therefore not filled into
+    # the request will be reset to their default. If this is unwanted
+    # behavior, a specific service may require a client to always specify
+    # a field mask, producing an error if not.
+    #
+    # As with get operations, the location of the resource which
+    # describes the updated values in the request message depends on the
+    # operation kind. In any case, the effect of the field mask is
+    # required to be honored by the API.
+    #
+    # ## Considerations for HTTP REST
+    #
+    # The HTTP kind of an update operation which uses a field mask must
+    # be set to PATCH instead of PUT in order to satisfy HTTP semantics
+    # (PUT must only be used for full updates).
+    #
+    # # JSON Encoding of Field Masks
+    #
+    # In JSON, a field mask is encoded as a single string where paths are
+    # separated by a comma. Fields name in each path are converted
+    # to/from lower-camel naming conventions.
+    #
+    # As an example, consider the following message declarations:
+    #
+    #     message Profile {
+    #       User user = 1;
+    #       Photo photo = 2;
+    #     }
+    #     message User {
+    #       string display_name = 1;
+    #       string address = 2;
+    #     }
+    #
+    # In proto a field mask for `Profile` may look as such:
+    #
+    #     mask {
+    #       paths: "user.display_name"
+    #       paths: "photo"
+    #     }
+    #
+    # In JSON, the same mask is represented as below:
+    #
+    #     {
+    #       mask: "user.displayName,photo"
+    #     }
+    #
+    # # Field Masks and Oneof Fields
+    #
+    # Field masks treat fields in oneofs just as regular fields. Consider the
+    # following message:
+    #
+    #     message SampleMessage {
+    #       oneof test_oneof {
+    #         string name = 4;
+    #         SubMessage sub_message = 9;
+    #       }
+    #     }
+    #
+    # The field mask can be:
+    #
+    #     mask {
+    #       paths: "name"
+    #     }
+    #
+    # Or:
+    #
+    #     mask {
+    #       paths: "sub_message"
+    #     }
+    #
+    # Note that oneof type names ("test_oneof" in this case) cannot be used in
+    # paths.
+    #
+    # ## Field Mask Verification
+    #
+    # The implementation of any API method which has a FieldMask type field in the
+    # request should verify the included field paths, and return an
+    # `INVALID_ARGUMENT` error if any path is unmappable.
+    # @!attribute [rw] paths
+    #   @return [::Array<::String>]
+    #     The set of field mask paths.
+    class FieldMask
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

data/proto_docs/google/shopping/css/v1/accounts.rb

@@ -37,8 +37,8 @@ module Google
         #   @return [::Integer]
         #     Optional. The maximum number of accounts to return. The service may return
         #     fewer than this value. If unspecified, at most 50 accounts will be
-        #     returned. The maximum value is 1000; values above 1000 will be coerced to
-        #     1000.
+        #     returned. The maximum value is 100; values above 100 will be coerced to
+        #     100.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Optional. A page token, received from a previous `ListChildAccounts` call.

data/proto_docs/google/shopping/css/v1/css_product_common.rb

@@ -34,19 +34,19 @@ module Google
         #     within the context of Product Ads.
         # @!attribute [rw] low_price
         #   @return [::Google::Shopping::Type::Price]
-        #     Low Price of the aggregate offer.
+        #     Low Price of the CSS Product.
         # @!attribute [rw] high_price
         #   @return [::Google::Shopping::Type::Price]
-        #     High Price of the aggregate offer.
+        #     High Price of the CSS Product.
         # @!attribute [rw] number_of_offers
         #   @return [::Integer]
-        #     The number of aggregate offers.
+        #     The number of CSS Products.
         # @!attribute [rw] headline_offer_condition
         #   @return [::String]
         #     Condition of the headline offer.
         # @!attribute [rw] headline_offer_price
         #   @return [::Google::Shopping::Type::Price]
-        #     Headline Price of the aggregate offer.
+        #     Headline Price of the CSS Product.
         # @!attribute [rw] headline_offer_link
         #   @return [::String]
         #     Link to the headline offer.
@@ -55,7 +55,7 @@ module Google
         #     Mobile Link to the headline offer.
         # @!attribute [rw] headline_offer_shipping_price
         #   @return [::Google::Shopping::Type::Price]
-        #     Headline Price of the aggregate offer.
+        #     Headline Price of the CSS Product.
         # @!attribute [rw] title
         #   @return [::String]
         #     Title of the item.
@@ -311,15 +311,15 @@ module Google
           #     The name of the destination
           # @!attribute [rw] approved_countries
           #   @return [::Array<::String>]
-          #     List of country codes (ISO 3166-1 alpha-2) where the aggregate offer is
+          #     List of country codes (ISO 3166-1 alpha-2) where the CSS Product is
           #     approved.
           # @!attribute [rw] pending_countries
           #   @return [::Array<::String>]
-          #     List of country codes (ISO 3166-1 alpha-2) where the aggregate offer is
+          #     List of country codes (ISO 3166-1 alpha-2) where the CSS Product is
           #     pending approval.
           # @!attribute [rw] disapproved_countries
           #   @return [::Array<::String>]
-          #     List of country codes (ISO 3166-1 alpha-2) where the aggregate offer is
+          #     List of country codes (ISO 3166-1 alpha-2) where the CSS Product is
           #     disapproved.
           class DestinationStatus
             include ::Google::Protobuf::MessageExts
@@ -332,7 +332,7 @@ module Google
           #     The error code of the issue.
           # @!attribute [rw] servability
           #   @return [::String]
-          #     How this issue affects serving of the aggregate offer.
+          #     How this issue affects serving of the CSS Product.
           # @!attribute [rw] resolution
           #   @return [::String]
           #     Whether the issue can be resolved by the merchant.
@@ -354,7 +354,7 @@ module Google
           # @!attribute [rw] applicable_countries
           #   @return [::Array<::String>]
           #     List of country codes (ISO 3166-1 alpha-2) where issue applies to the
-          #     aggregate offer.
+          #     CSS Product.
           class ItemLevelIssue
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/shopping/css/v1/css_product_inputs.rb

@@ -55,7 +55,9 @@ module Google
         #     Feed Label is synonymous to "target country" and hence should always be a
         #     valid region code. For example: 'DE' for Germany, 'FR' for France.
         # @!attribute [rw] freshness_time
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Google::Protobuf::Timestamp]
+        #     DEPRECATED. Use expiration_date instead.
         #     Represents the existing version (freshness) of the CSS Product, which
         #     can be used to preserve the right order when multiple updates are done at
         #     the same time.
@@ -98,17 +100,48 @@ module Google
         #   @return [::Google::Shopping::Css::V1::CssProductInput]
         #     Required. The CSS Product Input to insert.
         # @!attribute [rw] feed_id
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Integer]
-        #     Required. The primary or supplemental feed id. If CSS Product already
-        #     exists and feed id provided is different, then the CSS Product will be
-        #     moved to a new feed. Note: For now, CSSs do not need to provide feed ids as
-        #     we create feeds on the fly. We do not have supplemental feed support for
-        #     CSS Products yet.
+        #     Optional. DEPRECATED. Feed id is not required for CSS Products.
+        #     The primary or supplemental feed id. If CSS Product already exists and
+        #     feed id provided is different, then the CSS Product will be moved to a
+        #     new feed.
+        #     Note: For now, CSSs do not need to provide feed ids as we create
+        #     feeds on the fly.
+        #     We do not have supplemental feed support for CSS Products yet.
         class InsertCssProductInputRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for the UpdateCssProductInput method.
+        # @!attribute [rw] css_product_input
+        #   @return [::Google::Shopping::Css::V1::CssProductInput]
+        #     Required. The CSS product input resource to update. Information you submit
+        #     will be applied to the processed CSS product as well.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     The list of CSS product attributes to be updated.
+        #
+        #     If the update mask is omitted, then it is treated as implied field mask
+        #     equivalent to all fields that are populated (have a non-empty value).
+        #
+        #     Attributes specified in the update mask without a value specified in the
+        #     body will be deleted from the CSS product.
+        #
+        #     Update mask can only be specified for top level fields in
+        #     attributes and custom attributes.
+        #
+        #     To specify the update mask for custom attributes you need to add the
+        #     `custom_attribute.` prefix.
+        #
+        #     Providing special "*" value for full CSS product replacement is not
+        #     supported.
+        class UpdateCssProductInputRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for the DeleteCssProductInput method.
         # @!attribute [rw] name
         #   @return [::String]

data/proto_docs/google/shopping/css/v1/css_products.rb

@@ -30,7 +30,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The processed CSS Product(a.k.a Aggregate Offer internally).
+        # The processed CSS Product.
         # @!attribute [rw] name
         #   @return [::String]
         #     The name of the CSS Product.