google-ads-ad_manager-v1 2.2.0 → 2.3.0

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

@@ -73,8 +73,8 @@ module Google
         #   @return [::Integer]
         #     Optional. The maximum number of `Reports` to return. The service may return
         #     fewer than this value. If unspecified, at most 50 `Reports` will be
-        #     returned. The maximum value is 1000; values above 1000 will be coerced to
-        #     1000.
+        #     returned. The maximum value is 1000; values greater than 1000 will be
+        #     coerced to 1000.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Optional. A page token, received from a previous `ListReports` call.
@@ -115,7 +115,7 @@ module Google
         #     If a filter was included in the request, this reflects the total number
         #     after the filtering is applied.
         #
-        #     `total_size` will not be calculated in the response unless it has been
+        #     `total_size` won't be calculated in the response unless it has been
         #     included in a response field mask. The response field mask can be provided
         #     to the method by using the URL parameter `$fields` or `fields`, or by using
         #     the HTTP/gRPC header `X-Goog-FieldMask`.
@@ -162,7 +162,8 @@ module Google
         #   @return [::Integer]
         #     Optional. The maximum number of rows to return. The service may return
         #     fewer than this value. If unspecified, at most 1,000 rows will be returned.
-        #     The maximum value is 10,000; values above 10,000 will be reduced to 10,000.
+        #     The maximum value is 10,000; values greater than 10,000 will be reduced to
+        #     10,000.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Optional. A page token, received from a previous `FetchReportResultRows`
@@ -174,19 +175,19 @@ module Google
 
         # The response message for the fetch report result rows endpoint.
         # @!attribute [rw] rows
-        #   @return [::Array<::Google::Ads::AdManager::V1::Report::DataTable::Row>]
+        #   @return [::Array<::Google::Ads::AdManager::V1::ReportDataTable::Row>]
         #     Up to `page_size` rows of report data.
         # @!attribute [rw] run_time
         #   @return [::Google::Protobuf::Timestamp]
         #     The time at which the report was scheduled to run. For non-scheduled
         #     reports, this is the time at which the report was requested to be run.
         # @!attribute [rw] date_ranges
-        #   @return [::Array<::Google::Ads::AdManager::V1::Report::DateRange::FixedDateRange>]
+        #   @return [::Array<::Google::Ads::AdManager::V1::ReportDefinition::DateRange::FixedDateRange>]
         #     The computed fixed date ranges this report includes.
         #     Only returned with the first page of results (when page_token is not
         #     included in the request).
         # @!attribute [rw] comparison_date_ranges
-        #   @return [::Array<::Google::Ads::AdManager::V1::Report::DateRange::FixedDateRange>]
+        #   @return [::Array<::Google::Ads::AdManager::V1::ReportDefinition::DateRange::FixedDateRange>]
         #     The computed comparison fixed date ranges this report includes.
         #     Only returned with the first page of results (when page_token is not
         #     included in the request).

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

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+# Copyright 2025 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
+        # Represents a single value in a report.
+        # @!attribute [rw] int_value
+        #   @return [::Integer]
+        #     For integer values.
+        #
+        #     Note: The following fields are mutually exclusive: `int_value`, `double_value`, `string_value`, `bool_value`, `int_list_value`, `string_list_value`, `double_list_value`, `bytes_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] double_value
+        #   @return [::Float]
+        #     For double values.
+        #
+        #     Note: The following fields are mutually exclusive: `double_value`, `int_value`, `string_value`, `bool_value`, `int_list_value`, `string_list_value`, `double_list_value`, `bytes_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] string_value
+        #   @return [::String]
+        #     For string values.
+        #
+        #     Note: The following fields are mutually exclusive: `string_value`, `int_value`, `double_value`, `bool_value`, `int_list_value`, `string_list_value`, `double_list_value`, `bytes_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] bool_value
+        #   @return [::Boolean]
+        #     For boolean values.
+        #
+        #     Note: The following fields are mutually exclusive: `bool_value`, `int_value`, `double_value`, `string_value`, `int_list_value`, `string_list_value`, `double_list_value`, `bytes_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] int_list_value
+        #   @return [::Google::Ads::AdManager::V1::ReportValue::IntList]
+        #     For lists of integer values.
+        #
+        #     Note: The following fields are mutually exclusive: `int_list_value`, `int_value`, `double_value`, `string_value`, `bool_value`, `string_list_value`, `double_list_value`, `bytes_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] string_list_value
+        #   @return [::Google::Ads::AdManager::V1::ReportValue::StringList]
+        #     For lists of string values.
+        #
+        #     Note: The following fields are mutually exclusive: `string_list_value`, `int_value`, `double_value`, `string_value`, `bool_value`, `int_list_value`, `double_list_value`, `bytes_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] double_list_value
+        #   @return [::Google::Ads::AdManager::V1::ReportValue::DoubleList]
+        #     For lists of double values.
+        #
+        #     Note: The following fields are mutually exclusive: `double_list_value`, `int_value`, `double_value`, `string_value`, `bool_value`, `int_list_value`, `string_list_value`, `bytes_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] bytes_value
+        #   @return [::String]
+        #     For bytes values.
+        #
+        #     Note: The following fields are mutually exclusive: `bytes_value`, `int_value`, `double_value`, `string_value`, `bool_value`, `int_list_value`, `string_list_value`, `double_list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        class ReportValue
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # A list of integer values.
+          # @!attribute [rw] values
+          #   @return [::Array<::Integer>]
+          #     The values
+          class IntList
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # A list of string values.
+          # @!attribute [rw] values
+          #   @return [::Array<::String>]
+          #     The values
+          class StringList
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # A list of double values.
+          # @!attribute [rw] values
+          #   @return [::Array<::Float>]
+          #     The values
+          class DoubleList
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -40,7 +40,8 @@ module Google
         #   @return [::Integer]
         #     Optional. The maximum number of `Roles` to return. The service may return
         #     fewer than this value. If unspecified, at most 50 `Roles` will be returned.
