google-ads-ad_manager-v1 4.2.0 → 5.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ceaca0c04d061c14da969fdbe3f7d12f7e7551b55c0b9f3a4808262b4da58d3f
-  data.tar.gz: 36067c4d48964857730d4e1dc41a705d86ca03e59818334ba94b36e9d4b4cbcd
+  metadata.gz: 8cf6c7967b33f06b653fd40096ed3726ea1389bc8ed1d0db7ff4e822f3a9df48
+  data.tar.gz: 407c7071d0d6fbd57e4111a042cb5ccea9fd84c0c1b401caac58e583f78d90cd
 SHA512:
-  metadata.gz: 5c3c3d5e01c90ba95e2b4c1f49cdd61969b3cab639b08773acd3487cfb1381cf7a727014080cc956e774adcead61806ca36f42a33c248f42bbe2493494461048
-  data.tar.gz: 190a2babf21ecae9bb1f2fc78f51aeeefa9e211ad7c7ed88d1d706154cfb2d7c4485cdc9ea4ee9d15b0746a9fbc7421bb8efc978fefe2a4e32aee02298b66fc0
+  metadata.gz: ff8b5c11dd7a44bcfef97e3237a5cef2b4ed080fa88ee4631c35dd55da93f4f6027f56daa3c3a05dfa43e2873b82ace9122c4b7102c9a8b25a6731b6c5fabb70
+  data.tar.gz: f970dd15b30ab51fc0d3749f2cb86d7dfdab026dfde05e2a78a7593048f75f0bea2a85476a47ad773beb68a62e18498b726163576def110167fae44ae2a45fff

data/lib/google/ads/ad_manager/v1/company_service/rest/client.rb

@@ -177,7 +177,7 @@ module Google
               # Service calls
 
               ##
-              # API to retrieve a `Company` object.
+              # Retrieves a `Company` object.
               #
               # @overload get_company(request, options = nil)
               #   Pass arguments to `get_company` via a request object, either of type
@@ -256,7 +256,7 @@ module Google
               end
 
               ##
-              # API to retrieve a list of `Company` objects.
+              # Lists `Company` objects.
               #
               # @overload list_companies(request, options = nil)
               #   Pass arguments to `list_companies` via a request object, either of type

data/lib/google/ads/ad_manager/v1/contact_service/rest/client.rb

@@ -177,7 +177,7 @@ module Google
               # Service calls
 
               ##
-              # API to retrieve a `Contact` object.
+              # Retrieves a `Contact` object.
               #
               # @overload get_contact(request, options = nil)
               #   Pass arguments to `get_contact` via a request object, either of type
@@ -256,7 +256,7 @@ module Google
               end
 
               ##
-              # API to retrieve a list of `Contact` objects.
+              # Lists `Contact` objects.
               #
               # @overload list_contacts(request, options = nil)
               #   Pass arguments to `list_contacts` via a request object, either of type
@@ -377,7 +377,7 @@ module Google
               end
 
               ##
-              # API to create a `Contact` object.
+              # Creates a `Contact` object.
               #
               # @overload create_contact(request, options = nil)
               #   Pass arguments to `create_contact` via a request object, either of type
@@ -458,7 +458,7 @@ module Google
               end
 
               ##
-              # API to batch create `Contact` objects.
+              # Creates `Contact` objects.
               #
               # @overload batch_create_contacts(request, options = nil)
               #   Pass arguments to `batch_create_contacts` via a request object, either of type
@@ -542,7 +542,7 @@ module Google
               end
 
               ##
-              # API to update a `Contact` object.
+              # Updates a `Contact` object.
               #
               # @overload update_contact(request, options = nil)
               #   Pass arguments to `update_contact` via a request object, either of type
@@ -624,7 +624,7 @@ module Google
               end
 
               ##
-              # API to batch update `Contact` objects.
+              # Batch updates `Contact` objects.
               #
               # @overload batch_update_contacts(request, options = nil)
               #   Pass arguments to `batch_update_contacts` via a request object, either of type

data/lib/google/ads/ad_manager/v1/content_bundle_service/rest/client.rb

