google-ads-ad_manager 0.1.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 222b44f88adaaa493f6a99b4a5ea6437720aebc47e7da363e466bb27ca475de5
-  data.tar.gz: 9c106107740097596602d5f311dc7d7bd505606a51ce1fc94066430966b68429
+  metadata.gz: 7a65630ec22802398b182bfee520c333e40af9f6081de2d74a41a8998fa973a1
+  data.tar.gz: ad05b3e3f3b2ada1de3ac35549c16e0c0c96fcb864f99bd303a60be8d54f7e12
 SHA512:
-  metadata.gz: e359bc0ee16c08ee7aa97318b371812d3b1e3ef177c33268a31e713c8d4493cfcf5059348c8d5e11f64f2e90944d78c2d9fba645e7c53c6da6388acb40a9ffc8
-  data.tar.gz: 6fad000f9c56ea72242ff423c304e95742e3cf6c18b0acbfcc5d2f92d9cd529e026114e42641d5f9f919e1085652a1081fd66bde2ec6f292dd5bfcf18bd26345
+  metadata.gz: fa14d0ab25e31e66af34e6d37158cdde890a3b685c22ba5ee70696fb1095a2ba0c0bb29ea509e6ef291e8750168a060305c1f4dec34f2ec00275a827e13908db
+  data.tar.gz: 820789bd4bf183eba79be63893f7489ec591d4856dd15245c6f62c42faf93ce57c321011bfda2d0f8c9e53508b9078997607fd906100c86b354a79fea0cb5305

data/README.md

