@google-ads/admanager 0.5.0 → 0.6.0

package/build/protos/google/ads/admanager/v1/order_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.
@@ -44,8 +44,9 @@ message Order {
   // Format: `networks/{network_code}/orders/{order_id}`
   string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
-  // Output only. Order ID.
-  optional int64 order_id = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+  // Output only. Deprecated: Order ID.
+  optional int64 order_id = 4
+      [deprecated = true, (google.api.field_behavior) = OUTPUT_ONLY];
 
   // Required. The display name of the Order.  This value has a maximum length
   // of 255 characters.
@@ -61,10 +62,12 @@ message Order {
     (google.api.resource_reference) = { type: "admanager.googleapis.com/User" }
   ];
 
-  // Optional. The resource names of Contacts from the advertiser of this Order.
-  // Format: "networks/{network_code}/contacts/{contact_id}"
+  // Optional. Unordered list. The resource names of Contacts from the
+  // advertiser of this Order. Format:
+  // "networks/{network_code}/contacts/{contact_id}"
   repeated string advertiser_contacts = 5 [
     (google.api.field_behavior) = OPTIONAL,
+    (google.api.field_behavior) = UNORDERED_LIST,
     (google.api.resource_reference) = {
       type: "admanager.googleapis.com/Contact"
     }
@@ -149,8 +152,7 @@ message Order {
   // Output only. The archival status of the Order.
   optional bool archived = 14 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Output only. The application which modified this order. This attribute is
-  // assigned by Google.
+  // Output only. The application which modified this order.
   optional string last_modified_by_app = 15
       [(google.api.field_behavior) = OUTPUT_ONLY];
 

package/build/protos/google/ads/admanager/v1/order_service.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.
@@ -34,7 +34,8 @@ option ruby_package = "Google::Ads::AdManager::V1";
 service OrderService {
   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,"
+      "https://www.googleapis.com/auth/admanager.readonly";
 
   // API to retrieve an Order object.
   rpc GetOrder(GetOrderRequest) returns (Order) {
@@ -93,8 +94,31 @@ message ListOrdersRequest {
   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
+  //  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>advertiser</code></li>
+  //   <li><code>agency</code></li>
+  //   <li><code>appliedTeams</code></li>
+  //   <li><code>archived</code></li>
+  //   <li><code>creator</code></li>
+  //   <li><code>displayName</code></li>
+  //   <li><code>endTime</code></li>
+  //   <li><code>externalOrderId</code></li>
+  //   <li><code>name</code></li>
+  //   <li><code>orderId</code></li>
+  //   <li><code>poNumber</code></li>
+  //   <li><code>programmatic</code></li>
+  //   <li><code>salesperson</code></li>
+  //   <li><code>secondarySalespeople</code></li>
+  //   <li><code>secondaryTraffickers</code></li>
+  //   <li><code>startTime</code></li>
+  //   <li><code>status</code></li>
+  //   <li><code>trafficker</code></li>
+  //   <li><code>updateTime</code></li>
+  // </ul>
   string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Expression to specify sorting order.

package/build/protos/google/ads/admanager/v1/placement_enums.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.

package/build/protos/google/ads/admanager/v1/placement_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.
@@ -42,8 +42,9 @@ message Placement {
   // Format: `networks/{network_code}/placements/{placement_id}`
   string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
-  // Output only. `Placement` ID.
-  int64 placement_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+  // Output only. Deprecated: `Placement` ID.
+  int64 placement_id = 2
+      [deprecated = true, (google.api.field_behavior) = OUTPUT_ONLY];
 
   // Required. The display name of the placement. This attribute has a maximum
   // length of 255 characters.

package/build/protos/google/ads/admanager/v1/placement_service.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.
@@ -35,7 +35,8 @@ option ruby_package = "Google::Ads::AdManager::V1";
 service PlacementService {
   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,"
+      "https://www.googleapis.com/auth/admanager.readonly";
 
   // API to retrieve a `Placement` object.
   rpc GetPlacement(GetPlacementRequest) returns (Placement) {
@@ -159,8 +160,19 @@ message ListPlacementsRequest {
   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
+  //  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>description</code></li>
+  //   <li><code>displayName</code></li>
+  //   <li><code>name</code></li>
+  //   <li><code>placementCode</code></li>
+  //   <li><code>status</code></li>
+  //   <li><code>targetedAdUnits</code></li>
+  //   <li><code>updateTime</code></li>
+  // </ul>
   string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Expression to specify sorting order.
@@ -245,9 +257,9 @@ message UpdatePlacementRequest {
   // `networks/{network_code}/placements/{placement_id}`
   Placement placement = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. The list of fields to update.
+  // Optional. The list of fields to update.
   google.protobuf.FieldMask update_mask = 2
-      [(google.api.field_behavior) = REQUIRED];
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request object for `BatchUpdatePlacements` method.

package/build/protos/google/ads/admanager/v1/private_auction_deal_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.
@@ -53,9 +53,9 @@ message PrivateAuctionDeal {
   // `networks/{network_code}/privateAuctionDeals/{private_auction_deal_id}`
   string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
-  // Output only. `PrivateAuctionDeal` ID.
+  // Output only. Deprecated: `PrivateAuctionDeal` ID.
   optional int64 private_auction_deal_id = 2
-      [(google.api.field_behavior) = OUTPUT_ONLY];
+      [deprecated = true, (google.api.field_behavior) = OUTPUT_ONLY];
 
   // Immutable. The ID of the
   // [PrivateAuction](google.ads.admanager.v1.PrivateAuction).

package/build/protos/google/ads/admanager/v1/private_auction_deal_service.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.
@@ -35,7 +35,8 @@ option ruby_package = "Google::Ads::AdManager::V1";
 service PrivateAuctionDealService {
   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,"
+      "https://www.googleapis.com/auth/admanager.readonly";
 
   // API to retrieve a `PrivateAuctionDeal` object.
   rpc GetPrivateAuctionDeal(GetPrivateAuctionDealRequest)
@@ -116,8 +117,25 @@ message ListPrivateAuctionDealsRequest {
   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
+  //  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>auctionPriorityEnabled</code></li>
+  //   <li><code>blockOverrideEnabled</code></li>
+  //   <li><code>buyerAccountId</code></li>
+  //   <li><code>buyerPermissionType</code></li>
+  //   <li><code>endTime</code></li>
+  //   <li><code>externalDealId</code></li>
+  //   <li><code>floorPrice</code></li>
+  //   <li><code>name</code></li>
+  //   <li><code>privateAuctionDealId</code></li>
+  //   <li><code>privateAuctionDisplayName</code></li>
+  //   <li><code>privateAuctionId</code></li>
+  //   <li><code>status</code></li>
+  //   <li><code>updateTime</code></li>
+  // </ul>
   string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Expression to specify sorting order.
@@ -178,7 +196,7 @@ message UpdatePrivateAuctionDealRequest {
   PrivateAuctionDeal private_auction_deal = 1
       [(google.api.field_behavior) = REQUIRED];
 
-  // Required. The list of fields to update.
+  // Optional. The list of fields to update.
   google.protobuf.FieldMask update_mask = 2
-      [(google.api.field_behavior) = REQUIRED];
+      [(google.api.field_behavior) = OPTIONAL];
 }

package/build/protos/google/ads/admanager/v1/private_auction_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.
@@ -42,9 +42,9 @@ message PrivateAuction {
   // `networks/{network_code}/privateAuctions/{private_auction_id}`
   string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
-  // Output only. `PrivateAuction` ID.
+  // Output only. Deprecated: `PrivateAuction` ID.
   optional int64 private_auction_id = 2
-      [(google.api.field_behavior) = OUTPUT_ONLY];
+      [deprecated = true, (google.api.field_behavior) = OUTPUT_ONLY];
 
   // Required. Display name of the `PrivateAuction`. This attribute has a
   // maximum length of 255 bytes.

package/build/protos/google/ads/admanager/v1/private_auction_service.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.
@@ -35,7 +35,8 @@ option ruby_package = "Google::Ads::AdManager::V1";
 service PrivateAuctionService {
   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,"
+      "https://www.googleapis.com/auth/admanager.readonly";
 
   // API to retrieve a `PrivateAuction` object.
   rpc GetPrivateAuction(GetPrivateAuctionRequest) returns (PrivateAuction) {
@@ -174,7 +175,7 @@ message UpdatePrivateAuctionRequest {
   // `PrivateAuction` to update.
   PrivateAuction private_auction = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. The list of fields to update.
+  // Optional. The list of fields to update.
   google.protobuf.FieldMask update_mask = 2
-      [(google.api.field_behavior) = REQUIRED];
+      [(google.api.field_behavior) = OPTIONAL];
 }

package/build/protos/google/ads/admanager/v1/private_marketplace_enums.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.
@@ -46,5 +46,8 @@ message PrivateMarketplaceDealStatusEnum {
 
     // The deal is paused by the buyer.
     BUYER_PAUSED = 5;
+
+    // The deal is past its end date.
+    COMPLETED = 6;
   }
 }

package/build/protos/google/ads/admanager/v1/programmatic_buyer_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.

package/build/protos/google/ads/admanager/v1/programmatic_buyer_service.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.
@@ -34,7 +34,8 @@ option ruby_package = "Google::Ads::AdManager::V1";
 service ProgrammaticBuyerService {
   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,"
+      "https://www.googleapis.com/auth/admanager.readonly";
 
   // API to retrieve a `ProgrammaticBuyer` object.
   rpc GetProgrammaticBuyer(GetProgrammaticBuyerRequest)
@@ -93,8 +94,20 @@ message ListProgrammaticBuyersRequest {
   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
+  //  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>agency</code></li>
+  //   <li><code>buyerAccountId</code></li>
+  //   <li><code>displayName</code></li>
+  //   <li><code>name</code></li>
+  //   <li><code>parentAccountId</code></li>
+  //   <li><code>partnerClientId</code></li>
+  //   <li><code>preferredDealsEnabled</code></li>
+  //   <li><code>programmaticGuaranteedEnabled</code></li>
+  // </ul>
   string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Expression to specify sorting order.