@@ -369,6 +369,171 @@ module Google
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
+              ##
+              # Activate a list of `ContentBundle` objects.
+              #
+              # @overload batch_activate_content_bundles(request, options = nil)
+              #   Pass arguments to `batch_activate_content_bundles` via a request object, either of type
+              #   {::Google::Ads::AdManager::V1::BatchActivateContentBundlesRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Ads::AdManager::V1::BatchActivateContentBundlesRequest, ::Hash]
+              #     A request object representing the call parameters. Required. To specify no
+              #     parameters, or to keep all the default parameter values, pass an empty Hash.
+              #   @param options [::Gapic::CallOptions, ::Hash]
+              #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @overload batch_activate_content_bundles(parent: nil, names: nil)
+              #   Pass arguments to `batch_activate_content_bundles` via keyword arguments. Note that at
+              #   least one keyword argument is required. To specify no parameters, or to keep all
+              #   the default parameter values, pass an empty Hash as a request object (see above).
+              #
+              #   @param parent [::String]
+              #     Required. The parent resource where `ContentBundles` will be activated.
+              #     Format: `networks/{network_code}`
+              #   @param names [::Array<::String>]
+              #     Required. The resource names of the `ContentBundle`s to activate.
+              #     Format: `networks/{network_code}/contentBundles/{content_bundle_id}`
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Ads::AdManager::V1::BatchActivateContentBundlesResponse]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Ads::AdManager::V1::BatchActivateContentBundlesResponse]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/ads/ad_manager/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Ads::AdManager::V1::ContentBundleService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Ads::AdManager::V1::BatchActivateContentBundlesRequest.new
+              #
+              #   # Call the batch_activate_content_bundles method.
+              #   result = client.batch_activate_content_bundles request
+              #
+              #   # The returned object is of type Google::Ads::AdManager::V1::BatchActivateContentBundlesResponse.
+              #   p result
+              #
+              def batch_activate_content_bundles request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Ads::AdManager::V1::BatchActivateContentBundlesRequest
+
+                # Converts hash and nil to an options object
+                options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                # Customize the options with defaults
+                call_metadata = @config.rpcs.batch_activate_content_bundles.metadata.to_h
+
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                  lib_name: @config.lib_name, lib_version: @config.lib_version,
+                  gapic_version: ::Google::Ads::AdManager::V1::VERSION,
+                  transports_version_send: [:rest]
+
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.batch_activate_content_bundles.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.batch_activate_content_bundles.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @content_bundle_service_stub.batch_activate_content_bundles request, options do |result, operation|
+                  yield result, operation if block_given?
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
+              ##
+              # Deactivates a list of `ContentBundle` objects.
+              #
+              # @overload batch_deactivate_content_bundles(request, options = nil)
+              #   Pass arguments to `batch_deactivate_content_bundles` via a request object, either of type
+              #   {::Google::Ads::AdManager::V1::BatchDeactivateContentBundlesRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Ads::AdManager::V1::BatchDeactivateContentBundlesRequest, ::Hash]
+              #     A request object representing the call parameters. Required. To specify no
+              #     parameters, or to keep all the default parameter values, pass an empty Hash.
+              #   @param options [::Gapic::CallOptions, ::Hash]
+              #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @overload batch_deactivate_content_bundles(parent: nil, names: nil)
+              #   Pass arguments to `batch_deactivate_content_bundles` via keyword arguments. Note that at
+              #   least one keyword argument is required. To specify no parameters, or to keep all
+              #   the default parameter values, pass an empty Hash as a request object (see above).
+              #
+              #   @param parent [::String]
+              #     Required. The parent resource where `ContentBundles` will be
+              #     deactivated.
+              #     Format: `networks/{network_code}`
+              #   @param names [::Array<::String>]
+              #     Required. The resource names of the `ContentBundle`s to deactivate.
+              #     Format: `networks/{network_code}/contentBundles/{content_bundle_id}`
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Ads::AdManager::V1::BatchDeactivateContentBundlesResponse]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Ads::AdManager::V1::BatchDeactivateContentBundlesResponse]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/ads/ad_manager/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Ads::AdManager::V1::ContentBundleService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Ads::AdManager::V1::BatchDeactivateContentBundlesRequest.new
+              #
+              #   # Call the batch_deactivate_content_bundles method.
+              #   result = client.batch_deactivate_content_bundles request
+              #
+              #   # The returned object is of type Google::Ads::AdManager::V1::BatchDeactivateContentBundlesResponse.
+              #   p result
+              #
+              def batch_deactivate_content_bundles request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Ads::AdManager::V1::BatchDeactivateContentBundlesRequest
+
+                # Converts hash and nil to an options object
+                options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                # Customize the options with defaults
+                call_metadata = @config.rpcs.batch_deactivate_content_bundles.metadata.to_h
+
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                  lib_name: @config.lib_name, lib_version: @config.lib_version,
+                  gapic_version: ::Google::Ads::AdManager::V1::VERSION,
+                  transports_version_send: [:rest]
+
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.batch_deactivate_content_bundles.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.batch_deactivate_content_bundles.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @content_bundle_service_stub.batch_deactivate_content_bundles request, options do |result, operation|
+                  yield result, operation if block_given?
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
               ##
               # Configuration class for the ContentBundleService REST API.
               #
