google-ads-ad_manager-v1 2.2.0 → 2.3.0

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

@@ -0,0 +1,102 @@
+# 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 `GetMobileDeviceSubmodel` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the MobileDeviceSubmodel.
+        #     Format:
+        #     `networks/{network_code}/mobileDeviceSubmodels/{mobile_device_submodel_id}`
+        class GetMobileDeviceSubmodelRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request object for `ListMobileDeviceSubmodels` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent, which owns this collection of MobileDeviceSubmodels.
+        #     Format: `networks/{network_code}`
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The maximum number of `MobileDeviceSubmodels` to return. The
+        #     service may return fewer than this value. If unspecified, at most 50
+        #     `MobileDeviceSubmodels` will be returned. The maximum value is 1000; values
+        #     above 1000 will be coerced to 1000.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A page token, received from a previous
+        #     `ListMobileDeviceSubmodels` call. Provide this to retrieve the subsequent
+        #     page.
+        #
+        #     When paginating, all other parameters provided to
+        #     `ListMobileDeviceSubmodels` 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 ListMobileDeviceSubmodelsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response object for `ListMobileDeviceSubmodelsRequest` containing matching
+        # `MobileDeviceSubmodel` objects.
+        # @!attribute [rw] mobile_device_submodels
+        #   @return [::Array<::Google::Ads::AdManager::V1::MobileDeviceSubmodel>]
+        #     The `MobileDeviceSubmodel` 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 `MobileDeviceSubmodel` 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 ListMobileDeviceSubmodelsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

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

@@ -41,7 +41,7 @@ module Google
         #     Optional. The maximum number of `OperatingSystems` to return. The service
         #     may return fewer than this value. If unspecified, at most 50
         #     `OperatingSystems` will be returned. The maximum value is 1000; values
-        #     above 1000 will be coerced to 1000.
+        #     greater than 1000 will be coerced to 1000.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Optional. A page token, received from a previous `ListOperatingSystems`
@@ -82,7 +82,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/operating_system_version_service.rb

@@ -42,7 +42,7 @@ module Google
         #     Optional. The maximum number of `OperatingSystemVersions` to return. The
         #     service may return fewer than this value. If unspecified, at most 50
         #     `OperatingSystemVersions` will be returned. The maximum value is 1000;
-        #     values above 1000 will be coerced to 1000.
+        #     values greater than 1000 will be coerced to 1000.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Optional. A page token, received from a previous
@@ -85,7 +85,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/order_messages.rb

@@ -69,22 +69,21 @@ module Google
         # @!attribute [r] creator
         #   @return [::String]
         #     Output only. The resource name of the User who created the Order on behalf
-        #     of the advertiser. This value is assigned by Google. Format:
-        #     "networks/\\{network_code}/users/\\{user_id}"
+        #     of the advertiser. Format: "networks/\\{network_code}/users/\\{user_id}"
         # @!attribute [r] currency_code
         #   @return [::String]
         #     Output only. The ISO 4217 3-letter currency code for the currency used by
         #     the Order. This value is the network's currency code.
         # @!attribute [r] start_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     Output only. The instant at which the Order and its associated line items
-        #     are eligible to begin serving. This attribute is derived from the line item
-        #     of the order that has the earliest LineItem.start_time.
+        #     Output only. The instant at which the Order and its associated Line items
+        #     are eligible to begin serving. This attribute is derived from the Line item
+        #     of the order that has the earliest `LineItem.start_time`.
         # @!attribute [r] end_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     Output only. The instant at which the Order and its associated line items
-        #     stop being served. This attribute is derived from the line item of the
-        #     order that has the latest LineItem.end_time.
+        #     Output only. The instant at which the Order and its associated Line items
+        #     stop being served. This attribute is derived from the Line item of the
+        #     order that has the latest `LineItem.end_time`.
         # @!attribute [r] unlimited_end_time
         #   @return [::Boolean]
         #     Output only. Indicates whether or not this Order has an end time.

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

@@ -40,8 +40,8 @@ module Google
         #   @return [::Integer]
         #     Optional. The maximum number of `Orders` to return. The service may return
         #     fewer than this value. If unspecified, at most 50 `Orders` 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 `ListOrders` call.
@@ -82,7 +82,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/placement_service.rb

@@ -40,8 +40,8 @@ module Google
         #   @return [::Integer]
         #     Optional. The maximum number of `Placements` to return. The service may
         #     return fewer than this value. If unspecified, at most 50 `Placements` will
