@google-ads/admanager 0.7.0 → 0.9.0

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

@@ -0,0 +1,47 @@
+// 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
+//
+//     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 = "LineItemDeliveryForecastSourceEnumProto";
+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
+// [LineItemDeliveryForecastSource][google.ads.admanager.v1.LineItemDeliveryForecastSourceEnum.LineItemDeliveryForecastSource]
+message LineItemDeliveryForecastSourceEnum {
+  // Strategies for choosing forecasted traffic shapes to pace line items.
+  enum LineItemDeliveryForecastSource {
+    // Default value. This value is unused.
+    LINE_ITEM_DELIVERY_FORECAST_SOURCE_UNSPECIFIED = 0;
+
+    // A user specified custom pacing curve will be used to pace line item
+    // delivery.
+    CUSTOM_PACING_CURVE = 1;
+
+    // The line item's projected future traffic will be used to pace line item
+    // delivery.
+    FORECASTING = 2;
+
+    // The line item's historical traffic shape will be used to pace line item
+    // delivery.
+    HISTORICAL = 3;
+  }
+}

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

@@ -0,0 +1,42 @@
+// 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
+//
+//     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/discount_type_enum.proto";
+import "google/api/field_behavior.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 = "LineItemDiscountProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// Discount information for a LineItem.
+message LineItemDiscount {
+  // Optional. The type of discount being applied to a LineItem, either
+  // percentage based or absolute. This attribute is optional and defaults to
+  // PERCENTAGE.
+  optional DiscountTypeEnum.DiscountType discount_type = 1
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The number here is either a percentage or an absolute value
+  // depending on the DiscountType. If the DiscountType is PERCENTAGE, then only
+  // non-fractional values are supported.
+  optional double discount = 2 [(google.api.field_behavior) = OPTIONAL];
+}

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

@@ -24,6 +24,83 @@ 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
+// [LineItemCostType][google.ads.admanager.v1.LineItemCostTypeEnum.LineItemCostType].
+message LineItemCostTypeEnum {
+  // Describes the LineItem actions that are billable.
+  enum LineItemCostType {
+    // Not specified value.
+    LINE_ITEM_COST_TYPE_UNSPECIFIED = 0;
+
+    // Starting February 22, 2024 the CPA LineItemCostType will only be read as
+    // part of Spotlight deprecation, learn more at:
+    // https://support.google.com/admanager/answer/7519021#spotlight
+    //
+    // Cost per action. 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.STANDARD][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.STANDARD]
+    // * [LineItemTypeEnum.LineItemType.BULK][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.BULK]
+    // * [LineItemTypeEnum.LineItemType.NETWORK][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.NETWORK]
+    CPA = 1 [deprecated = true];
+
+    // Cost per click. 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.STANDARD][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.STANDARD]
+    // * [LineItemTypeEnum.LineItemType.BULK][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.BULK]
+    // * [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]
+    CPC = 2;
+
+    // Cost per day. 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]
+    CPD = 3;
+
+    // Cost per mille (thousand) impressions. 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.STANDARD][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.STANDARD]
+    // * [LineItemTypeEnum.LineItemType.BULK][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.BULK]
+    // * [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]
+    CPM = 4;
+
+    // Cost per mille (thousand) Active View viewable impressions. 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]
+    VCPM = 5;
+
+    // Cost per millie (thousand) in-target impressions. 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]
+    CPM_IN_TARGET = 6;
+
+    // Cost for the entire flight of the deal. The line item
+    // [type][google.ads.admanager.v1.LineItem.line_item_type] must be must be
+    // one of:
+    //
+    // * [LineItemTypeEnum.LineItemType.SPONSORSHIP][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.SPONSORSHIP]
+    CPF = 7;
+
+    // Cost per completed view. 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].
+    CPCV = 8;
+  }
+}
+
 // Wrapper message for
 // [LineItemType][google.ads.admanager.v1.LineItemTypeEnum.LineItemType].
 message LineItemTypeEnum {
@@ -84,3 +161,67 @@ message LineItemTypeEnum {
     AUDIENCE_EXTENSION = 14;
   }
 }
+
+// Wrapper message for
+// [LineItemReservationStatus][google.ads.admanager.v1.LineItemReservationStatusEnum.LineItemReservationStatus].
+message LineItemReservationStatusEnum {
+  // Defines the different reservation statuses of a line item.
+  enum LineItemReservationStatus {
+    // No value specified
+    LINE_ITEM_RESERVATION_STATUS_UNSPECIFIED = 0;
+
+    // Indicates that inventory has been reserved for the line item.
+    RESERVED = 1;
+
+    // Indicates that inventory has not been reserved for the line item.
+    UNRESERVED = 2;
+  }
+}
+
+// Wrapper message for
+// [LineItemComputedStatus][google.ads.admanager.v1.LineItemComputedStatusEnum.LineItemComputedStatus].
+message LineItemComputedStatusEnum {
+  // Describes the computed LineItem status that is derived from the current
+  // state of the LineItem.
+  enum LineItemComputedStatus {
+    // No value specified.
+    LINE_ITEM_COMPUTED_STATUS_UNSPECIFIED = 0;
+
+    // The LineItem has been canceled and is no longer eligible to serve. This
+    // is a legacy status.
+    CANCELED = 1;
+
+    // The LineItem has completed its run.
+    COMPLETED = 2;
+
+    // The LineItem has begun serving.
+    DELIVERING = 3;
+
+    // The LineItem has past its endDateTime with an auto extension, but hasn't
+    // met its goal.
+    DELIVERY_EXTENDED = 4;
+
+    // The LineItem has been disapproved and is not eligible to serve.
+    DISAPPROVED = 5;
+
+    // The LineItem is still being drafted.
+    DRAFT = 6;
+
+    // The LineItem is inactive. It is either caused by missing creatives or the
+    // network disabling auto-activation.
+    INACTIVE = 7;
+
+    // The LineItem has been paused from serving.
+    PAUSED = 8;
+
+    // The LineItem has been paused and its reserved inventory has been
+    // released. The LineItem will not serve.
+    PAUSED_INVENTORY_RELEASED = 9;
+
+    // The LineItem has been submitted for approval.
+    PENDING_APPROVAL = 10;
+
+    // The LineItem has been activated and is ready to serve.
+    READY = 11;
+  }
+}