@@ -34,9 +34,39 @@ In order to use this library, you first need to go through the following steps:
 1. [Enable the API.](https://console.cloud.google.com/apis/library/admanager.googleapis.com)
 1. {file:AUTHENTICATION.md Set up authentication.}
 
+## Debug Logging
+
+This library comes with opt-in Debug Logging that can help you troubleshoot
+your application's integration with the API. When logging is activated, key
+events such as requests and responses, along with data payloads and metadata
+such as headers and client configuration, are logged to the standard error
+stream.
+
+**WARNING:** Client Library Debug Logging includes your data payloads in
+plaintext, which could include sensitive data such as PII for yourself or your
+customers, private keys, or other security data that could be compromising if
+leaked. Always practice good data hygiene with your application logs, and follow
+the principle of least access. Google also recommends that Client Library Debug
+Logging be enabled only temporarily during active debugging, and not used
+permanently in production.
+
+To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
+to the value `all`. Alternatively, you can set the value to a comma-delimited
+list of client library gem names. This will select the default logging behavior,
+which writes logs to the standard error stream. On a local workstation, this may
+result in logs appearing on the console. When running on a Google Cloud hosting
+service such as [Google Cloud Run](https://cloud.google.com/run), this generally
+results in logs appearing alongside your application logs in the
+[Google Cloud Logging](https://cloud.google.com/logging/) service.
+
+Debug logging also requires that the versioned clients for this service be
+sufficiently recent, released after about Dec 10, 2024. If logging is not
+working, try updating the versioned clients in your bundle or installed gems:
+[google-ads-ad_manager-v1](https://rubydoc.info/gems/google-ads-ad_manager-v1).
+
 ## Supported Ruby Versions
 
-This library is supported on Ruby 2.7+.
+This library is supported on Ruby 3.0+.
 
 Google provides official support for Ruby versions that are actively supported
 by Ruby Core—that is, Ruby versions that are either in normal maintenance or

data/lib/google/ads/ad_manager/version.rb

@@ -20,7 +20,7 @@
 module Google
   module Ads
     module AdManager
-      VERSION = "0.1.0"
+      VERSION = "1.0.0"
     end
   end
 end

data/lib/google/ads/ad_manager.rb

@@ -38,6 +38,11 @@ module Google
       # supported by that API version, and the corresponding gem is available, the
       # appropriate versioned client will be returned.
       #
+      # Raises an exception if the currently installed versioned client gem for the
+      # given API version does not support the AdUnitService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.ad_unit_service_available?}.
+      #
       # ## About AdUnitService
       #
       # Provides methods for handling AdUnit objects.
@@ -57,6 +62,34 @@ module Google
         service_module.const_get(:Rest).const_get(:Client).new(&block)
       end
 
+      ##
+      # Determines whether the AdUnitService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.ad_unit_service}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the AdUnitService service,
+      # or if the versioned client gem needs an update to support the AdUnitService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.ad_unit_service_available? version: :v1
+        require "google/ads/ad_manager/#{version.to_s.downcase}"
+        package_name = Google::Ads::AdManager
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Ads::AdManager.const_get package_name
+        return false unless service_module.const_defined? :AdUnitService
+        service_module = service_module.const_get :AdUnitService
+        return false unless service_module.const_defined? :Rest
+        service_module = service_module.const_get :Rest
+        service_module.const_defined? :Client
+      rescue ::LoadError
+        false
+      end
+
       ##
       # Create a new client object for CompanyService.
       #
@@ -68,6 +101,11 @@ module Google
       # supported by that API version, and the corresponding gem is available, the
       # appropriate versioned client will be returned.
       #
+      # Raises an exception if the currently installed versioned client gem for the
+      # given API version does not support the CompanyService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.company_service_available?}.
+      #
       # ## About CompanyService
       #
       # Provides methods for handling `Company` objects.
@@ -87,6 +125,34 @@ module Google
         service_module.const_get(:Rest).const_get(:Client).new(&block)
       end
 
+      ##
+      # Determines whether the CompanyService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.company_service}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the CompanyService service,
+      # or if the versioned client gem needs an update to support the CompanyService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.company_service_available? version: :v1
+        require "google/ads/ad_manager/#{version.to_s.downcase}"
+        package_name = Google::Ads::AdManager
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Ads::AdManager.const_get package_name
+        return false unless service_module.const_defined? :CompanyService
+        service_module = service_module.const_get :CompanyService
+        return false unless service_module.const_defined? :Rest
+        service_module = service_module.const_get :Rest
+        service_module.const_defined? :Client
+      rescue ::LoadError
+        false
+      end
+
       ##
       # Create a new client object for CustomFieldService.
       #
@@ -98,6 +164,11 @@ module Google
       # supported by that API version, and the corresponding gem is available, the
       # appropriate versioned client will be returned.
       #
+      # Raises an exception if the currently installed versioned client gem for the
+      # given API version does not support the CustomFieldService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.custom_field_service_available?}.
+      #
       # ## About CustomFieldService
       #
       # Provides methods for handling `CustomField` objects.
@@ -117,6 +188,34 @@ module Google
         service_module.const_get(:Rest).const_get(:Client).new(&block)
       end
 
+      ##
+      # Determines whether the CustomFieldService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.custom_field_service}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the CustomFieldService service,
+      # or if the versioned client gem needs an update to support the CustomFieldService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.custom_field_service_available? version: :v1
+        require "google/ads/ad_manager/#{version.to_s.downcase}"
+        package_name = Google::Ads::AdManager
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Ads::AdManager.const_get package_name
+        return false unless service_module.const_defined? :CustomFieldService
+        service_module = service_module.const_get :CustomFieldService
+        return false unless service_module.const_defined? :Rest
+        service_module = service_module.const_get :Rest
+        service_module.const_defined? :Client
+      rescue ::LoadError
+        false
+      end
+
       ##
       # Create a new client object for CustomTargetingKeyService.
       #
@@ -128,6 +227,11 @@ module Google
       # supported by that API version, and the corresponding gem is available, the
       # appropriate versioned client will be returned.
       #
+      # Raises an exception if the currently installed versioned client gem for the
+      # given API version does not support the CustomTargetingKeyService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.custom_targeting_key_service_available?}.
+      #
       # ## About CustomTargetingKeyService
       #
       # Provides methods for handling `CustomTargetingKey` objects.
@@ -147,6 +251,34 @@ module Google
         service_module.const_get(:Rest).const_get(:Client).new(&block)
       end
 
+      ##
+      # Determines whether the CustomTargetingKeyService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.custom_targeting_key_service}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the CustomTargetingKeyService service,
+      # or if the versioned client gem needs an update to support the CustomTargetingKeyService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.custom_targeting_key_service_available? version: :v1
+        require "google/ads/ad_manager/#{version.to_s.downcase}"
+        package_name = Google::Ads::AdManager
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Ads::AdManager.const_get package_name
+        return false unless service_module.const_defined? :CustomTargetingKeyService
+        service_module = service_module.const_get :CustomTargetingKeyService
+        return false unless service_module.const_defined? :Rest
+        service_module = service_module.const_get :Rest
+        service_module.const_defined? :Client
+      rescue ::LoadError
+        false
+      end
+
       ##
       # Create a new client object for CustomTargetingValueService.
       #
@@ -158,6 +290,11 @@ module Google
       # supported by that API version, and the corresponding gem is available, the
       # appropriate versioned client will be returned.
       #
+      # Raises an exception if the currently installed versioned client gem for the
+      # given API version does not support the CustomTargetingValueService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.custom_targeting_value_service_available?}.
+      #
       # ## About CustomTargetingValueService
       #
       # Provides methods for handling `CustomTargetingValue` objects.
@@ -177,6 +314,34 @@ module Google
         service_module.const_get(:Rest).const_get(:Client).new(&block)
       end
 
+      ##
+      # Determines whether the CustomTargetingValueService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.custom_targeting_value_service}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the CustomTargetingValueService service,
+      # or if the versioned client gem needs an update to support the CustomTargetingValueService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.custom_targeting_value_service_available? version: :v1
+        require "google/ads/ad_manager/#{version.to_s.downcase}"
+        package_name = Google::Ads::AdManager
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Ads::AdManager.const_get package_name
+        return false unless service_module.const_defined? :CustomTargetingValueService
+        service_module = service_module.const_get :CustomTargetingValueService
+        return false unless service_module.const_defined? :Rest
+        service_module = service_module.const_get :Rest
+        service_module.const_defined? :Client
+      rescue ::LoadError
+        false
+      end
+
       ##
       # Create a new client object for EntitySignalsMappingService.
       #
@@ -188,6 +353,11 @@ module Google
       # supported by that API version, and the corresponding gem is available, the
       # appropriate versioned client will be returned.
       #
+      # Raises an exception if the currently installed versioned client gem for the
+      # given API version does not support the EntitySignalsMappingService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.entity_signals_mapping_service_available?}.
+      #
       # ## About EntitySignalsMappingService
       #
       # Provides methods for handling `EntitySignalsMapping` objects.
@@ -207,6 +377,34 @@ module Google
         service_module.const_get(:Rest).const_get(:Client).new(&block)
       end
 
+      ##
+      # Determines whether the EntitySignalsMappingService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.entity_signals_mapping_service}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the EntitySignalsMappingService service,
+      # or if the versioned client gem needs an update to support the EntitySignalsMappingService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.entity_signals_mapping_service_available? version: :v1
+        require "google/ads/ad_manager/#{version.to_s.downcase}"
+        package_name = Google::Ads::AdManager
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Ads::AdManager.const_get package_name
+        return false unless service_module.const_defined? :EntitySignalsMappingService
+        service_module = service_module.const_get :EntitySignalsMappingService
+        return false unless service_module.const_defined? :Rest
+        service_module = service_module.const_get :Rest
+        service_module.const_defined? :Client
+      rescue ::LoadError
+        false
+      end
+
       ##
       # Create a new client object for NetworkService.
       #
@@ -218,6 +416,11 @@ module Google
       # supported by that API version, and the corresponding gem is available, the
       # appropriate versioned client will be returned.
       #
+      # Raises an exception if the currently installed versioned client gem for the
+      # given API version does not support the NetworkService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.network_service_available?}.
+      #
       # ## About NetworkService
       #
       # Provides methods for handling Network objects.
@@ -237,6 +440,34 @@ module Google
         service_module.const_get(:Rest).const_get(:Client).new(&block)
       end
 
+      ##
+      # Determines whether the NetworkService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.network_service}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the NetworkService service,
+      # or if the versioned client gem needs an update to support the NetworkService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.network_service_available? version: :v1
+        require "google/ads/ad_manager/#{version.to_s.downcase}"
+        package_name = Google::Ads::AdManager
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Ads::AdManager.const_get package_name
+        return false unless service_module.const_defined? :NetworkService
+        service_module = service_module.const_get :NetworkService
+        return false unless service_module.const_defined? :Rest
+        service_module = service_module.const_get :Rest
+        service_module.const_defined? :Client
+      rescue ::LoadError
+        false
+      end
+
       ##
       # Create a new client object for OrderService.
       #
@@ -248,6 +479,11 @@ module Google
       # supported by that API version, and the corresponding gem is available, the
       # appropriate versioned client will be returned.
       #
+      # Raises an exception if the currently installed versioned client gem for the
+      # given API version does not support the OrderService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.order_service_available?}.
+      #
       # ## About OrderService
       #
       # Provides methods for handling `Order` objects.
@@ -267,6 +503,34 @@ module Google
         service_module.const_get(:Rest).const_get(:Client).new(&block)
       end
 
+      ##
+      # Determines whether the OrderService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.order_service}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the OrderService service,
+      # or if the versioned client gem needs an update to support the OrderService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.order_service_available? version: :v1
+        require "google/ads/ad_manager/#{version.to_s.downcase}"
+        package_name = Google::Ads::AdManager
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Ads::AdManager.const_get package_name
+        return false unless service_module.const_defined? :OrderService
+        service_module = service_module.const_get :OrderService
+        return false unless service_module.const_defined? :Rest
+        service_module = service_module.const_get :Rest
+        service_module.const_defined? :Client
+      rescue ::LoadError
+        false
+      end
+
       ##
       # Create a new client object for PlacementService.
       #
@@ -278,6 +542,11 @@ module Google
       # supported by that API version, and the corresponding gem is available, the
       # appropriate versioned client will be returned.
       #
+      # Raises an exception if the currently installed versioned client gem for the
+      # given API version does not support the PlacementService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.placement_service_available?}.
+      #
       # ## About PlacementService
       #
       # Provides methods for handling `Placement` objects.
@@ -297,6 +566,34 @@ module Google
         service_module.const_get(:Rest).const_get(:Client).new(&block)
       end
 
+      ##
+      # Determines whether the PlacementService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.placement_service}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the PlacementService service,
+      # or if the versioned client gem needs an update to support the PlacementService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.placement_service_available? version: :v1
+        require "google/ads/ad_manager/#{version.to_s.downcase}"
+        package_name = Google::Ads::AdManager
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Ads::AdManager.const_get package_name
+        return false unless service_module.const_defined? :PlacementService
+        service_module = service_module.const_get :PlacementService
+        return false unless service_module.const_defined? :Rest
+        service_module = service_module.const_get :Rest
+        service_module.const_defined? :Client
+      rescue ::LoadError
+        false
+      end
+
       ##
       # Create a new client object for ReportService.
       #
@@ -308,6 +605,11 @@ module Google
       # supported by that API version, and the corresponding gem is available, the
       # appropriate versioned client will be returned.
       #
+      # Raises an exception if the currently installed versioned client gem for the
+      # given API version does not support the ReportService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.report_service_available?}.
+      #
       # ## About ReportService
       #
       # Provides methods for interacting with reports.
@@ -327,6 +629,34 @@ module Google
         service_module.const_get(:Rest).const_get(:Client).new(&block)
       end
 
+      ##
+      # Determines whether the ReportService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.report_service}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the ReportService service,
+      # or if the versioned client gem needs an update to support the ReportService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.report_service_available? version: :v1
+        require "google/ads/ad_manager/#{version.to_s.downcase}"
+        package_name = Google::Ads::AdManager
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Ads::AdManager.const_get package_name
+        return false unless service_module.const_defined? :ReportService
+        service_module = service_module.const_get :ReportService
+        return false unless service_module.const_defined? :Rest
+        service_module = service_module.const_get :Rest
+        service_module.const_defined? :Client
+      rescue ::LoadError
+        false
+      end
+
       ##
       # Create a new client object for RoleService.
       #
@@ -338,6 +668,11 @@ module Google
       # supported by that API version, and the corresponding gem is available, the
       # appropriate versioned client will be returned.
       #
+      # Raises an exception if the currently installed versioned client gem for the
+      # given API version does not support the RoleService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.role_service_available?}.
+      #
       # ## About RoleService
       #
       # Provides methods for handling `Role` objects.
@@ -357,6 +692,34 @@ module Google
         service_module.const_get(:Rest).const_get(:Client).new(&block)
       end
 
+      ##
+      # Determines whether the RoleService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.role_service}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the RoleService service,
+      # or if the versioned client gem needs an update to support the RoleService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.role_service_available? version: :v1
+        require "google/ads/ad_manager/#{version.to_s.downcase}"
+        package_name = Google::Ads::AdManager
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Ads::AdManager.const_get package_name
+        return false unless service_module.const_defined? :RoleService
+        service_module = service_module.const_get :RoleService
+        return false unless service_module.const_defined? :Rest
+        service_module = service_module.const_get :Rest
+        service_module.const_defined? :Client
+      rescue ::LoadError
+        false
+      end
+
       ##
       # Create a new client object for TaxonomyCategoryService.
       #
@@ -368,6 +731,11 @@ module Google
       # supported by that API version, and the corresponding gem is available, the
       # appropriate versioned client will be returned.
       #
+      # Raises an exception if the currently installed versioned client gem for the
+      # given API version does not support the TaxonomyCategoryService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.taxonomy_category_service_available?}.
+      #
       # ## About TaxonomyCategoryService
       #
       # Provides methods for handling `TaxonomyCategory` objects.
@@ -387,6 +755,34 @@ module Google
         service_module.const_get(:Rest).const_get(:Client).new(&block)
       end
 
+      ##
+      # Determines whether the TaxonomyCategoryService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.taxonomy_category_service}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the TaxonomyCategoryService service,
+      # or if the versioned client gem needs an update to support the TaxonomyCategoryService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.taxonomy_category_service_available? version: :v1
+        require "google/ads/ad_manager/#{version.to_s.downcase}"
+        package_name = Google::Ads::AdManager
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Ads::AdManager.const_get package_name
+        return false unless service_module.const_defined? :TaxonomyCategoryService
+        service_module = service_module.const_get :TaxonomyCategoryService
+        return false unless service_module.const_defined? :Rest
+        service_module = service_module.const_get :Rest
+        service_module.const_defined? :Client
+      rescue ::LoadError
+        false
+      end
+
       ##
       # Create a new client object for UserService.
       #
@@ -398,6 +794,11 @@ module Google
       # supported by that API version, and the corresponding gem is available, the
       # appropriate versioned client will be returned.
       #
+      # Raises an exception if the currently installed versioned client gem for the
+      # given API version does not support the UserService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.user_service_available?}.
+      #
       # ## About UserService
       #
       # Provides methods for handling User objects.
@@ -416,6 +817,34 @@ module Google
         service_module = Google::Ads::AdManager.const_get(package_name).const_get(:UserService)
         service_module.const_get(:Rest).const_get(:Client).new(&block)
       end
+
+      ##
+      # Determines whether the UserService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.user_service}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the UserService service,
+      # or if the versioned client gem needs an update to support the UserService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.user_service_available? version: :v1
+        require "google/ads/ad_manager/#{version.to_s.downcase}"
+        package_name = Google::Ads::AdManager
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Ads::AdManager.const_get package_name
+        return false unless service_module.const_defined? :UserService
+        service_module = service_module.const_get :UserService
+        return false unless service_module.const_defined? :Rest
+        service_module = service_module.const_get :Rest
+        service_module.const_defined? :Client
+      rescue ::LoadError
+        false
+      end
     end
   end
 end

metadata

@@ -1,35 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: google-ads-ad_manager
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Google LLC
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-28 00:00:00.000000000 Z
+date: 2025-02-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-ads-ad_manager-v1
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0.0'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.a
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0.0'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.a
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
   requirement: !ruby/object:Gem::Requirement
@@ -62,7 +55,6 @@ homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -70,15 +62,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.3
 specification_version: 4
 summary: Manage your Ad Manager inventory, run reports and more.
 test_files: []