-        #     be returned. The maximum value is 1000; values above 1000 will be coerced
-        #     to 1000.
+        #     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 `ListPlacements` call.
@@ -82,7 +82,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`.
@@ -93,6 +93,142 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Request object for `CreatePlacement` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource where this `Placement` will be created.
+        #     Format: `networks/{network_code}`
+        # @!attribute [rw] placement
+        #   @return [::Google::Ads::AdManager::V1::Placement]
+        #     Required. The `Placement` to create.
+        class CreatePlacementRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request object for `BatchCreatePlacements` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource where the `Placement`s will be created.
+        #     Format: `networks/{network_code}`
+        #     The parent field in the CreatePlacementRequest messages match this
+        #     field.
+        # @!attribute [rw] requests
+        #   @return [::Array<::Google::Ads::AdManager::V1::CreatePlacementRequest>]
+        #     Required. The `Placement` objects to create.
+        #     A maximum of 100 objects can be created in a batch.
+        class BatchCreatePlacementsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response object for `BatchCreatePlacements` method.
+        # @!attribute [rw] placements
+        #   @return [::Array<::Google::Ads::AdManager::V1::Placement>]
+        #     The `Placement` objects created.
+        class BatchCreatePlacementsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request object for `UpdatePlacement` method.
+        # @!attribute [rw] placement
+        #   @return [::Google::Ads::AdManager::V1::Placement]
+        #     Required. The `Placement` to update.
+        #
+        #     The `Placement`'s name is used to identify the `Placement` to
+        #     update. Format:
+        #     `networks/{network_code}/placements/{placement_id}`
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Required. The list of fields to update.
+        class UpdatePlacementRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request object for `BatchUpdatePlacements` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource where `Placements` will be updated.
+        #     Format: `networks/{network_code}`
+        #     The parent field in the UpdatePlacementsRequest must match this
+        #     field.
+        # @!attribute [rw] requests
+        #   @return [::Array<::Google::Ads::AdManager::V1::UpdatePlacementRequest>]
+        #     Required. The `Placement` objects to update.
+        #     A maximum of 100 objects can be updated in a batch.
+        class BatchUpdatePlacementsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response object for `BatchUpdatePlacements` method.
+        # @!attribute [rw] placements
+        #   @return [::Array<::Google::Ads::AdManager::V1::Placement>]
+        #     The `Placement` objects updated.
+        class BatchUpdatePlacementsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for `BatchActivatePlacements` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Format: `networks/{network_code}`
+        # @!attribute [rw] names
+        #   @return [::Array<::String>]
+        #     Required. The names of the `Placement` objects to activate.
+        #     Format: `networks/{network_code}/placements/{placement_id}`
+        class BatchActivatePlacementsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response object for `BatchActivatePlacements` method.
+        class BatchActivatePlacementsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for `BatchDeactivatePlacements` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Format: `networks/{network_code}`
+        # @!attribute [rw] names
+        #   @return [::Array<::String>]
+        #     Required. The names of the `Placement` objects to deactivate.
+        #     Format: `networks/{network_code}/placements/{placement_id}`
+        class BatchDeactivatePlacementsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response object for `BatchDeactivatePlacements` method.
+        class BatchDeactivatePlacementsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for `BatchArchivePlacements` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Format: `networks/{network_code}`
+        # @!attribute [rw] names
+        #   @return [::Array<::String>]
+        #     Required. The names of the `Placement` objects to archive.
+        #     Format: `networks/{network_code}/placements/{placement_id}`
+        class BatchArchivePlacementsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response object for `BatchArchivePlacements` method.
+        class BatchArchivePlacementsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

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

@@ -43,7 +43,7 @@ module Google
         #     Optional. The maximum number of `PrivateAuctionDeals` to return. The
         #     service may return fewer than this value. If unspecified, at most 50
         #     `PrivateAuctionDeals` will be returned. The maximum value is 1000;
-        #     values above 1000 will be coerced to 1000.
+        #     values greater than 1000 will be coerced to 1000.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Optional. A page token, received from a previous `ListPrivateAuctionDeals`
@@ -85,7 +85,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/private_auction_service.rb

@@ -42,7 +42,7 @@ module Google
         #     Optional. The maximum number of `PrivateAuctions` to return. The service
         #     may return fewer than this value. If unspecified, at most 50
         #     `PrivateAuctions` will be returned. The maximum value is 1000;
-        #     values above 1000 will be coerced to 1000.
+        #     values greater than 1000 will be coerced to 1000.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Optional. A page token, received from a previous `ListPrivateAuctions`
@@ -84,7 +84,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/programmatic_buyer_service.rb

@@ -83,7 +83,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`.