google-ads-ad_manager 5.0.1 → 5.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b225a1b95867c5e4ce2e3e033b4d08b686787bd91cfdaac5b63d706fbd7bdb59
-  data.tar.gz: 688a3b582a68fa51b68387a58021bdf1b7092445934141b072f622ffad4eb35b
+  metadata.gz: a363132388fac3f60be9c21402bb25edb2aa06846d2c03c9c353a2b31acaadaa
+  data.tar.gz: 416d1519edf3a12ba980ab15c947bdc887dbcd3903720194f2d0e2f2b9605f72
 SHA512:
-  metadata.gz: c2e89a9c643a7195e00d813834c53e03ebe9eb91eb7ea014934e7d1e1843e321bd3e131911b17951e85c23132b27c27190544d8620a7ddfafe734eacce60272a
-  data.tar.gz: cee47f945842d4d47713ac19f430ed7ca51017cf302f9b8b1687697004985576eda04b5ab9f309e4f4b21c96ef1e859719581ebaa73c94a76bb350ee84ba0eb4
+  metadata.gz: ec7c682582dcd578c261ed388a0ad7d5b49015eb7f64b196e14a3a76f37741c711d34ee01b57967451f85e9d70c2f973902ff7a776e12d9cf35e456a7ca272ea
+  data.tar.gz: db8ef486005eacfdf109ab3d5b197753a274204a8ad38f7b81197c0140a7514ac63f15db7b1575add6d18ac254257a43feb4df13d4d00382cd5258c7188fa4fc

data/README.md

@@ -2,7 +2,6 @@
 
 Manage your Ad Manager inventory, run reports and more.
 
-The Ad Manager API enables an app to integrate with Google Ad Manager. You can read and write Ad Manager data and run reports using the API.
 
 Actual client classes for the various versions of this API are defined in
 _versioned_ client gems, with names of the form `google-ads-ad_manager-v*`.

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

@@ -20,7 +20,7 @@
 module Google
   module Ads
     module AdManager
-      VERSION = "5.0.1"
+      VERSION = "5.1.0"
     end
   end
 end

data/lib/google/ads/ad_manager.rb

@@ -720,6 +720,70 @@ module Google
         false
       end
 
+      ##
+      # Create a new client object for ChildPublisherService.
+      #
+      # By default, this returns an instance of
+      # [Google::Ads::AdManager::V1::ChildPublisherService::Rest::Client](https://rubydoc.info/gems/google-ads-ad_manager-v1/Google/Ads/AdManager/V1/ChildPublisherService/Rest/Client)
+      # for a REST client for version V1 of the API.
+      # However, you can specify a different API version by passing it in the
+      # `version` parameter. If the ChildPublisherService service is
+      # 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 ChildPublisherService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.child_publisher_service_available?}.
+      #
+      # ## About ChildPublisherService
+      #
+      # Provides methods for handling
+      # ChildPublisher objects.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [::Object] A client object for the specified version.
+      #
+      def self.child_publisher_service version: :v1, &block
+        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
+        service_module = Google::Ads::AdManager.const_get(package_name).const_get(:ChildPublisherService)
+        service_module.const_get(:Rest).const_get(:Client).new(&block)
+      end
+
+      ##
+      # Determines whether the ChildPublisherService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.child_publisher_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 ChildPublisherService service,
+      # or if the versioned client gem needs an update to support the ChildPublisherService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.child_publisher_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? :ChildPublisherService
+        service_module = service_module.const_get :ChildPublisherService
+        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 CmsMetadataKeyService.
       #
@@ -864,7 +928,8 @@ module Google
       #
       # ## About CompanyService
       #
-      # Provides methods for handling `Company` objects.
+      # Provides methods for handling Company
+      # objects.
       #
       # @param version [::String, ::Symbol] The API version to connect to. Optional.
       #   Defaults to `:v1`.
@@ -1287,6 +1352,69 @@ module Google
         false
       end
 
