google-ads-ad_manager-v1 0.1.0 → 0.3.0

data/lib/google/ads/ad_manager/v1/taxonomy_category_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_taxonomy_category 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_taxonomy_category",
                   options: options
                 )
                 operation = ::Gapic::Rest::TransportOperation.new response
                 result = ::Google::Ads::AdManager::V1::TaxonomyCategory.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_taxonomy_categories",
                   options: options
                 )
                 operation = ::Gapic::Rest::TransportOperation.new response
                 result = ::Google::Ads::AdManager::V1::ListTaxonomyCategoriesResponse.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/ads/ad_manager/v1/user_service/rest/client.rb

@@ -150,8 +150,28 @@ module Google
                   endpoint: @config.endpoint,
                   endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
                   universe_domain: @config.universe_domain,
-                  credentials: credentials
+                  credentials: credentials,
+                  logger: @config.logger
                 )
+
+                @user_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
+                @user_service_stub.logger
               end
 
               # Service calls
@@ -233,7 +253,6 @@ module Google
 
                 @user_service_stub.get_user 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)
@@ -281,6 +300,13 @@ module Google
               #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
               #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
               #    *  (`nil`) indicating no credentials
+              #
+              #   Warning: If you accept a credential configuration (JSON file or Hash) from an
+              #   external source for authentication to Google Cloud, you must validate it before
+              #   providing it to a Google API client library. Providing an unvalidated credential
+              #   configuration to Google APIs can compromise the security of your systems and data.
+              #   For more information, refer to [Validate credential configurations from external
+              #   sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
               #   @return [::Object]
               # @!attribute [rw] scope
               #   The OAuth scopes
@@ -313,6 +339,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
@@ -334,6 +365,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/ads/ad_manager/v1/user_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_user 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_user",
                   options: options
                 )
                 operation = ::Gapic::Rest::TransportOperation.new response
                 result = ::Google::Ads::AdManager::V1::User.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/ads/ad_manager/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Ads
     module AdManager
       module V1
-        VERSION = "0.1.0"
+        VERSION = "0.3.0"
       end
     end
   end

data/proto_docs/google/ads/admanager/v1/custom_field_value.rb

@@ -38,15 +38,23 @@ module Google
           # @!attribute [rw] dropdown_value
           #   @return [::Integer]
           #     The custom_field_option_id, if the CustomFieldDataType is DROPDOWN.
+          #
+          #     Note: The following fields are mutually exclusive: `dropdown_value`, `string_value`, `number_value`, `toggle_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] string_value
           #   @return [::String]
           #     The value, if the CustomFieldDataType is STRING.
+          #
+          #     Note: The following fields are mutually exclusive: `string_value`, `dropdown_value`, `number_value`, `toggle_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] number_value
           #   @return [::Float]
           #     The value, if the CustomFieldDataType is NUMBER.
+          #
+          #     Note: The following fields are mutually exclusive: `number_value`, `dropdown_value`, `string_value`, `toggle_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] toggle_value
           #   @return [::Boolean]
           #     The value, if the CustomFieldDataType is TOGGLE.
+          #
+          #     Note: The following fields are mutually exclusive: `toggle_value`, `dropdown_value`, `string_value`, `number_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class Value
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/ads/admanager/v1/entity_signals_mapping_messages.rb

@@ -25,12 +25,18 @@ module Google
         # @!attribute [rw] audience_segment_id
         #   @return [::Integer]
         #     ID of an AudienceSegment that this mapping belongs to.
+        #
+        #     Note: The following fields are mutually exclusive: `audience_segment_id`, `content_bundle_id`, `custom_targeting_value_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] content_bundle_id
         #   @return [::Integer]
         #     ID of a ContentBundle that this mapping belongs to.
+        #
+        #     Note: The following fields are mutually exclusive: `content_bundle_id`, `audience_segment_id`, `custom_targeting_value_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] custom_targeting_value_id
         #   @return [::Integer]
         #     ID of a CustomValue that this mapping belongs to.
+        #
+        #     Note: The following fields are mutually exclusive: `custom_targeting_value_id`, `audience_segment_id`, `content_bundle_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] name
         #   @return [::String]
         #     Identifier. The resource name of the `EntitySignalsMapping`.

data/proto_docs/google/ads/admanager/v1/report_service.rb

@@ -60,24 +60,38 @@ module Google
           # @!attribute [rw] int_value
           #   @return [::Integer]
           #     For integer values.