-        #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+        #     The maximum value is 1000; values greater than 1000 will be coerced to
+        #     1000.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Optional. A page token, received from a previous `ListRoles` call.
@@ -80,7 +81,7 @@ module Google
         #     If a filter was included in the request, this reflects the total number
         #     after the filtering is applied.
         #
-        #     `total_size` will not be calculated in the response unless it has been
+        #     `total_size` won't be calculated in the response unless it has been
         #     included in a response field mask. The response field mask can be provided
         #     to the method by using the URL parameter `$fields` or `fields`, or by using
         #     the HTTP/gRPC header `X-Goog-FieldMask`.

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

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+# Copyright 2025 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
+        # Wrapper message for
+        # {::Google::Ads::AdManager::V1::SiteDisapprovalReasonEnum::SiteDisapprovalReason SiteDisapprovalReason}
+        class SiteDisapprovalReasonEnum
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The list of possible policy violation types for a Site.
+          module SiteDisapprovalReason
+            # Default value. This value is unused.
+            SITE_DISAPPROVAL_REASON_UNSPECIFIED = 0
+
+            # The site has content that violates policy.
+            CONTENT = 1
+
+            # Generic error type.
+            OTHER = 2
+
+            # The parent must be an authorized seller of the child network's inventory.
+            OWNERSHIP = 3
+          end
+        end
+
+        # Wrapper message for
+        # {::Google::Ads::AdManager::V1::SiteApprovalStatusEnum::SiteApprovalStatus SiteApprovalStatus}
+        class SiteApprovalStatusEnum
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Represents the approval status of a site.
+          module SiteApprovalStatus
+            # Default value. This value is unused.
+            SITE_APPROVAL_STATUS_UNSPECIFIED = 0
+
+            # The site has been approved to serve ads.
+            APPROVED = 1
+
+            # The site has been disapproved from serving ads.
+            DISAPPROVED = 2
+
+            # The default status with which a site is created.
+            DRAFT = 3
+
+            # The site has been deactivated and is not serving ads due to dormancy. It
+            # must be resubmitted for approval.
+            REQUIRES_REVIEW = 4
+
+            # Once the site is submitted for approval, its status changes from draft to
+            # unchecked. It will be reviwed with an estimated turn-around time of 24h.
+            # Such a site cannot serve ads.
+            UNCHECKED = 5
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+# Copyright 2025 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
+        # A Site represents a domain owned or represented by a network. For a parent
+        # network managing other networks as part of Multiple Customer Management
+        # "Manage Inventory" model, it could be the child's domain.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. The resource name of the `Site`.
+        #     Format: `networks/{network_code}/sites/{site_id}`
+        # @!attribute [rw] url
+        #   @return [::String]
+        #     Required. The URL of the Site.
+        # @!attribute [rw] child_network_code
+        #   @return [::String]
+        #     Optional. The network code of the child if the Site is being managed for an
+        #     MCM child network, or null if owned by this network.
+        # @!attribute [r] approval_status
+        #   @return [::Google::Ads::AdManager::V1::SiteApprovalStatusEnum::SiteApprovalStatus]
+        #     Output only. Status of the review performed on the Site by Google.
+        # @!attribute [r] approval_status_update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The latest Site approval status change time.
+        # @!attribute [r] disapproval_reasons
+        #   @return [::Array<::Google::Ads::AdManager::V1::DisapprovalReason>]
+        #     Output only. Provides reasons for disapproving the Site. It is null when
+        #     the Site is not disapproved.
+        class Site
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Represents the reason for which Google disapproved the Site.
+        # @!attribute [r] type
+        #   @return [::Google::Ads::AdManager::V1::SiteDisapprovalReasonEnum::SiteDisapprovalReason]
+        #     Output only. The type of policy violation found for the Site.
+        # @!attribute [r] details
+        #   @return [::String]
+        #     Output only. Additional details for the disapproval of the Site.
+        class DisapprovalReason
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,211 @@
+# frozen_string_literal: true
+
+# Copyright 2025 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
+        # Request object for `GetSite` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the Site.
+        #     Format: `networks/{network_code}/sites/{site_id}`
+        class GetSiteRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request object for `ListSites` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent, which owns this collection of Sites.
+        #     Format: `networks/{network_code}`
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The maximum number of `Sites` to return. The service may return
+        #     fewer than this value. If unspecified, at most 50 `Sites` will be returned.
+        #     The maximum value is 1000; values greater than 1000 will be coerced to
+        #     1000.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A page token, received from a previous `ListSites` call.
+        #     Provide this to retrieve the subsequent page.
+        #
+        #     When paginating, all other parameters provided to `ListSites` must match
+        #     the call that provided the page token.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. Expression to filter the response.
+        #     See syntax details at
+        #     https://developers.google.com/ad-manager/api/beta/filters
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Optional. Expression to specify sorting order.
+        #     See syntax details at
+        #     https://developers.google.com/ad-manager/api/beta/filters#order
+        # @!attribute [rw] skip
+        #   @return [::Integer]
+        #     Optional. Number of individual resources to skip while paginating.
+        class ListSitesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response object for `ListSitesRequest` containing matching `Site` objects.
+        # @!attribute [rw] sites
+        #   @return [::Array<::Google::Ads::AdManager::V1::Site>]
+        #     The `Site` objects from the specified network.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token, which can be sent as `page_token` to retrieve the next page.
+        #     If this field is omitted, there are no subsequent pages.
+        # @!attribute [rw] total_size
+        #   @return [::Integer]
+        #     Total number of `Site` objects.
+        #     If a filter was included in the request, this reflects the total number
+        #     after the filtering is applied.
+        #
+        #     `total_size` won't be calculated in the response unless it has been
+        #     included in a response field mask. The response field mask can be provided
+        #     to the method by using the URL parameter `$fields` or `fields`, or by using
+        #     the HTTP/gRPC header `X-Goog-FieldMask`.
+        #
+        #     For more information, see
+        #     https://developers.google.com/ad-manager/api/beta/field-masks
+        class ListSitesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request object for `CreateSite` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource where this `Site` will be created.
+        #     Format: `networks/{network_code}`
+        # @!attribute [rw] site
+        #   @return [::Google::Ads::AdManager::V1::Site]
+        #     Required. The `Site` to create.
+        class CreateSiteRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request object for `BatchCreateSites` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource where `Sites` will be created.
+        #     Format: `networks/{network_code}`
+        #     The parent field in the CreateSiteRequest must match this
+        #     field.
+        # @!attribute [rw] requests
+        #   @return [::Array<::Google::Ads::AdManager::V1::CreateSiteRequest>]
+        #     Required. The `Site` objects to create.
+        #     A maximum of 100 objects can be created in a batch.
+        class BatchCreateSitesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response object for `BatchCreateSites` method.
+        # @!attribute [rw] sites
+        #   @return [::Array<::Google::Ads::AdManager::V1::Site>]
+        #     The `Site` objects created.
+        class BatchCreateSitesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request object for `UpdateSite` method.
+        # @!attribute [rw] site
+        #   @return [::Google::Ads::AdManager::V1::Site]
+        #     Required. The `Site` to update.
+        #
+        #     The `Site`'s `name` is used to identify the `Site` to update.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Required. The list of fields to update.
+        class UpdateSiteRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request object for `BatchUpdateSites` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource where `Sites` will be updated.
+        #     Format: `networks/{network_code}`
+        #     The parent field in the UpdateSiteRequest must match this
+        #     field.
+        # @!attribute [rw] requests
+        #   @return [::Array<::Google::Ads::AdManager::V1::UpdateSiteRequest>]
+        #     Required. The `Site` objects to update.
+        #     A maximum of 100 objects can be updated in a batch.
+        class BatchUpdateSitesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response object for `BatchUpdateSites` method.
+        # @!attribute [rw] sites
+        #   @return [::Array<::Google::Ads::AdManager::V1::Site>]
+        #     The `Site` objects updated.
+        class BatchUpdateSitesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for `BatchDeactivateSites` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Format: `networks/{network_code}`
+        # @!attribute [rw] names
+        #   @return [::Array<::String>]
+        #     Required. The resource names of the `Site` objects to deactivate.
+        class BatchDeactivateSitesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response object for `BatchDeactivateSites` method.
+        class BatchDeactivateSitesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for `BatchSubmitSitesForApproval` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Format: `networks/{network_code}`
+        # @!attribute [rw] names
+        #   @return [::Array<::String>]
+        #     Required. The resource names of the `Site` objects to submit for approval.
+        class BatchSubmitSitesForApprovalRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response object for `BatchSubmitSitesForApproval` method.
+        class BatchSubmitSitesForApprovalResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end