@google-ads/admanager 0.10.0 → 0.11.0

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

@@ -0,0 +1,336 @@
+// 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/native_style_messages.proto";
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/field_mask.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 = "NativeStyleServiceProto";
+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 `NativeStyle` objects.
+service NativeStyleService {
+  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";
+
+  // Retrieves a `NativeStyle` object.
+  rpc GetNativeStyle(GetNativeStyleRequest) returns (NativeStyle) {
+    option (google.api.http) = {
+      get: "/v1/{name=networks/*/nativeStyles/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Lists `NativeStyle` objects.
+  rpc ListNativeStyles(ListNativeStylesRequest)
+      returns (ListNativeStylesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=networks/*}/nativeStyles"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Creates `NativeStyle` objects.
+  rpc BatchCreateNativeStyles(BatchCreateNativeStylesRequest)
+      returns (BatchCreateNativeStylesResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/nativeStyles:batchCreate"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,requests";
+  }
+
+  // Batch updates `NativeStyle` objects.
+  rpc BatchUpdateNativeStyles(BatchUpdateNativeStylesRequest)
+      returns (BatchUpdateNativeStylesResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/nativeStyles:batchUpdate"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,requests";
+  }
+
+  // Beginning of non-CRUD
+  // Activates a list of `NativeStyle` objects.
+  rpc BatchActivateNativeStyles(BatchActivateNativeStylesRequest)
+      returns (BatchActivateNativeStylesResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/nativeStyles:batchActivate"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,names";
+  }
+
+  // Deactivates a list of `NativeStyle` objects.
+  rpc BatchDeactivateNativeStyles(BatchDeactivateNativeStylesRequest)
+      returns (BatchDeactivateNativeStylesResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/nativeStyles:batchDeactivate"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,names";
+  }
+
+  // Archives a list of `NativeStyle` objects.
+  rpc BatchArchiveNativeStyles(BatchArchiveNativeStylesRequest)
+      returns (BatchArchiveNativeStylesResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/nativeStyles:batchArchive"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,names";
+  }
+}
+
+// Request object for `GetNativeStyle` method.
+message GetNativeStyleRequest {
+  // Required. The resource name of the NativeStyle.
+  // Format: `networks/{network_code}/nativeStyles/{native_style_id}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/NativeStyle"
+    }
+  ];
+}
+
+// Request object for `ListNativeStyles` method.
+message ListNativeStylesRequest {
+  // Required. The parent, which owns this collection of NativeStyles.
+  // 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 `NativeStyles` to return. The service may
+  // return fewer than this value. If unspecified, at most 50 `NativeStyles`
+  // 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 `ListNativeStyles` call.
+  // Provide this to retrieve the subsequent page.
+  //
+  // When paginating, all other parameters provided to `ListNativeStyles` 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
+  //
+  // **Filterable fields:**
+  //
+  // * `creativeTemplate`
+  // * `displayName`
+  // * `name`
+  // * `size.canonicalName`
+  // * `status`
+  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 `ListNativeStylesRequest` containing matching
+// `NativeStyle` objects.
+message ListNativeStylesResponse {
+  // The `NativeStyle` objects from the specified network.
+  repeated NativeStyle native_styles = 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 `NativeStyle` 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;
+}
+
+// Request object for `CreateNativeStyle` method.
+message CreateNativeStyleRequest {
+  // Required. The parent resource where this `NativeStyle` will be created.
+  // Format: `networks/{network_code}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Required. The `NativeStyle` to create.
+  NativeStyle native_style = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request object for `BatchCreateNativeStyles` method.
+message BatchCreateNativeStylesRequest {
+  // Required. The parent resource where `NativeStyles` will be created.
+  // Format: `networks/{network_code}`
+  // The parent field in the CreateNativeStyleRequest must match this
+  // field.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Required. The `NativeStyle` objects to create.
+  // A maximum of 100 objects can be created in a batch.
+  repeated CreateNativeStyleRequest requests = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response object for `BatchCreateNativeStyles` method.
+message BatchCreateNativeStylesResponse {
+  // The `NativeStyle` objects created.
+  repeated NativeStyle native_styles = 1;
+}
+
+// Request object for `UpdateNativeStyle` method.
+message UpdateNativeStyleRequest {
+  // Required. The `NativeStyle` to update.
+  //
+  // The `NativeStyle`'s `name` is used to identify the `NativeStyle` to update.
+  NativeStyle native_style = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The list of fields to update.
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Request object for `BatchUpdateNativeStyles` method.
+message BatchUpdateNativeStylesRequest {
+  // Required. The parent resource where `NativeStyles` will be updated.
+  // Format: `networks/{network_code}`
+  // The parent field in the UpdateNativeStyleRequest must match this
+  // field.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Required. The `NativeStyle` objects to update.
+  // A maximum of 100 objects can be updated in a batch.
+  repeated UpdateNativeStyleRequest requests = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response object for `BatchUpdateNativeStyles` method.
+message BatchUpdateNativeStylesResponse {
+  // The `NativeStyle` objects updated.
+  repeated NativeStyle native_styles = 1;
+}
+
+// Request object for `BatchActivateNativeStyles` method.
+message BatchActivateNativeStylesRequest {
+  // Required. Format: `networks/{network_code}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Required. Resource names for the `NativeStyle`s.
+  // Format: `networks/{network_code}/nativeStyles/{native_style_id}`
+  repeated string names = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/NativeStyle"
+    }
+  ];
+}
+
+// Response object for `BatchActivateNativeStyles` method.
+message BatchActivateNativeStylesResponse {}
+
+// Request object for `BatchDeactivateNativeStyles` method.
+message BatchDeactivateNativeStylesRequest {
+  // Required. Format: `networks/{network_code}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Required. Resource names for the `NativeStyle`s.
+  // Format: `networks/{network_code}/nativeStyles/{native_style_id}`
+  repeated string names = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/NativeStyle"
+    }
+  ];
+}
+
+// Response object for `BatchDeactivateNativeStyles` method.
+message BatchDeactivateNativeStylesResponse {}
+
+// Request object for `BatchArchiveNativeStyles` method.
+message BatchArchiveNativeStylesRequest {
+  // Required. Format: `networks/{network_code}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Required. Resource names for the `NativeStyle`s.
+  // Format: `networks/{network_code}/nativeStyles/{native_style_id}`
+  repeated string names = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/NativeStyle"
+    }
+  ];
+}
+
+// Response object for `BatchArchiveNativeStyles` method.
+message BatchArchiveNativeStylesResponse {}

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

@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.ads.admanager.v1;
 
+import "google/ads/admanager/v1/third_party_data_declaration.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 
@@ -77,3 +78,23 @@ message Network {
   // Output only. Network ID.
   optional int64 network_id = 11 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
+
+// The `DefaultThirdPartyDataDeclaration` singleton resource.
+message DefaultThirdPartyDataDeclaration {
+  option (google.api.resource) = {
+    type: "admanager.googleapis.com/DefaultThirdPartyDataDeclaration"
+    pattern: "networks/{network_code}/defaultThirdPartyDataDeclaration"
+    plural: "defaultThirdPartyDataDeclarations"
+    singular: "defaultThirdPartyDataDeclaration"
+  };
+
+  // Identifier. The resource name of the `DefaultThirdPartyDataDeclaration`.
+  // Format: `networks/{network_code}/defaultThirdPartyDataDeclaration`
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Optional. Returns the default [ThirdPartyDataDeclaration] for this network.
+  // If this setting has never been updated on your network, then this API
+  // response will be unset.
+  optional ThirdPartyDataDeclaration third_party_data_declaration = 2
+      [(google.api.field_behavior) = OPTIONAL];
+}

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

@@ -21,6 +21,7 @@ import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
+import "google/protobuf/field_mask.proto";
 
 option csharp_namespace = "Google.Ads.AdManager.V1";
 option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
@@ -51,6 +52,59 @@ service NetworkService {
       get: "/v1/networks"
     };
   }
+
+  // Updates a `Network` object. Currently, only the network display name can be
+  // updated.
+  rpc UpdateNetwork(UpdateNetworkRequest) returns (Network) {
+    option (google.api.http) = {
+      patch: "/v1/{network.name=networks/*}"
+      body: "network"
+    };
+    option (google.api.method_signature) = "network,update_mask";
+  }
+
+  // Provisions a test network associated with the current user. Only one test
+  // network can be provisioned per user.
+  //
+  // Before the test network can be used, you must complete setup in the Ad
+  // Manager UI. If the test network's owner is a service account, you must add
+  // a non-service account user by calling UserService.CreateUser.
+  //
+  // Test networks are limited in the following ways:
+  //
+  //   * Test networks have a maximum of 10,000 objects per entity type.
+  //   * Test networks cannot serve ads.
+  //   * Reports on serving data have zero rows.
+  //   * Forecast service results contain mock data.
+  //   * Test networks do not have Ad Manager 360 or premium features enabled.
+  rpc ProvisionTestNetwork(ProvisionTestNetworkRequest) returns (Network) {
+    option (google.api.http) = {
+      post: "/v1/networks:provisionTestNetwork"
+      body: "*"
+    };
+  }
+
+  // Returns the [DefaultThirdPartyDataDeclaration] for this network.
+  rpc GetDefaultThirdPartyDataDeclaration(
+      GetDefaultThirdPartyDataDeclarationRequest)
+      returns (DefaultThirdPartyDataDeclaration) {
+    option (google.api.http) = {
+      get: "/v1/{name=networks/*/defaultThirdPartyDataDeclaration}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+}
+
+// Request for the `UpdateNetwork` method.
+message UpdateNetworkRequest {
+  // Required. The `Network` to update.
+  //
+  // The `Network`'s `name` is used to identify the `Network` to update.
+  Network network = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The list of fields to update.
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request to get Network
@@ -104,3 +158,18 @@ message ListNetworksResponse {
   // https://developers.google.com/ad-manager/api/beta/field-masks
   int32 total_size = 3;
 }
+
+// Request for the `ProvisionTestNetwork` method.
+message ProvisionTestNetworkRequest {}
+
+// Request for the `GetDefaultThirdPartyDataDeclaration` method.
+message GetDefaultThirdPartyDataDeclarationRequest {
+  // Required. Resource name of DefaultThirdPartyDataDeclaration.
+  // Format: networks/{network_code}/defaultThirdPartyDataDeclaration
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/DefaultThirdPartyDataDeclaration"
+    }
+  ];
+}

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

@@ -164,7 +164,7 @@ message ReportDefinition {
       // report is run.
       LAST_6_MONTHS = 19;
 
-      // The entire previous 6 calendar months preceding the calendar month the
+      // The entire previous 12 calendar months preceding the calendar month the
       // report is run.
       LAST_12_MONTHS = 20;
 
@@ -3037,7 +3037,8 @@ message ReportDefinition {
     // Corresponds to "Demand subchannel value" in the Ad Manager UI (when
     // showing API fields).
     //
-    // Compatible with the following report types: `HISTORICAL`
+    // Compatible with the following report types: `HISTORICAL`,
+    // `ON_PLATFORM_MULTICALL`
     //
     // Data format: `ENUM`
     DEMAND_SUBCHANNEL = 22;
@@ -3048,7 +3049,8 @@ message ReportDefinition {
     //
     // Corresponds to "Demand subchannel" in the Ad Manager UI.
     //
-    // Compatible with the following report types: `HISTORICAL`
+    // Compatible with the following report types: `HISTORICAL`,
+    // `ON_PLATFORM_MULTICALL`
     //
     // Data format: `STRING`
     DEMAND_SUBCHANNEL_NAME = 23;
@@ -3428,6 +3430,17 @@ message ReportDefinition {
     // Data format: `STRING`
     HEADER_BIDDER_INTEGRATION_TYPE_NAME = 719;
 
+    // High engagement ads allowed.
+    //
+    //
+    //
+    // Corresponds to "High engagement ads allowed" in the Ad Manager UI.
+    //
+    // Compatible with the following report types: `HISTORICAL`
+    //
+    // Data format: `BOOLEAN`
+    HIGH_ENGAGEMENT_ADS_ALLOWED = 838;
+
     // Breaks down reporting data by hour in one day.
     //
     //
@@ -6655,6 +6668,29 @@ message ReportDefinition {
     // Data format: `STRING`
     VIDEO_STITCHER_TYPE_NAME = 753;
 
+    // Web interstitial trigger type.
+    //
+    //
+    //
+    // Corresponds to "Web interstitial trigger type value" in the Ad Manager UI
+    // (when showing API fields).
+    //
+    // Compatible with the following report types: `HISTORICAL`
+    //
+    // Data format: `ENUM`
+    WEB_INTERSTITIAL_TRIGGER_TYPE = 826;
+
+    // Localized name of the web interstitial trigger type.
+    //
+    //
+    //
+    // Corresponds to "Web interstitial trigger type" in the Ad Manager UI.
+    //
+    // Compatible with the following report types: `HISTORICAL`
+    //
+    // Data format: `STRING`
+    WEB_INTERSTITIAL_TRIGGER_TYPE_NAME = 827;
+
     // Web property code
     //
     //