@google-ads/admanager 0.10.0 → 0.11.0

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

@@ -17,6 +17,7 @@ syntax = "proto3";
 package google.ads.admanager.v1;
 
 import "google/ads/admanager/v1/child_publisher_messages.proto";
+import "google/ads/admanager/v1/mcm_enums.proto";
 import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";
@@ -97,6 +98,78 @@ service ChildPublisherService {
     };
     option (google.api.method_signature) = "parent,requests";
   }
+
+  // Batch resends invitation emails to
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s.
+  //
+  // Only expired and pending
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s can be sent
+  // invitation emails. Rejected, withdrawn, and accepted
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s will be ignored.
+  rpc BatchResendChildPublisherInvitationEmails(
+      BatchResendChildPublisherInvitationEmailsRequest)
+      returns (BatchResendChildPublisherInvitationEmailsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/childPublishers:batchResendInvitationEmails"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,names";
+  }
+
+  // Batch renegotiates [ChildPublisher][google.ads.admanager.v1.ChildPublisher]
+  // agreements (i.e., invite with updated terms).
+  //
+  // Only the agreements of rejected or withdrawn
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s can be
+  // renegotiated. Expired, pending, and accepted
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s will be ignored.
+  rpc BatchRenegotiateChildPublisherAgreements(
+      BatchRenegotiateChildPublisherAgreementsRequest)
+      returns (BatchRenegotiateChildPublisherAgreementsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/childPublishers:batchRenegotiateAgreements"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,requests";
+  }
+
+  // Batch rejects [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s.
+  //
+  // Only pending or active
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s can be rejected.
+  // Expired, rejected, and withdrawn
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s will be ignored.
+  //
+  // This method is only intended to be called in response to a child user
+  // rejecting an invitation and exists to support the rejection of
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s that are not yet
+  // associated with an Ad Manager network.
+  //
+  // To sever the relationship from the parent publisher's side, use
+  // [BatchWithdrawChildPublisher][].
+  rpc BatchRejectChildPublishers(BatchRejectChildPublishersRequest)
+      returns (BatchRejectChildPublishersResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/childPublishers:batchReject"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,names";
+  }
+
+  // Batch withdraws [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s.
+  //
+  // Only expired, pending, and accepted
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s can be withdrawn.
+  // Rejected or withdrawn
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s will be ignored.
+  rpc BatchWithdrawChildPublishers(BatchWithdrawChildPublishersRequest)
+      returns (BatchWithdrawChildPublishersResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/childPublishers:batchWithdraw"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,names";
+  }
 }
 
 // Request object for [GetChildPublisher][] method.
@@ -281,3 +354,162 @@ message BatchUpdateChildPublishersResponse {
   // updated.
   repeated ChildPublisher child_publishers = 1;
 }