+          #
+          #     Note: The following fields are mutually exclusive: `int_value`, `double_value`, `string_value`, `bool_value`, `int_list_value`, `string_list_value`, `bytes_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] double_value
           #   @return [::Float]
           #     For double values.
+          #
+          #     Note: The following fields are mutually exclusive: `double_value`, `int_value`, `string_value`, `bool_value`, `int_list_value`, `string_list_value`, `bytes_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] string_value
           #   @return [::String]
           #     For string values.
+          #
+          #     Note: The following fields are mutually exclusive: `string_value`, `int_value`, `double_value`, `bool_value`, `int_list_value`, `string_list_value`, `bytes_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] bool_value
           #   @return [::Boolean]
           #     For boolean values.
+          #
+          #     Note: The following fields are mutually exclusive: `bool_value`, `int_value`, `double_value`, `string_value`, `int_list_value`, `string_list_value`, `bytes_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] int_list_value
           #   @return [::Google::Ads::AdManager::V1::Report::Value::IntList]
           #     For lists of integer values.
+          #
+          #     Note: The following fields are mutually exclusive: `int_list_value`, `int_value`, `double_value`, `string_value`, `bool_value`, `string_list_value`, `bytes_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] string_list_value
           #   @return [::Google::Ads::AdManager::V1::Report::Value::StringList]
           #     For lists of string values.
+          #
+          #     Note: The following fields are mutually exclusive: `string_list_value`, `int_value`, `double_value`, `string_value`, `bool_value`, `int_list_value`, `bytes_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] bytes_value
           #   @return [::String]
           #     For bytes values.
+          #
+          #     Note: The following fields are mutually exclusive: `bytes_value`, `int_value`, `double_value`, `string_value`, `bool_value`, `int_list_value`, `string_list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class Value
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -187,9 +201,13 @@ module Google
           # @!attribute [rw] dimension
           #   @return [::Google::Ads::AdManager::V1::Report::Dimension]
           #     The dimension this field represents.
+          #
+          #     Note: The following fields are mutually exclusive: `dimension`, `metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] metric
           #   @return [::Google::Ads::AdManager::V1::Report::Metric]
           #     The metric this field represents.
+          #
+          #     Note: The following fields are mutually exclusive: `metric`, `dimension`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class Field
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -214,15 +232,23 @@ module Google
           # @!attribute [rw] field_filter
           #   @return [::Google::Ads::AdManager::V1::Report::Filter::FieldFilter]
           #     A filter on a single field.
+          #
+          #     Note: The following fields are mutually exclusive: `field_filter`, `not_filter`, `and_filter`, `or_filter`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] not_filter
           #   @return [::Google::Ads::AdManager::V1::Report::Filter]
           #     A filter whose result is negated.
+          #
+          #     Note: The following fields are mutually exclusive: `not_filter`, `field_filter`, `and_filter`, `or_filter`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] and_filter
           #   @return [::Google::Ads::AdManager::V1::Report::Filter::FilterList]
           #     A list of filters whose results are AND-ed.
+          #
+          #     Note: The following fields are mutually exclusive: `and_filter`, `field_filter`, `not_filter`, `or_filter`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] or_filter
           #   @return [::Google::Ads::AdManager::V1::Report::Filter::FilterList]
           #     A list of filters whose results are OR-ed.
+          #
+          #     Note: The following fields are mutually exclusive: `or_filter`, `field_filter`, `not_filter`, `and_filter`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class Filter
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -341,9 +367,13 @@ module Google
           # @!attribute [rw] fixed
           #   @return [::Google::Ads::AdManager::V1::Report::DateRange::FixedDateRange]
           #     A fixed date range.
+          #
+          #     Note: The following fields are mutually exclusive: `fixed`, `relative`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] relative
           #   @return [::Google::Ads::AdManager::V1::Report::DateRange::RelativeDateRange]
           #     A relative date range.
+          #
+          #     Note: The following fields are mutually exclusive: `relative`, `fixed`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class DateRange
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -3396,9 +3426,13 @@ module Google
         # @!attribute [rw] weekly_schedule
         #   @return [::Google::Ads::AdManager::V1::Schedule::WeeklySchedule]
         #     Days of week to schedule report run.
+        #
+        #     Note: The following fields are mutually exclusive: `weekly_schedule`, `monthly_schedule`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] monthly_schedule
         #   @return [::Google::Ads::AdManager::V1::Schedule::MonthlySchedule]
         #     Days of month to schedule report run.