+      ##
+      # Create a new client object for CreativeWrapperService.
+      #
+      # By default, this returns an instance of
+      # [Google::Ads::AdManager::V1::CreativeWrapperService::Rest::Client](https://rubydoc.info/gems/google-ads-ad_manager-v1/Google/Ads/AdManager/V1/CreativeWrapperService/Rest/Client)
+      # for a REST client for version V1 of the API.
+      # However, you can specify a different API version by passing it in the
+      # `version` parameter. If the CreativeWrapperService service is
+      # 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 CreativeWrapperService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.creative_wrapper_service_available?}.
+      #
+      # ## About CreativeWrapperService
+      #
+      # Provides methods for handling `CreativeWrapper` objects.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [::Object] A client object for the specified version.
+      #
+      def self.creative_wrapper_service version: :v1, &block
+        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
+        service_module = Google::Ads::AdManager.const_get(package_name).const_get(:CreativeWrapperService)
+        service_module.const_get(:Rest).const_get(:Client).new(&block)
+      end
+
+      ##
+      # Determines whether the CreativeWrapperService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.creative_wrapper_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 CreativeWrapperService service,
+      # or if the versioned client gem needs an update to support the CreativeWrapperService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.creative_wrapper_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? :CreativeWrapperService
+        service_module = service_module.const_get :CreativeWrapperService
+        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.
       #
@@ -1476,6 +1604,132 @@ module Google
         false
       end
 
+      ##
+      # Create a new client object for DaiAuthenticationKeyService.
+      #
+      # By default, this returns an instance of
+      # [Google::Ads::AdManager::V1::DaiAuthenticationKeyService::Rest::Client](https://rubydoc.info/gems/google-ads-ad_manager-v1/Google/Ads/AdManager/V1/DaiAuthenticationKeyService/Rest/Client)
+      # for a REST client for version V1 of the API.
+      # However, you can specify a different API version by passing it in the
+      # `version` parameter. If the DaiAuthenticationKeyService service is
+      # 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 DaiAuthenticationKeyService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.dai_authentication_key_service_available?}.
+      #
+      # ## About DaiAuthenticationKeyService
+      #
+      # Provides methods for handling `DaiAuthenticationKey` objects.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [::Object] A client object for the specified version.
+      #
+      def self.dai_authentication_key_service version: :v1, &block
+        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
+        service_module = Google::Ads::AdManager.const_get(package_name).const_get(:DaiAuthenticationKeyService)
+        service_module.const_get(:Rest).const_get(:Client).new(&block)
+      end
+
+      ##
+      # Determines whether the DaiAuthenticationKeyService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.dai_authentication_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 DaiAuthenticationKeyService service,
+      # or if the versioned client gem needs an update to support the DaiAuthenticationKeyService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.dai_authentication_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? :DaiAuthenticationKeyService
+        service_module = service_module.const_get :DaiAuthenticationKeyService
+        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 DaiEncodingProfileService.
+      #
+      # By default, this returns an instance of
+      # [Google::Ads::AdManager::V1::DaiEncodingProfileService::Rest::Client](https://rubydoc.info/gems/google-ads-ad_manager-v1/Google/Ads/AdManager/V1/DaiEncodingProfileService/Rest/Client)
+      # for a REST client for version V1 of the API.
+      # However, you can specify a different API version by passing it in the
+      # `version` parameter. If the DaiEncodingProfileService service is
+      # 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 DaiEncodingProfileService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.dai_encoding_profile_service_available?}.
+      #
+      # ## About DaiEncodingProfileService
+      #
+      # Provides methods for handling `DaiEncodingProfile` objects.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [::Object] A client object for the specified version.
+      #
+      def self.dai_encoding_profile_service version: :v1, &block
+        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
+        service_module = Google::Ads::AdManager.const_get(package_name).const_get(:DaiEncodingProfileService)
+        service_module.const_get(:Rest).const_get(:Client).new(&block)
+      end
+
+      ##
+      # Determines whether the DaiEncodingProfileService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.dai_encoding_profile_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 DaiEncodingProfileService service,
+      # or if the versioned client gem needs an update to support the DaiEncodingProfileService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.dai_encoding_profile_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? :DaiEncodingProfileService
+        service_module = service_module.const_get :DaiEncodingProfileService
+        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 DeviceCapabilityService.
       #
@@ -2295,6 +2549,69 @@ module Google
         false
       end
 