+
+// Request message to renegotiate a
+// [ChildPublisher][google.ads.admanager.v1.ChildPublisher]'s agreement (i.e.,
+// invite with updated terms).
+message RenegotiateChildPublisherAgreementRequest {
+  // Required. Resource name of the
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher] whose agreement is
+  // being renegotiated. Format:
+  // `networks/{network_code}/childPublisher/{child_publisher_id}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/ChildPublisher"
+    }
+  ];
+
+  // Optional. The display name to set for the
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher] whose agreement is
+  // being renegotiated.
+  string display_name = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The email address to set for the
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher] whose agreement is
+  // being renegotiated.
+  string email_address = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The resource name of the Ad Manager network to set for the
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher] whose agreement is
+  // being renegotiated.
+  //
+  // This field may not update the
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher]'s Ad Manager
+  // network if it is already associated with one.
+  //
+  // Format: `networks/{network_code}`
+  string network = 4 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Optional. The type of delegation to set for the
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher] whose agreement is
+  // being renegotiated.
+  DelegationTypeEnum.DelegationType delegation_type = 5
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The revenue share to set that the parent publisher will receive
+  // in millipercent (e.g., 15000 millipercent is %15) for the
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher] whose agreement is
+  // being renegotiated.
+  //
+  // This field is only settable for Manage Account
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s of non-reseller
+  // parent publishers. Otherwise, it is ignored and always 100%.
+  int64 parent_revenue_share_millipercent = 6
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The seller ID to set for the
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher] whose agreement is
+  // being renegotiated.
+  //
+  // This field is only applicable to Manage Inventory
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s.
+  string seller_id = 7 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Request message for [BatchRenegotiateChildPublisherAgreements][] method.
+message BatchRenegotiateChildPublisherAgreementsRequest {
+  // Required. Format: `networks/{network_code}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Required. The requests to renegotiate
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher] agreements.
+  repeated RenegotiateChildPublisherAgreementRequest requests = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response message for [BatchRenegotiateChildPublisherAgreements][] method.
+message BatchRenegotiateChildPublisherAgreementsResponse {}
+
+// Request message for [BatchResendChildPublisherInvitationEmails][] method.
+message BatchResendChildPublisherInvitationEmailsRequest {
+  // 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 of the
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s that should be
+  // resent invitation emails. Format:
+  // `networks/{network_code}/childPublisher/{child_publisher_id}`
+  repeated string names = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/ChildPublisher"
+    }
+  ];
+}
+
+// Response message for [BatchResendChildPublisherInvitationEmails][] method.
+message BatchResendChildPublisherInvitationEmailsResponse {}
+
+// Request message for [BatchWithdrawChildPublishers][] method.
+message BatchWithdrawChildPublishersRequest {
+  // 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 of the
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s to withdraw.
+  // Format: `networks/{network_code}/childPublisher/{child_publisher_id}`
+  repeated string names = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/ChildPublisher"
+    }
+  ];
+}
+
+// Response message for [BatchWithdrawChildPublishers][] method.
+message BatchWithdrawChildPublishersResponse {}
+
+// Request message for [BatchRejectChildPublishers][] method.
+message BatchRejectChildPublishersRequest {
+  // 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 of the
+  // [ChildPublisher][google.ads.admanager.v1.ChildPublisher]s to reject.
+  // Format: `networks/{network_code}/childPublisher/{child_publisher_id}`
+  repeated string names = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/ChildPublisher"
+    }
+  ];
+}
+
+// Response message for [BatchRejectChildPublishers][] method.
+message BatchRejectChildPublishersResponse {}

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

@@ -0,0 +1,46 @@
+// 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 = "NativeStyleEnumsProto";
+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
+// [NativeStyleStatus][google.ads.admanager.v1.NativeStyleStatusEnum.NativeStyleStatus]
+message NativeStyleStatusEnum {
+  // Describes status of the native style.
+  enum NativeStyleStatus {
+    // Default value. This value is unused.
+    NATIVE_STYLE_STATUS_UNSPECIFIED = 0;
+
+    // The native style is active. Active native styles are used in ad serving.
+    ACTIVE = 1;
+
+    // The native style is archived. Archived native styles are not visible in
+    // the UI and not used in ad serving.
+    ARCHIVED = 2;
+
+    // The native style is inactive. Inactive native styles are not used in ad
+    // serving, but visible in the UI.
+    INACTIVE = 3;
+  }
+}

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

@@ -0,0 +1,79 @@
+// 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_enums.proto";
+import "google/ads/admanager/v1/size.proto";
+import "google/ads/admanager/v1/targeting.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 = "NativeStyleMessagesProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// Used to define the look and feel of native ads, for both web and apps. Native
+// styles determine how native creatives look for a segment of inventory.
+message NativeStyle {
+  option (google.api.resource) = {
+    type: "admanager.googleapis.com/NativeStyle"
+    pattern: "networks/{network_code}/nativeStyles/{native_style}"
+    plural: "nativeStyles"
+    singular: "nativeStyle"
+  };
+
+  // Identifier. The resource name of the `NativeStyle`.
+  // Format: `networks/{network_code}/nativeStyles/{native_style_id}`
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Required. Immutable. The creative template this native style is associated
+  // with. Format:
+  // "networks/{network_code}/creativeTemplates/{creative_template}"
+  optional string creative_template = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.field_behavior) = IMMUTABLE,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/CreativeTemplate"
+    }
+  ];
+
+  // Required. The display name of the native style. This attribute has a
+  // maximum length of 255 characters.
+  optional string display_name = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The HTML snippet of the native style with placeholders for the
+  // associated variables.
+  optional string html_snippet = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The CSS snippet of the native style, with placeholders for the
+  // associated variables.
+  optional string css_snippet = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The targeting criteria for this native style.
+  Targeting targeting = 9 [(google.api.field_behavior) = OPTIONAL];
+
+  // Output only. The status of the native style.
+  optional NativeStyleStatusEnum.NativeStyleStatus status = 10
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Required. The size of the native style.
+  Size size = 12 [(google.api.field_behavior) = REQUIRED];
+}