google-ads-googleads 3.2.0 → 7.0.0

data/lib/google/ads/google_ads/google_ads_client.rb

@@ -22,7 +22,7 @@
 module Google
   module Ads
     module GoogleAds
-      module V1
+      module V2
         module Common
         end
         module Enums
@@ -34,7 +34,31 @@ module Google
         module Services
         end
       end
-      module V2
+      module V3
+        module Common
+        end
+        module Enums
+        end
+        module Errors
+        end
+        module Resources
+        end
+        module Services
+        end
+      end
+      module V4
+        module Common
+        end
+        module Enums
+        end
+        module Errors
+        end
+        module Resources
+        end
+        module Services
+        end
+      end
+      module V5
         module Common
         end
         module Enums
@@ -61,14 +85,13 @@ require 'google/ads/google_ads/config'
 require 'google/ads/google_ads/field_mask_util'
 require 'google/ads/google_ads/lookup_util'
 require 'google/ads/google_ads/wrapper_util'
-require 'google/ads/google_ads/logging_interceptor'
+require 'google/ads/google_ads/interceptors/logging_interceptor'
 require 'google/ads/google_ads/factories'
 require 'google/ads/google_ads/errors'
 require 'google/ads/google_ads/service_lookup'
 require 'google/ads/google_ads/deprecation'
-require 'google/ads/google_ads/v1/services/google_ads_service_client'
 
-require 'google/gax'
+require 'grpc'
 
 require 'logger'
 require 'json'
@@ -136,21 +159,26 @@ module Google
         #
         # Raises ArgumentError if no service can be found for the provided type.
         def service
-          service_path = ENV['GOOGLEADS_SERVICE_PATH']
-
           ServiceLookup.new(
             lookup_util,
-            service_path,
             @logger,
             @config,
             make_channel,
+            endpoint,
+            deprecator,
           ).call
         end
 
-        def make_channel
+        def endpoint
+          target.split(":443").first
+        end
+
+        def target
           default_target = "googleads.googleapis.com:443"
           target = ENV.fetch('GOOGLEADS_SERVICE_PATH', default_target)
+        end
 