@@ -527,6 +692,16 @@ module Google
                   # @return [::Gapic::Config::Method]
                   #
                   attr_reader :list_content_bundles
+                  ##
+                  # RPC-specific configuration for `batch_activate_content_bundles`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :batch_activate_content_bundles
+                  ##
+                  # RPC-specific configuration for `batch_deactivate_content_bundles`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :batch_deactivate_content_bundles
 
                   # @private
                   def initialize parent_rpcs = nil
@@ -534,6 +709,10 @@ module Google
                     @get_content_bundle = ::Gapic::Config::Method.new get_content_bundle_config
                     list_content_bundles_config = parent_rpcs.list_content_bundles if parent_rpcs.respond_to? :list_content_bundles
                     @list_content_bundles = ::Gapic::Config::Method.new list_content_bundles_config
+                    batch_activate_content_bundles_config = parent_rpcs.batch_activate_content_bundles if parent_rpcs.respond_to? :batch_activate_content_bundles
+                    @batch_activate_content_bundles = ::Gapic::Config::Method.new batch_activate_content_bundles_config
+                    batch_deactivate_content_bundles_config = parent_rpcs.batch_deactivate_content_bundles if parent_rpcs.respond_to? :batch_deactivate_content_bundles
+                    @batch_deactivate_content_bundles = ::Gapic::Config::Method.new batch_deactivate_content_bundles_config
 
                     yield self if block_given?
                   end

data/lib/google/ads/ad_manager/v1/content_bundle_service/rest/service_stub.rb

@@ -153,6 +153,86 @@ module Google
                 end
               end
 
+              ##
+              # Baseline implementation for the batch_activate_content_bundles REST call
+              #
+              # @param request_pb [::Google::Ads::AdManager::V1::BatchActivateContentBundlesRequest]
+              #   A request object representing the call parameters. Required.
+              # @param options [::Gapic::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Ads::AdManager::V1::BatchActivateContentBundlesResponse]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Ads::AdManager::V1::BatchActivateContentBundlesResponse]
+              #   A result object deserialized from the server's reply
+              def batch_activate_content_bundles request_pb, options = nil
+                raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                verb, uri, query_string_params, body = ServiceStub.transcode_batch_activate_content_bundles_request request_pb
+                query_string_params = if query_string_params.any?
+                                        query_string_params.to_h { |p| p.split "=", 2 }
+                                      else
+                                        {}
+                                      end
+
+                response = @client_stub.make_http_request(
+                  verb,
+                  uri: uri,
+                  body: body || "",
+                  params: query_string_params,
+                  method_name: "batch_activate_content_bundles",
+                  options: options
+                )
+                operation = ::Gapic::Rest::TransportOperation.new response
+                result = ::Google::Ads::AdManager::V1::BatchActivateContentBundlesResponse.decode_json response.body, ignore_unknown_fields: true
+                catch :response do
+                  yield result, operation if block_given?
+                  result
+                end
+              end
+
+              ##
+              # Baseline implementation for the batch_deactivate_content_bundles REST call
+              #
+              # @param request_pb [::Google::Ads::AdManager::V1::BatchDeactivateContentBundlesRequest]
+              #   A request object representing the call parameters. Required.
+              # @param options [::Gapic::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Ads::AdManager::V1::BatchDeactivateContentBundlesResponse]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Ads::AdManager::V1::BatchDeactivateContentBundlesResponse]
+              #   A result object deserialized from the server's reply
+              def batch_deactivate_content_bundles request_pb, options = nil
+                raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                verb, uri, query_string_params, body = ServiceStub.transcode_batch_deactivate_content_bundles_request request_pb
+                query_string_params = if query_string_params.any?
+                                        query_string_params.to_h { |p| p.split "=", 2 }
+                                      else
+                                        {}
+                                      end
+
+                response = @client_stub.make_http_request(
+                  verb,
+                  uri: uri,
+                  body: body || "",
+                  params: query_string_params,
+                  method_name: "batch_deactivate_content_bundles",
+                  options: options
+                )
+                operation = ::Gapic::Rest::TransportOperation.new response
+                result = ::Google::Ads::AdManager::V1::BatchDeactivateContentBundlesResponse.decode_json response.body, ignore_unknown_fields: true
+                catch :response do
+                  yield result, operation if block_given?
+                  result
+                end
+              end
+
               ##
               # @private
               #