+      ##
+      # Create a new client object for NativeStyleService.
+      #
+      # By default, this returns an instance of
+      # [Google::Ads::AdManager::V1::NativeStyleService::Rest::Client](https://rubydoc.info/gems/google-ads-ad_manager-v1/Google/Ads/AdManager/V1/NativeStyleService/Rest/Client)
+      # for a REST client for version V1 of the API.
+      # However, you can specify a different API version by passing it in the
+      # `version` parameter. If the NativeStyleService service is
+      # 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 NativeStyleService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.native_style_service_available?}.
+      #
+      # ## About NativeStyleService
+      #
+      # Provides methods for handling `NativeStyle` objects.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [::Object] A client object for the specified version.
+      #
+      def self.native_style_service version: :v1, &block
+        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
+        service_module = Google::Ads::AdManager.const_get(package_name).const_get(:NativeStyleService)
+        service_module.const_get(:Rest).const_get(:Client).new(&block)
+      end
+
+      ##
+      # Determines whether the NativeStyleService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.native_style_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 NativeStyleService service,
+      # or if the versioned client gem needs an update to support the NativeStyleService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.native_style_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? :NativeStyleService
+        service_module = service_module.const_get :NativeStyleService
+        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.
       #
@@ -2547,6 +2864,70 @@ module Google
         false
       end
 
+      ##
+      # Create a new client object for PartnerService.
+      #
+      # By default, this returns an instance of
+      # [Google::Ads::AdManager::V1::PartnerService::Rest::Client](https://rubydoc.info/gems/google-ads-ad_manager-v1/Google/Ads/AdManager/V1/PartnerService/Rest/Client)
+      # for a REST client for version V1 of the API.
+      # However, you can specify a different API version by passing it in the
+      # `version` parameter. If the PartnerService service is
+      # 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 PartnerService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.partner_service_available?}.
+      #
+      # ## About PartnerService
+      #
+      # Provides methods for handling Partner
+      # objects.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [::Object] A client object for the specified version.
+      #
+      def self.partner_service version: :v1, &block
+        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
+        service_module = Google::Ads::AdManager.const_get(package_name).const_get(:PartnerService)
+        service_module.const_get(:Rest).const_get(:Client).new(&block)
+      end
+
+      ##
+      # Determines whether the PartnerService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.partner_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 PartnerService service,
+      # or if the versioned client gem needs an update to support the PartnerService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.partner_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? :PartnerService
+        service_module = service_module.const_get :PartnerService
+        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.
       #
@@ -3492,6 +3873,70 @@ module Google
       rescue ::LoadError
         false
       end
+
+      ##
+      # Create a new client object for ViewabilityProviderService.
+      #
+      # By default, this returns an instance of
+      # [Google::Ads::AdManager::V1::ViewabilityProviderService::Rest::Client](https://rubydoc.info/gems/google-ads-ad_manager-v1/Google/Ads/AdManager/V1/ViewabilityProviderService/Rest/Client)
+      # for a REST client for version V1 of the API.
+      # However, you can specify a different API version by passing it in the
+      # `version` parameter. If the ViewabilityProviderService service is
+      # 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 ViewabilityProviderService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Ads::AdManager.viewability_provider_service_available?}.
+      #
+      # ## About ViewabilityProviderService
+      #
+      # Provides methods for handling
+      # ViewabilityProvider objects.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [::Object] A client object for the specified version.
+      #
+      def self.viewability_provider_service version: :v1, &block
+        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
+        service_module = Google::Ads::AdManager.const_get(package_name).const_get(:ViewabilityProviderService)
+        service_module.const_get(:Rest).const_get(:Client).new(&block)
+      end
+
+      ##
+      # Determines whether the ViewabilityProviderService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Ads::AdManager.viewability_provider_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 ViewabilityProviderService service,
+      # or if the versioned client gem needs an update to support the ViewabilityProviderService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.viewability_provider_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? :ViewabilityProviderService
+        service_module = service_module.const_get :ViewabilityProviderService
+        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,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-ads-ad_manager
 version: !ruby/object:Gem::Version
-  version: 5.0.1
+  version: 5.1.0
 platform: ruby
 authors:
 - Google LLC
@@ -37,8 +37,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.6'
-description: The Ad Manager API enables an app to integrate with Google Ad Manager.
-  You can read and write Ad Manager data and run reports using the API.
+description: Manage your Ad Manager inventory, run reports and more.
 email: googleapis-packages@google.com
 executables: []
 extensions: []