+        def make_channel
           channel_args = {
             MAX_MESSAGE_LENGTH => 64*1024*1024,
             MAX_METADATA_SIZE => 16*1024*1024,
@@ -215,35 +243,6 @@ module Google
 
         private
 
-        ERROR_TRANSFORMER = Proc.new do |gax_error|
-          begin
-            gax_error.status_details.each do |detail|
-              # If there is an underlying GoogleAdsFailure, throw that one.
-              if detail.is_a?(
-                  Google::Ads::GoogleAds::V1::Errors::GoogleAdsFailure)
-                raise Google::Ads::GoogleAds::Errors::GoogleAdsError.new(
-                    detail)
-              end
-              if detail.is_a?(Google::Protobuf::Any)
-                type = Google::Protobuf::DescriptorPool.generated_pool.lookup(
-                    detail.type_name).msgclass
-                failure = detail.unpack(type)
-                raise Google::Ads::GoogleAds::Errors::GoogleAdsError.new(
-                    failure)
-              end
-            end
-          rescue Google::Ads::GoogleAds::Errors::GoogleAdsError
-            # If we raised this, bubble it out.
-            raise
-          rescue NoMethodError
-            # Sometimes status_details is just a String; in that case, we should
-            # just raise the original exception.
-          end
-          # If we don't find an error of the correct type, or if we run into an
-          # error while processing, just throw the original.
-          raise gax_error
-        end
-
         def get_credentials
           if @config.authentication
             @config.authentication
@@ -304,11 +303,14 @@ module Google
         end
 
         def deprecate(deprecation)
-          @deprecation ||= Google::Ads::GoogleAds::Deprecation.new(
+          deprecator.deprecate(deprecation)
+        end
+
+        def deprecator
+          Google::Ads::GoogleAds::Deprecation.new(
             @config.treat_deprecation_warnings_as_errors,
             @config.warn_on_all_deprecations,
           )
-          @deprecation.deprecate(deprecation)
         end
       end
     end

data/lib/google/ads/google_ads/interceptors/error_interceptor.rb

@@ -0,0 +1,84 @@
+# Encoding: utf-8
+#
+# Copyright 2020 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.
+#
+# Interceptor to transform error responses to GoogleAdsErrors.
+
+require 'grpc/generic/interceptors'
+
+module Google
+  module Ads
+    module GoogleAds
+      module Interceptors
+        class ErrorInterceptor < GRPC::ClientInterceptor
+          ERROR_TRANSFORMER = lambda do |gax_error|
+            begin
+              gax_error.status_details.each do |detail|
+                # If there is an underlying GoogleAdsFailure, throw that one.
+                if detail.class.name.start_with?("Google::Ads::GoogleAds") &&
+                    detail.class.name.end_with?("GoogleAdsFailure")
+                  return Google::Ads::GoogleAds::Errors::GoogleAdsError.new(
+                    detail
+                  )
+                elsif detail.is_a?(Google::Protobuf::Any)
+                  type = Google::Protobuf::DescriptorPool.generated_pool.lookup(
+                    detail.type_name
+                  ).msgclass
+                  failure = detail.unpack(type)
+
+                  return Google::Ads::GoogleAds::Errors::GoogleAdsError.new(
+                    failure
+                  )
+                end
+              end
+            rescue Google::Ads::GoogleAds::Errors::GoogleAdsError => e
+              return e
+            rescue NoMethodError
+              # Sometimes status_details is just a String; in that case, we should
+              # just raise the original exception.
+            end
+            # If we don't find an error of the correct type, or if we run into an
+            # error while processing, just throw the original.
+            gax_error
+          end
+
+          def initialize()
+            # Don't propagate args, parens are necessary
+            super()
+            @error_transformer = ERROR_TRANSFORMER
+          end
+
+          def request_response(request:, call:, method:, metadata: {})
+            begin
+              yield
+            rescue Exception => e
+              raise @error_transformer.call(e)
+            end
+          end
+
+          def server_streamer(request:, call:, method:, metadata: {})
+            responses = yield
+            Enumerator.new do |y|
+              responses.each { |response| y << response }
+            rescue BasicObject => e
+              raise @error_transformer.call(e)
+            end
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/google/ads/google_ads/interceptors/logging_interceptor.rb

@@ -0,0 +1,220 @@
+# Encoding: utf-8
+#
+# Copyright 2018 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.
+#
+# Interceptor to log outgoing requests and incoming responses.
+
+require 'google/ads/google_ads/api_versions'
+require 'google/ads/google_ads/partial_failure_error_decoder'
+require 'grpc/generic/interceptors'
+require 'json'
+
+module Google
+  module Ads
+    module GoogleAds
+      module Interceptors
+        class LoggingInterceptor < GRPC::ClientInterceptor
+
+          def initialize(logger)
+            # Don't propagate args, parens are necessary
+            super()
+            @logger = logger
+          end
+
+          def request_response(request:, call:, method:, metadata: {})
+            begin
+              response = yield
+
+              @logger.info { build_summary_message(request, call, method, false) }
+              @logger.debug { build_request_message(metadata, request) }
+              @logger.debug { build_success_response_message(response) }
+              if response.respond_to?(:partial_failure_error) && response.partial_failure_error
+                @logger.debug { build_partial_failure_message(response) }
+              end
+              response
+            rescue Exception
+              @logger.warn { build_summary_message(request, call, method, true) }
+              @logger.info { build_request_message(metadata, request) }
+              @logger.info { build_error_response_message }
+              raise
+            end
+          end
+
+          def server_streamer(request:, call:, method:, metadata: {})
+            begin
+              @logger.info { build_summary_message(request, call, method, false) }
+              responses = yield
+              Enumerator.new do |y|
+                responses.each { |response|
+                  @logger.debug { build_request_message(metadata, request) }
+                  @logger.debug { build_success_response_message(response) }
+                  if response.respond_to?(:partial_failure_error) && response.partial_failure_error
+                    @logger.debug { build_partial_failure_message(response) }
+                  end
+                  y << response
+                }
+                @logger.debug {
+                  request_id = call
+                    .instance_variable_get(:@wrapped)
+                    .instance_variable_get(:@call)
+                    .trailing_metadata["request-id"]
+                  "Request ID for preceding streaming request: #{request_id}"
+                }
+              rescue Exception
+                handle_error(request, call, method, metadata)
+              end
+            rescue Exception
+              handle_error(request, call, method, metadata)
+            end
+          end
+
+          private
+
+          def handle_error(request, call, method, metadata)
+            @logger.warn { build_summary_message(request, call, method, true) }
+            @logger.info { build_request_message(metadata, request) }
+            @logger.info { build_error_response_message }
+            raise
+          end
+
+          def build_partial_failure_message(response)
+            errors = PartialFailureErrorDecoder.decode(
+              response.partial_failure_error
+            )
+            errors.reduce("Partial failure errors: ") do |accum, error|
+              accum += error.to_json + "\n"
+              accum
+            end
+          end
+
+          def build_error_response_message
+            exception = $!
+            response_message = ""
+            response_message << "Incoming response (errors): \n"
+            response_message << error_details(exception).join
+            response_message
+          end
+
+          def error_details(exception)
+            last_user_line = CallerFilter.first_non_google_ads_line
+            exception_details = [
+              "  ",
+              exception.class,
+              "(",
+              exception.message,
+              "): "
+            ]
+
+            case exception
+            when Google::Ads::GoogleAds::Errors::GoogleAdsError
+              exception.failure.errors.each do |error|
+                exception_details << error.message
+              end
+            when GRPC::InvalidArgument
+              exception_details << exception.details
+            end
+
+            exception_details << [
+              "\n",
+              "  called from: ",
+              last_user_line
+            ]
+
+            exception_details
+          end
+
+          def build_success_response_message(response)
+            "Incoming response: Payload: #{response.to_json}"
+          end
+
+          def build_request_message(metadata, request)
+            # calling #to_json on some protos (specifically those with non-UTF8
+            # encodable byte values) causes a segfault, however #inspect works
+            # so we check if the proto contains a bytevalue, and if it does
+            # we #inspect instead of #to_json
+            request_inspect = if use_bytes_inspect?(request)
+                                request.inspect
+                              else
+                                request.to_json
+                              end
+            "Outgoing request: Headers: #{metadata.to_json} Payload: #{request_inspect}"
+          end
+
+          def build_summary_message(request, call, method, is_fault)
+            customer_id = "N/A"
+            customer_id = request.customer_id if request.respond_to?(:customer_id)
+            # CustomerService get requests have a different format.
+            if request.respond_to?(:resource_name)
+              customer_id = request.resource_name.split('/').last
+            end
+
+            is_fault_string = if is_fault
+                                "yes"
+                              else
+                                "no"
+                              end
+
+            [
+              "CID: #{customer_id}",
+              "Host: #{call.instance_variable_get('@wrapped').peer}",
+              "Method: #{method}",
+              "IsFault: #{is_fault_string}",
+            ].join(", ")
+          end
+
+          def response_error_from_detail(detail)
+            detail.errors.map.with_index { |error, i|
+              "Error #{i + 1}: #{error.to_json}"
+            }.join("\n")
+          end
+
+          def use_bytes_inspect?(request)
+            @cycle_finder = CycleFinder.new
+            contains_bytes_field?(request.class.descriptor)
+          end
+
+          def contains_bytes_field?(descriptor)
+            return false if descriptor.nil?
+            return false if @cycle_finder.is_cycle?(descriptor)
+
+            @cycle_finder.add_object(descriptor)
+
+            descriptor.map { |x| x.type == :bytes || (x.type == :message && contains_bytes_field?(x.subtype)) }.any?
+          end
+
+          def interesting_error_classes
+            @interesting_error_classes ||= Google::Ads::GoogleAds::Errors.namespaces.map do |namespace|
+              namespace.const_get(:GoogleAdsFailure)
+            end
+          end
+
+          class CycleFinder
+            def initialize
+              @objects_seen = Set.new
+            end
+
+            def is_cycle?(object)
+              @objects_seen.include?(object.object_id)
+            end
+
+            def add_object(object)
+              @objects_seen.add(object.object_id)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/ads/google_ads/lookup_util.rb

@@ -1,3 +1,4 @@
+require 'google/ads/google_ads/api_versions'
 module Google
   module Ads
     module GoogleAds