@google-ads/admanager 0.4.1 → 0.5.1

package/build/protos/google/ads/admanager/v1/entity_signals_mapping_service.proto

@@ -195,7 +195,7 @@ message ListEntitySignalsMappingsResponse {
   // 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`.

package/build/protos/google/ads/admanager/v1/exchange_syndication_product_enum.proto

@@ -0,0 +1,47 @@
+// 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
+//
+//     http://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.
+
+syntax = "proto3";
+
+package google.ads.admanager.v1;
+
+option csharp_namespace = "Google.Ads.AdManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
+option java_multiple_files = true;
+option java_outer_classname = "ExchangeSyndicationProductEnumProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// Wrapper message for
+// [ExchangeSyndicationProduct][google.ads.admanager.v1.ExchangeSyndicationProductEnum.ExchangeSyndicationProduct]
+message ExchangeSyndicationProductEnum {
+  // Ad Exchange syndication product.
+  enum ExchangeSyndicationProduct {
+    // No value specified
+    EXCHANGE_SYNDICATION_PRODUCT_UNSPECIFIED = 0;
+
+    // Property serves in-browser.
+    DISPLAY = 1;
+
+    // Property serves on mobile applications (includes JS and SDK).
+    MOBILE_APP = 2;
+
+    // Property serves video (includes audio).
+    VIDEO_AND_AUDIO = 3;
+
+    // Property serves for games.
+    GAMES = 4;
+  }
+}

package/build/protos/google/ads/admanager/v1/geo_target_service.proto

@@ -78,8 +78,8 @@ message ListGeoTargetsRequest {
 
   // Optional. The maximum number of `GeoTargets` to return. The service may
   // return fewer than this value. If unspecified, at most 50 `GeoTargets` 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.
   int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. A page token, received from a previous `ListGeoTargets` call.
@@ -117,7 +117,7 @@ message ListGeoTargetsResponse {
   // 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`.

package/build/protos/google/ads/admanager/v1/goal.proto

@@ -0,0 +1,57 @@
+// 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
+//
+//     http://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.
+
+syntax = "proto3";
+
+package google.ads.admanager.v1;
+
+import "google/ads/admanager/v1/goal_enums.proto";
+
+option csharp_namespace = "Google.Ads.AdManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
+option java_multiple_files = true;
+option java_outer_classname = "GoalProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// Defines the criteria a [LineItem][google.ads.admanager.v1.LineItem] needs to
+// satisfy to meet its delivery goal.
+message Goal {
+  // The type of the goal for the LineItem. It defines the period over which the
+  // goal should be reached.
+  optional GoalTypeEnum.GoalType goal_type = 1;
+
+  // The type of the goal unit for the LineItem.
+  optional UnitTypeEnum.UnitType unit_type = 2;
+
+  // If this is a primary goal, it represents the number or percentage of
+  // impressions or clicks that will be reserved. If the line item is of type
+  // [LineItemTypeEnum.LineItemType.SPONSORSHIP][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.SPONSORSHIP],
+  // it represents the percentage of available impressions reserved. If the line
+  // item is of type
+  // [LineItemTypeEnum.LineItemType.BULK][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.BULK]
+  // or
+  // [LineItemTypeEnum.LineItemType.PRICE_PRIORITY][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.PRICE_PRIORITY],
+  // it represents the number of remaining impressions reserved. If the line
+  // item is of type
+  // [LineItemTypeEnum.LineItemType.NETWORK][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.NETWORK]
+  // or
+  // [LineItemTypeEnum.LineItemType.HOUSE][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.HOUSE],
+  // it represents the percentage of remaining impressions reserved. <p>If this
+  // is an impression cap goal, it represents the number of impressions or
+  // conversions that the line item will stop serving at if reached. For valid
+  // line item types, see [LineItem.impressions_cap][].
+  optional int64 units = 3;
+}

package/build/protos/google/ads/admanager/v1/goal_enums.proto

@@ -0,0 +1,129 @@
+// 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
+//
+//     http://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.
+
+syntax = "proto3";
+
+package google.ads.admanager.v1;
+
+option csharp_namespace = "Google.Ads.AdManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
+option java_multiple_files = true;
+option java_outer_classname = "GoalEnumsProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// Wrapper message for
+// [GoalType][google.ads.admanager.v1.GoalTypeEnum.GoalType].
+message GoalTypeEnum {
+  // Specifies the type of the goal for a LineItem.
+  enum GoalType {
+    // Default value. This value is unused.
+    GOAL_TYPE_UNSPECIFIED = 0;
+
+    // No goal is specified for the number of ads delivered.
+    // The line item [type][google.ads.admanager.v1.LineItem.line_item_type]
+    // must be one of:
+    //
+    // * [LineItemTypeEnum.LineItemType.PRICE_PRIORITY][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.PRICE_PRIORITY]
+    // * [LineItemTypeEnum.LineItemType.AD_EXCHANGE][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.AD_EXCHANGE]
+    // * [LineItemTypeEnum.LineItemType.CLICK_TRACKING][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.CLICK_TRACKING]
+    NONE = 1;
+
+    // There is a goal on the number of ads delivered for this line item during
+    // its entire lifetime.
+    // The line item [type][google.ads.admanager.v1.LineItem.line_item_type]
+    // must be one of:
+    //
+    // * [LineItemTypeEnum.LineItemType.STANDARD][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.STANDARD]
+    // * [LineItemTypeEnum.LineItemType.BULK][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.BULK]
+    // * [LineItemTypeEnum.LineItemType.PRICE_PRIORITY][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.PRICE_PRIORITY]
+    // * [LineItemTypeEnum.LineItemType.ADSENSE][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.ADSENSE]
+    // * [LineItemTypeEnum.LineItemType.AD_EXCHANGE][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.AD_EXCHANGE]
+    // * [LineItemTypeEnum.LineItemType.ADMOB][]
+    // * [LineItemTypeEnum.LineItemType.CLICK_TRACKING][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.CLICK_TRACKING]
+    LIFETIME = 2;
+
+    // There is a daily goal on the number of ads delivered for this line item.
+    // The line item [type][google.ads.admanager.v1.LineItem.line_item_type]
+    // must be one of:
+    //
+    // * [LineItemTypeEnum.LineItemType.SPONSORSHIP][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.SPONSORSHIP]
+    // * [LineItemTypeEnum.LineItemType.NETWORK][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.NETWORK]
+    // * [LineItemTypeEnum.LineItemType.PRICE_PRIORITY][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.PRICE_PRIORITY]
+    // * [LineItemTypeEnum.LineItemType.HOUSE][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.HOUSE]
+    // * [LineItemTypeEnum.LineItemType.ADSENSE][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.ADSENSE]
+    // * [LineItemTypeEnum.LineItemType.AD_EXCHANGE][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.AD_EXCHANGE]
+    // * [LineItemTypeEnum.LineItemType.ADMOB][]
+    // * [LineItemTypeEnum.LineItemType.BUMPER][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.BUMPER]
+    DAILY = 3;
+  }
+}
+
+// Wrapper message for
+// [UnitType][google.ads.admanager.v1.UnitTypeEnum.UnitType].
+message UnitTypeEnum {
+  // Indicates the type of unit used for defining a reservation. The
+  // [LineItem.cost_type][] can differ from the UnitType - an
+  // ad can have an impression goal, but be billed by its click. Usually
+  // CostType and UnitType will refer to the same unit.
+  enum UnitType {
+    // Default value. This value is unused.
+    UNIT_TYPE_UNSPECIFIED = 0;
+
+    // The number of impressions served by creatives associated with the line
+    // item.
+    IMPRESSIONS = 1;
+
+    // The number of clicks reported by creatives associated with the line item.
+    // The line item [type][google.ads.admanager.v1.LineItem.line_item_type]
+    // must be one of:
+    //
+    // * [LineItemTypeEnum.LineItemType.STANDARD][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.STANDARD]
+    // * [LineItemTypeEnum.LineItemType.BULK][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.BULK]
+    // * [LineItemTypeEnum.LineItemType.PRICE_PRIORITY][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.PRICE_PRIORITY]
+    CLICKS = 2;
+
+    // The number of click-through Cost-Per-Action (CPA) conversions from
+    // creatives associated with the line item. This is only supported as
+    // secondary goal and the [LineItem.cost_type][] must be
+    // [CostTypeEnum.CostType.CPA][].
+    CLICK_THROUGH_CPA_CONVERSIONS = 3;
+
+    // The number of view-through Cost-Per-Action (CPA) conversions from
+    // creatives associated with the line item. This is only supported as
+    // secondary goal and the [LineItem.cost_type][] must be
+    // [CostTypeEnum.CostType.CPA}.
+    VIEW_THROUGH_CPA_CONVERSIONS = 4;
+
+    // The number of total Cost-Per-Action (CPA) conversions from creatives
+    // associated with the line item. This is only supported as secondary goal
+    // and the [LineItem.cost_type} must be [CostTypeEnum.CostType.CPA}.
+    TOTAL_CPA_CONVERSIONS = 5;
+
+    // The number of viewable impressions reported by creatives associated with
+    // the line item. The
+    // [LineItem.line_item_type][google.ads.admanager.v1.LineItem.line_item_type]
+    // must be
+    // [LineItemTypeEnum.LineItemType.STANDARD][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.STANDARD].
+    VIEWABLE_IMPRESSIONS = 6;
+
+    // The number of in-target impressions reported by third party measurements.
+    // The
+    // [LineItem.line_item_type][google.ads.admanager.v1.LineItem.line_item_type]
+    // must be
+    // [LineItemTypeEnum.LineItemType.STANDARD][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.STANDARD].
+    IN_TARGET_IMPRESSIONS = 7;
+  }
+}

package/build/protos/google/ads/admanager/v1/line_item_enums.proto

@@ -0,0 +1,86 @@
+// 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
+//
+//     http://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.
+
+syntax = "proto3";
+
+package google.ads.admanager.v1;
+
+option csharp_namespace = "Google.Ads.AdManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
+option java_multiple_files = true;
+option java_outer_classname = "LineItemEnumsProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// Wrapper message for
+// [LineItemType][google.ads.admanager.v1.LineItemTypeEnum.LineItemType].
+message LineItemTypeEnum {
+  // Indicates the priority of a LineItem, determined by the way in which
+  // impressions are reserved to be served for it.
+  enum LineItemType {
+    // Not specified value.
+    LINE_ITEM_TYPE_UNSPECIFIED = 0;
+
+    // The type of LineItem for which a percentage of all the impressions that
+    // are being sold are reserved.
+    SPONSORSHIP = 12;
+
+    // The type of LineItem for which a fixed quantity of impressions or
+    // clicks are reserved.
+    STANDARD = 13;
+
+    // The type of LineItem most commonly used to fill a site's unsold
+    // inventory if not contractually obligated to deliver a requested number
+    // of impressions. Uses daily percentage of unsold impressions or clicks.
+    NETWORK = 9;
+
+    // The type of LineItem for which a fixed quantity of impressions or
+    // clicks will be delivered at a priority lower than the STANDARD type.
+    BULK = 4;
+
+    // The type of LineItem most commonly used to fill a site's unsold
+    // inventory if not contractually obligated to deliver a requested number
+    // of impressions. Uses fixed quantity percentage of unsold impressions or
+    // clicks.
+    PRICE_PRIORITY = 11;
+
+    // The type of LineItem typically used for ads that promote products and
+    // services chosen by the publisher.
+    HOUSE = 7;
+
+    // The type of LineItem used for ads that track ads being served
+    // externally of Ad Manager.
+    CLICK_TRACKING = 6;
+
+    // Targets the LineItem to specific inventory available to AdSense buyers.
+    ADSENSE = 2;
+
+    // Targets the LineItem to specific inventory available to Authorized Buyers
+    // and the Open Auction.
+    AD_EXCHANGE = 3;
+
+    // Represents a non-monetizable video LineItem that targets one or more
+    // bumper positions, which are short house video messages used by
+    // publishers to separate content from ad breaks.
+    BUMPER = 5;
+
+    // The type of LineItem for which there are no impressions reserved, and
+    // will serve for a second price bid.
+    PREFERRED_DEAL = 10;
+
+    // The type of LineItem used for configuring audience extension campaigns.
+    AUDIENCE_EXTENSION = 14;
+  }
+}

package/build/protos/google/ads/admanager/v1/line_item_messages.proto

@@ -0,0 +1,93 @@
+// 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
+//
+//     http://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.
+
+syntax = "proto3";
+
+package google.ads.admanager.v1;
+
+import "google/ads/admanager/v1/custom_field_value.proto";
+import "google/ads/admanager/v1/goal.proto";
+import "google/ads/admanager/v1/line_item_enums.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/timestamp.proto";
+import "google/type/money.proto";
+
+option csharp_namespace = "Google.Ads.AdManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
+option java_multiple_files = true;
+option java_outer_classname = "LineItemMessagesProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// A LineItem contains information about how specific ad creatives are intended
+// to serve to your website or app along with pricing and other delivery
+// details.
+message LineItem {
+  option (google.api.resource) = {
+    type: "admanager.googleapis.com/LineItem"
+    pattern: "networks/{network_code}/lineItems/{line_item}"
+    plural: "lineItems"
+    singular: "lineItem"
+  };
+
+  // Identifier. The resource name of the `LineItem`.
+  // Format: `networks/{network_code}/lineItems/{line_item_id}`
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Output only. The ID of the Order to which the LineItem belongs. This
+  // attribute is required. Format: `networks/{network_code}/orders/{order}`
+  optional string order = 2 [
+    (google.api.field_behavior) = OUTPUT_ONLY,
+    (google.api.resource_reference) = { type: "admanager.googleapis.com/Order" }
+  ];
+
+  // Required. The name of the line item. This attribute is required and has a
+  // maximum length of 255 characters.
+  optional string display_name = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The date and time on which the LineItem is enabled to begin
+  // serving. This attribute is required and must be in the future.
+  optional google.protobuf.Timestamp start_time = 6
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Output only. The timestamp when the LineItem will stop serving. This
+  // attribute is read-only and includes auto extension days.
+  optional google.protobuf.Timestamp end_time = 7
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Required. Indicates the line item type of a LineItem. This attribute is
+  // required. The line item type determines the default priority of the line
+  // item. More information can be found at
+  // https://support.google.com/admanager/answer/177279.
+  optional LineItemTypeEnum.LineItemType line_item_type = 17
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The amount of money to spend per impression or click.
+  optional google.type.Money rate = 20 [(google.api.field_behavior) = REQUIRED];
+
+  // Output only. The amount of money allocated to the LineItem. This attribute
+  // is readonly and is populated by Google. The currency code is readonly.
+  optional google.type.Money budget = 35
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Optional. The values of the custom fields associated with this line item.
+  repeated CustomFieldValue custom_field_values = 59
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The primary goal that this LineItem is associated with, which is
+  // used in its pacing and budgeting.
+  optional Goal goal = 76 [(google.api.field_behavior) = OPTIONAL];
+}

package/build/protos/google/ads/admanager/v1/line_item_service.proto

@@ -0,0 +1,128 @@
+// 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
+//
+//     http://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.
+
+syntax = "proto3";
+
+package google.ads.admanager.v1;
+
+import "google/ads/admanager/v1/line_item_messages.proto";
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+
+option csharp_namespace = "Google.Ads.AdManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
+option java_multiple_files = true;
+option java_outer_classname = "LineItemServiceProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// Provides methods for handling `LineItem` objects.
+service LineItemService {
+  option (google.api.default_host) = "admanager.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/admanager";
+
+  // API to retrieve a `LineItem` object.
+  rpc GetLineItem(GetLineItemRequest) returns (LineItem) {
+    option (google.api.http) = {
+      get: "/v1/{name=networks/*/lineItems/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // API to retrieve a list of `LineItem` objects.
+  rpc ListLineItems(ListLineItemsRequest) returns (ListLineItemsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=networks/*}/lineItems"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+}
+
+// Request object for `GetLineItem` method.
+message GetLineItemRequest {
+  // Required. The resource name of the LineItem.
+  // Format: `networks/{network_code}/lineItems/{line_item_id}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/LineItem"
+    }
+  ];
+}
+
+// Request object for `ListLineItems` method.
+message ListLineItemsRequest {
+  // Required. The parent, which owns this collection of LineItems.
+  // Format: `networks/{network_code}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Optional. The maximum number of `LineItems` to return. The service may
+  // return fewer than this value. If unspecified, at most 50 `LineItems` will
+  // be returned. The maximum value is 1000; values greater than 1000 will be
+  // coerced to 1000.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A page token, received from a previous `ListLineItems` call.
+  // Provide this to retrieve the subsequent page.
+  //
+  // When paginating, all other parameters provided to `ListLineItems` must
+  // match the call that provided the page token.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Expression to filter the response.
+  // See syntax details at
+  // https://developers.google.com/ad-manager/api/beta/filters
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Expression to specify sorting order.
+  // See syntax details at
+  // https://developers.google.com/ad-manager/api/beta/filters#order
+  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Number of individual resources to skip while paginating.
+  int32 skip = 6 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response object for `ListLineItemsRequest` containing matching `LineItem`
+// objects.
+message ListLineItemsResponse {
+  // The `LineItem` objects from the specified network.
+  repeated LineItem line_items = 1;
+
+  // A token, which can be sent as `page_token` to retrieve the next page.
+  // If this field is omitted, there are no subsequent pages.
+  string next_page_token = 2;
+
+  // Total number of `LineItem` 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
+  int32 total_size = 3;
+}

package/build/protos/google/ads/admanager/v1/mobile_carrier_messages.proto

@@ -0,0 +1,48 @@
+// 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
+//
+//     http://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.
+
+syntax = "proto3";
+
+package google.ads.admanager.v1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+
+option csharp_namespace = "Google.Ads.AdManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
+option java_multiple_files = true;
+option java_outer_classname = "MobileCarrierMessagesProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// Represents a mobile carrier.
+message MobileCarrier {
+  option (google.api.resource) = {
+    type: "admanager.googleapis.com/MobileCarrier"
+    pattern: "networks/{network_code}/mobileCarriers/{mobile_carrier}"
+    plural: "mobileCarriers"
+    singular: "mobileCarrier"
+  };
+
+  // Identifier. The resource name of the `MobileCarrier`.
+  // Format: `networks/{network_code}/mobileCarriers/{mobile_carrier}`
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Output only. The localized name of the mobile carrier.
+  optional string display_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The region code of the mobile carrier.
+  optional string region_code = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+}