@@ -194,6 +274,50 @@ module Google
                                                         )
                 transcoder.transcode request_pb
               end
+
+              ##
+              # @private
+              #
+              # GRPC transcoding helper method for the batch_activate_content_bundles REST call
+              #
+              # @param request_pb [::Google::Ads::AdManager::V1::BatchActivateContentBundlesRequest]
+              #   A request object representing the call parameters. Required.
+              # @return [Array(String, [String, nil], Hash{String => String})]
+              #   Uri, Body, Query string parameters
+              def self.transcode_batch_activate_content_bundles_request request_pb
+                transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1/{parent}/contentBundles:batchActivate",
+                                                          body: "*",
+                                                          matches: [
+                                                            ["parent", %r{^networks/[^/]+/?$}, false]
+                                                          ]
+                                                        )
+                transcoder.transcode request_pb
+              end
+
+              ##
+              # @private
+              #
+              # GRPC transcoding helper method for the batch_deactivate_content_bundles REST call
+              #
+              # @param request_pb [::Google::Ads::AdManager::V1::BatchDeactivateContentBundlesRequest]
+              #   A request object representing the call parameters. Required.
+              # @return [Array(String, [String, nil], Hash{String => String})]
+              #   Uri, Body, Query string parameters
+              def self.transcode_batch_deactivate_content_bundles_request request_pb
+                transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1/{parent}/contentBundles:batchDeactivate",
+                                                          body: "*",
+                                                          matches: [
+                                                            ["parent", %r{^networks/[^/]+/?$}, false]
+                                                          ]
+                                                        )
+                transcoder.transcode request_pb
+              end
             end
           end
         end

data/lib/google/ads/ad_manager/v1/creative_set_service/credentials.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "googleauth"
+
+module Google
+  module Ads
+    module AdManager
+      module V1
+        module CreativeSetService
+          # Credentials for the CreativeSetService API.
+          class Credentials < ::Google::Auth::Credentials
+            self.scope = [
+              "https://www.googleapis.com/auth/admanager",
+              "https://www.googleapis.com/auth/admanager.readonly"
+            ]
+            self.env_vars = [
+              "GOOGLE_CLOUD_CREDENTIALS",
+              "GOOGLE_CLOUD_KEYFILE",
+              "GCLOUD_KEYFILE",
+              "GOOGLE_CLOUD_CREDENTIALS_JSON",
+              "GOOGLE_CLOUD_KEYFILE_JSON",
+              "GCLOUD_KEYFILE_JSON"
+            ]
+            self.paths = [
+              "~/.config/google_cloud/application_default_credentials.json"
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/ads/ad_manager/v1/creative_set_service/paths.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Ads
+    module AdManager
+      module V1
+        module CreativeSetService
+          # Path helper methods for the CreativeSetService API.
+          module Paths
+            ##
+            # Create a fully-qualified Creative resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `networks/{network_code}/creatives/{creative}`
+            #
+            # @param network_code [String]
+            # @param creative [String]
+            #
+            # @return [::String]
+            def creative_path network_code:, creative:
+              raise ::ArgumentError, "network_code cannot contain /" if network_code.to_s.include? "/"
+
+              "networks/#{network_code}/creatives/#{creative}"
+            end
+
+            ##
+            # Create a fully-qualified CreativeSet resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `networks/{network_code}/creativeSets/{creative_set}`
+            #
+            # @param network_code [String]
+            # @param creative_set [String]
+            #
+            # @return [::String]
+            def creative_set_path network_code:, creative_set:
+              raise ::ArgumentError, "network_code cannot contain /" if network_code.to_s.include? "/"
+
+              "networks/#{network_code}/creativeSets/#{creative_set}"
+            end
+
+            ##
+            # Create a fully-qualified Network resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `networks/{network_code}`
+            #
+            # @param network_code [String]
+            #
+            # @return [::String]
+            def network_path network_code:
+              "networks/#{network_code}"
+            end
+
+            extend self
+          end
+        end
+      end
+    end
+  end
+end