+        #
+        #     Note: The following fields are mutually exclusive: `monthly_schedule`, `weekly_schedule`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] start_date
         #   @return [::Google::Type::Date]
         #     Date for the first run of the report.

data/proto_docs/google/api/client.rb

@@ -215,6 +215,12 @@ module Google
       #     enabled. By default, asynchronous REST clients will not be generated.
       #     This feature will be enabled by default 1 month after launching the
       #     feature in preview packages.
+      # @!attribute [rw] protobuf_pythonic_types_enabled
+      #   @return [::Boolean]
+      #     Enables generation of protobuf code using new types that are more
+      #     Pythonic which are included in `protobuf>=5.29.x`. This feature will be
+      #     enabled by default 1 month after launching the feature in preview
+      #     packages.
       class ExperimentalFeatures
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -300,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/longrunning/operations.rb

@@ -40,9 +40,11 @@ module Google
     # @!attribute [rw] error
     #   @return [::Google::Rpc::Status]
     #     The error result of the operation in case of failure or cancellation.
+    #
+    #     Note: The following fields are mutually exclusive: `error`, `response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     # @!attribute [rw] response
     #   @return [::Google::Protobuf::Any]
-    #     The normal response of the operation in case of success.  If the original
+    #     The normal, successful response of the operation.  If the original
     #     method returns no data on success, such as `Delete`, the response is
     #     `google.protobuf.Empty`.  If the original method is standard
     #     `Get`/`Create`/`Update`, the response should be the resource.  For other
@@ -50,12 +52,15 @@ module Google
     #     is the original method name.  For example, if the original method name
     #     is `TakeSnapshot()`, the inferred response type is
     #     `TakeSnapshotResponse`.
+    #
+    #     Note: The following fields are mutually exclusive: `response`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     class Operation
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
-    # The request message for Operations.GetOperation.
+    # The request message for
+    # Operations.GetOperation.
     # @!attribute [rw] name
     #   @return [::String]
     #     The name of the operation resource.
@@ -64,7 +69,8 @@ module Google
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
-    # The request message for Operations.ListOperations.
+    # The request message for
+    # Operations.ListOperations.
     # @!attribute [rw] name
     #   @return [::String]
     #     The name of the operation's parent resource.
@@ -82,7 +88,8 @@ module Google
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
-    # The response message for Operations.ListOperations.
+    # The response message for
+    # Operations.ListOperations.
     # @!attribute [rw] operations
     #   @return [::Array<::Google::Longrunning::Operation>]
     #     A list of operations that matches the specified filter in the request.
@@ -94,7 +101,8 @@ module Google
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
-    # The request message for Operations.CancelOperation.
+    # The request message for
+    # Operations.CancelOperation.
     # @!attribute [rw] name
     #   @return [::String]
     #     The name of the operation resource to be cancelled.
@@ -103,7 +111,8 @@ module Google
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
-    # The request message for Operations.DeleteOperation.
+    # The request message for
+    # Operations.DeleteOperation.
     # @!attribute [rw] name
     #   @return [::String]
     #     The name of the operation resource to be deleted.
@@ -112,7 +121,8 @@ module Google
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
-    # The request message for Operations.WaitOperation.
+    # The request message for
+    # Operations.WaitOperation.
     # @!attribute [rw] name
     #   @return [::String]
     #     The name of the operation resource to wait on.
@@ -130,13 +140,12 @@ module Google
     #
     # Example:
     #
-    #   rpc LongRunningRecognize(LongRunningRecognizeRequest)
-    #       returns (google.longrunning.Operation) {
-    #     option (google.longrunning.operation_info) = {
-    #       response_type: "LongRunningRecognizeResponse"
-    #       metadata_type: "LongRunningRecognizeMetadata"
-    #     };
-    #   }
+    #     rpc Export(ExportRequest) returns (google.longrunning.Operation) {
+    #       option (google.longrunning.operation_info) = {
+    #         response_type: "ExportResponse"
+    #         metadata_type: "ExportMetadata"
+    #       };
+    #     }
     # @!attribute [rw] response_type
     #   @return [::String]
     #     Required. The message name of the primary return type for this

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: google-ads-ad_manager-v1
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Google LLC
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-28 00:00:00.000000000 Z
+date: 2025-01-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +15,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.21.1
+        version: 0.25.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +25,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.21.1
+        version: 0.25.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -264,7 +263,6 @@ homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -272,15 +270,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.21
-signing_key: 
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Manage your Ad Manager inventory, run reports and more.
 test_files: []