@google-ads/admanager 0.5.0 → 0.6.0

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

@@ -0,0 +1,86 @@
+// 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 = "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,94 @@
+// 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/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];
+
+  // Required. Immutable. The ID of the Order to which the LineItem belongs.
+  // Format: `networks/{network_code}/orders/{order}`
+  optional string order = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.field_behavior) = IMMUTABLE,
+    (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,140 @@
+// 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/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,"
+      "https://www.googleapis.com/auth/admanager.readonly";
+
+  // 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
+  //
+  // <b>Filterable fields:</b>
+  // <ul style="list-style-type:none">
+  //   <li><code>displayName</code></li>
+  //   <li><code>endTime</code></li>
+  //   <li><code>goal.units</code></li>
+  //   <li><code>lineItemType</code></li>
+  //   <li><code>name</code></li>
+  //   <li><code>order</code></li>
+  //   <li><code>startTime</code></li>
+  // </ul>
+  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/{company_type_enum.proto → linked_device_enums.proto}

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// 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.
@@ -19,33 +19,24 @@ 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 = "CompanyTypeEnumProto";
+option java_outer_classname = "LinkedDeviceEnumsProto";
 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
-// [CompanyType][google.ads.admanager.v1.CompanyTypeEnum.CompanyType]
-message CompanyTypeEnum {
-  // The type of a company.
-  enum CompanyType {
-    // No value specified
-    COMPANY_TYPE_UNSPECIFIED = 0;
-
-    // A business entity that purchases ad inventory.
-    ADVERTISER = 1;
-
-    // A company representing the publisher's own advertiser for house ads.
-    HOUSE_ADVERTISER = 2;
-
-    // An organization that manages ad accounts and offers services, such as ad
-    // creation, placement, and management to advertisers.
-    AGENCY = 3;
-
-    // A company representing the publisher's own agency.
-    HOUSE_AGENCY = 4;
-
-    // A company representing multiple advertisers and agencies.
-    AD_NETWORK = 5;
+// [LinkedDeviceVisibility][google.ads.admanager.v1.LinkedDeviceVisibilityEnum.LinkedDeviceVisibility]
+message LinkedDeviceVisibilityEnum {
+  // Represents the visibility of a LinkedDevice.
+  enum LinkedDeviceVisibility {
+    // Default value. This value is unused.
+    LINKED_DEVICE_VISIBILITY_UNSPECIFIED = 0;
+
+    // The linked device can only be used by the user who owns the device
+    // linking.
+    PRIVATE = 2;
+
+    // The linked device can be used by anyone on the network.
+    PUBLIC = 3;
   }
 }

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

@@ -0,0 +1,58 @@
+// 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/linked_device_enums.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 = "LinkedDeviceMessagesProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// A test mobile device that is linked to the network. Can be used to preview a
+// creative within a mobile application.
+message LinkedDevice {
+  option (google.api.resource) = {
+    type: "admanager.googleapis.com/LinkedDevice"
+    pattern: "networks/{network_code}/linkedDevices/{linked_device}"
+    plural: "linkedDevices"
+    singular: "linkedDevice"
+  };
+
+  // Identifier. The resource name of the `LinkedDevice`.
+  // Format: `networks/{network_code}/linkedDevices/{linked_device_id}`
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Required. The display name of the LinkedDevice.
+  optional string display_name = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Output only. The user who owns this device linking.
+  // Format: `networks/{network_code}/users/{user}`
+  optional string owner = 7 [
+    (google.api.field_behavior) = OUTPUT_ONLY,
+    (google.api.resource_reference) = { type: "admanager.googleapis.com/User" }
+  ];
+
+  // Optional. The visibility of the device.
+  optional LinkedDeviceVisibilityEnum.LinkedDeviceVisibility visibility = 9
+      [(google.api.field_behavior) = OPTIONAL];
+}

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

@@ -0,0 +1,138 @@
+// 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/linked_device_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 = "LinkedDeviceServiceProto";
+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 `LinkedDevice` objects.
+service LinkedDeviceService {
+  option (google.api.default_host) = "admanager.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/admanager,"
+      "https://www.googleapis.com/auth/admanager.readonly";
+
+  // Gets a `LinkedDevice`.
+  rpc GetLinkedDevice(GetLinkedDeviceRequest) returns (LinkedDevice) {
+    option (google.api.http) = {
+      get: "/v1/{name=networks/*/linkedDevices/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Lists `LinkedDevice` objects.
+  rpc ListLinkedDevices(ListLinkedDevicesRequest)
+      returns (ListLinkedDevicesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=networks/*}/linkedDevices"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+}
+
+// Request object for `GetLinkedDevice` method.
+message GetLinkedDeviceRequest {
+  // Required. The resource name of the LinkedDevice.
+  // Format: `networks/{network_code}/linkedDevices/{linked_device_id}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/LinkedDevice"
+    }
+  ];
+}
+
+// Request object for `ListLinkedDevices` method.
+message ListLinkedDevicesRequest {
+  // Required. The parent, which owns this collection of LinkedDevices.
+  // 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 `LinkedDevices` to return. The service may
+  // return fewer than this value. If unspecified, at most 50 `LinkedDevices`
+  // 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 `ListLinkedDevices` call.
+  // Provide this to retrieve the subsequent page.
+  //
+  // When paginating, all other parameters provided to `ListLinkedDevices` 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
+  //
+  // <b>Filterable fields:</b>
+  // <ul style="list-style-type:none">
+  //   <li><code>displayName</code></li>
+  //   <li><code>name</code></li>
+  //   <li><code>owner</code></li>
+  //   <li><code>visibility</code></li>
+  // </ul>
+  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 `ListLinkedDevicesRequest` containing matching
+// `LinkedDevice` objects.
+message ListLinkedDevicesResponse {
+  // The `LinkedDevice` objects from the specified network.
+  repeated LinkedDevice linked_devices = 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 `LinkedDevice` 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/live_stream_event_messages.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.