@google-ads/admanager 0.3.0 → 0.4.0

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

@@ -0,0 +1,49 @@
+// Copyright 2025 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 = "RequestPlatformEnumProto";
+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 [RequestPlatform].
+//
+// Describes the platform from which a request is made and on which the ad is
+// rendered. In the event of multiple platforms, the platform that ultimately
+// renders the ad is the targeted platform. For example, a video player on a
+// website would have a request platform of `VIDEO_PLAYER`.
+message RequestPlatformEnum {
+  // The different environments in which an ad can be shown.
+  enum RequestPlatform {
+    // No value specified
+    REQUEST_PLATFORM_UNSPECIFIED = 0;
+
+    // Represents a request made from a web browser (incl. desktop browsers,
+    // mobile browsers, webviews, etc.).
+    BROWSER = 1;
+
+    // Represents a request made from a Mobile Application.
+    MOBILE_APP = 2;
+
+    // Represents a request made from a video player.
+    VIDEO_PLAYER = 3;
+  }
+}

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

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

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 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,18 +42,18 @@ message Role {
   string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
   // Output only. `Role` ID.
-  int64 role_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+  optional int64 role_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Required. The display name of the `Role`.
-  string display_name = 3 [(google.api.field_behavior) = REQUIRED];
+  optional string display_name = 3 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. The description of the `Role`.
-  string description = 4 [(google.api.field_behavior) = OPTIONAL];
+  optional string description = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. Whether the `Role` is a built-in or custom user role.
-  bool built_in = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+  optional bool built_in = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The status of the `Role`.
-  RoleStatusEnum.RoleStatus status = 6
+  optional RoleStatusEnum.RoleStatus status = 6
       [(google.api.field_behavior) = OUTPUT_ONLY];
 }

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

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -33,6 +33,8 @@ option ruby_package = "Google::Ads::AdManager::V1";
 // Provides methods for handling `Role` objects.
 service RoleService {
   option (google.api.default_host) = "admanager.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/admanager";
 
   // API to retrieve a `Role` object.
   rpc GetRole(GetRoleRequest) returns (Role) {

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

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -29,19 +29,15 @@ option ruby_package = "Google::Ads::AdManager::V1";
 
 // Represents the dimensions of an AdUnit, LineItem, or Creative.
 message Size {
-  // Required. The width of the [Creative](google.ads.admanager.v1.Creative),
-  // [AdUnit](google.ads.admanager.v1.AdUnit), or
-  // [LineItem](google.ads.admanager.v1.LineItem).
+  // Required. The width of the Creative,
+  // [AdUnit][google.ads.admanager.v1.AdUnit], or LineItem.
   int32 width = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. The height of the [Creative](google.ads.admanager.v1.Creative),
-  // [AdUnit](google.ads.admanager.v1.AdUnit), or
-  // [LineItem](google.ads.admanager.v1.LineItem).
+  // Required. The height of the Creative,
+  // [AdUnit][google.ads.admanager.v1.AdUnit], or LineItem.
   int32 height = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. The SizeType of the
-  // [Creative](google.ads.admanager.v1.Creative),
-  // [AdUnit](google.ads.admanager.v1.AdUnit), or
-  // [LineItem](google.ads.admanager.v1.LineItem).
+  // Required. The SizeType of the Creative,
+  // [AdUnit][google.ads.admanager.v1.AdUnit], or LineItem.
   SizeTypeEnum.SizeType size_type = 3 [(google.api.field_behavior) = REQUIRED];
 }

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

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

@@ -0,0 +1,44 @@
+// Copyright 2025 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 = "TargetedVideoBumperTypeEnumProto";
+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
+// [TargetedVideoBumperType][google.ads.admanager.v1.TargetedVideoBumperTypeEnum.TargetedVideoBumperType]
+message TargetedVideoBumperTypeEnum {
+  // Represents the options for targetable bumper positions, surrounding an ad
+  // pod, within a video stream. This includes before and after the supported ad
+  // pod positions, `VideoPositionType.PREROLL`, `VideoPositionType.MIDROLL`,
+  // and `VideoPositionType.POSTROLL`.
+  enum TargetedVideoBumperType {
+    // Default value. This value is unused.
+    TARGETED_VIDEO_BUMPER_TYPE_UNSPECIFIED = 0;
+
+    // Represents the bumper position after the ad pod.
+    AFTER = 1;
+
+    // Represents the bumper position before the ad pod.
+    BEFORE = 2;
+  }
+}

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

@@ -0,0 +1,328 @@
+// Copyright 2025 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/request_platform_enum.proto";
+import "google/ads/admanager/v1/targeted_video_bumper_type_enum.proto";
+import "google/ads/admanager/v1/video_position_enum.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 = "TargetingProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// Targeting expression.
+//
+message Targeting {
+  // Optional. Used to target/exclude various geo targets.
+  GeoTargeting geo_targeting = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Used to target various technology targeting dimensions.
+  TechnologyTargeting technology_targeting = 3
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Used to target/exclude various ad units and/or placements.
+  InventoryTargeting inventory_targeting = 5
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Used to target specific request platforms.
+  RequestPlatformTargeting request_platform_targeting = 6
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Used to target key/values, audience segments, and/or CMS
+  // metadata.
+  CustomTargeting custom_targeting = 7 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Used to target user domains.
+  UserDomainTargeting user_domain_targeting = 10
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Used to target video positions.
+  VideoPositionTargeting video_position_targeting = 12
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Used to target data segments.
+  DataSegmentTargeting data_segment_targeting = 13
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Represents a list of targeted and excluded geos.
+message GeoTargeting {
+  // Optional. A list of geo resource names that should be targeted/included.
+  repeated string targeted_geos = 3 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/GeoTarget"
+    }
+  ];
+
+  // Optional. A list of geo resource names that should be excluded.
+  repeated string excluded_geos = 4 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/GeoTarget"
+    }
+  ];
+}
+
+// Various types of technology targeting expressed by child messages are
+// applied with logical AND.
+message TechnologyTargeting {
+  // Optional. Bandwidth targeting dimension.
+  BandwidthTargeting bandwidth_targeting = 3
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Device category targeting dimension.
+  DeviceCategoryTargeting device_category_targeting = 1
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Operating system targeting dimension.
+  OperatingSystemTargeting operating_system_targeting = 2
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Bandwidth Targeting.
+//
+// Reach users accessing the internet via various means of connection, such as
+// cable, DSL, or dial-up. Can be useful to target campaigns using
+// low-resolution creatives or text ads for users with low bandwidth.
+message BandwidthTargeting {
+  // Optional. A list of resource names of the bandwidth groups that should be
+  // targeted/included.
+  repeated string targeted_bandwidth_groups = 3 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/BandwidthGroup"
+    }
+  ];
+
+  // Optional. A list of resource names of the bandwidth groups that should be
+  // excluded.
+  repeated string excluded_bandwidth_groups = 4 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/BandwidthGroup"
+    }
+  ];
+}
+
+// Represents a list of targeted and excluded device categories.
+message DeviceCategoryTargeting {
+  // Optional. A list of device category resource names that should be
+  // targeted/included.
+  repeated string targeted_categories = 3 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/DeviceCategory"
+    }
+  ];
+
+  // Optional. A list of device category resource names that should be excluded.
+  repeated string excluded_categories = 4 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/DeviceCategory"
+    }
+  ];
+}
+
+// Operating System Targeting
+message OperatingSystemTargeting {
+  // Optional. A list of operating system resource names that should be
+  // targeted/included.
+  repeated string targeted_operating_systems = 5 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/OperatingSystem"
+    }
+  ];
+
+  // Optional. A list of operating system resource names that should be
+  // excluded.
+  repeated string excluded_operating_systems = 6 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/OperatingSystem"
+    }
+  ];
+
+  // Optional. A list of operating system version resource names that should be
+  // targeted/included.
+  repeated string targeted_operating_system_versions = 7 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/OperatingSystemVersion"
+    }
+  ];
+
+  // Optional. A list of operating system version resource names that should be
+  // excluded.
+  repeated string excluded_operating_system_versions = 8 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/OperatingSystemVersion"
+    }
+  ];
+}
+
+// Targeted ad units and AU placements are applied with
+// logical OR. Example:
+//
+//  (au:1 OR au:2 OR au_placement:5) AND (NOT (au:3))
+message InventoryTargeting {
+  // Optional. A list of ad units that should be targeted/included.
+  repeated AdUnitTargeting targeted_ad_units = 1
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A list of ad units that should be excluded.
+  //
+  // Excluded AUs take precedence over targeted AUs. In fact an AU can be
+  // excluded only if one of its ancestors is targeted. Subsequently child
+  // AUs of an excluded AU can not be targeted (except via a placement).
+  repeated AdUnitTargeting excluded_ad_units = 2
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The resource names of the placements that should be
+  // targeted/included.
+  repeated string targeted_placements = 5 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Placement"
+    }
+  ];
+}
+
+// Specifies an ad unit and (optionally) its descendants.
+message AdUnitTargeting {
+  // Whether this ad unit's children should be targeted/excluded as well.
+  optional bool include_descendants = 1;
+
+  // Optional. The resource name of this ad unit.
+  optional string ad_unit = 3 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/AdUnit"
+    }
+  ];
+}
+
+// Represents a list of targeted request platforms.
+message RequestPlatformTargeting {
+  // Optional. The list of request platforms that should be targeted.
+  repeated RequestPlatformEnum.RequestPlatform request_platforms = 1
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Represents the top level targeting expression for custom key/values,
+// audience segments, and/or CMS metadata.
+message CustomTargeting {
+  // Optional. These clauses are all ORed together.
+  repeated CustomTargetingClause custom_targeting_clauses = 1
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Represents a logical AND of individual custom targeting expressions.
+message CustomTargetingClause {
+  // Optional. Leaf targeting expressions for custom key/values.
+  repeated CustomTargetingLiteral custom_targeting_literals = 1
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Represents targeting for custom key/values. The values are ORed together.
+message CustomTargetingLiteral {
+  // Whether this expression is negatively targeted, meaning it matches
+  // ad requests that exclude the below values.
+  optional bool negative = 1;
+
+  // Optional. The resource name of the targeted CustomKey.
+  optional string custom_targeting_key = 4 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/CustomTargetingKey"
+    }
+  ];
+
+  // Optional. The resource names of the targeted CustomValues.
+  repeated string custom_targeting_values = 5 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/CustomTargetingValue"
+    }
+  ];
+}
+
+// User Domain Targeting
+message UserDomainTargeting {
+  // Optional. A list of user domains that should be targeted/included.
+  repeated string targeted_user_domains = 1
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A list of user domains that should be excluded.
+  repeated string excluded_user_domains = 2
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Video Position Targeting
+message VideoPositionTargeting {
+  // Optional. A list of video position targeting criterion (applied with a
+  // logical AND).
+  repeated VideoPosition video_positions = 1
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Video Position Targeting Criterion
+message VideoPosition {
+  // Optional. The index of the mid-roll to target. This field is ignored when
+  // targeting any video position (e.g. position_type) other than MIDROLL.
+  optional int64 midroll_index = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The index from the back of the pod of the mid-roll to target.
+  // This field is ignored when targeting any video position (e.g.
+  // position_type) other than MIDROLL or if targeting a specific midroll index
+  // (e.g. midroll_index != 0).
+  optional int64 reverse_midroll_index = 2
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The video position within a pod to target. This field must be
+  // unset in order to target a specific video position (e.g. position_type),
+  // bumper type (e.g. bumper_type), or custom ad spot (e.g. custom_spot_id).
+  optional int64 pod_position = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The position within a video to target. A video ad can target a
+  // position (pre-roll, all mid-rolls, or post-roll) or a specific mid-roll
+  // index.
+  optional VideoPositionEnum.VideoPosition position_type = 5
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The video bumper type to target. This field must be unset in
+  // order to target a specific video position (e.g. position_type), pod
+  // position (e.g. pod_position), or custom ad spot (e.g. custom_spot_id).
+  optional TargetedVideoBumperTypeEnum.TargetedVideoBumperType bumper_type = 6
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Data Segment Targeting
+message DataSegmentTargeting {
+  // Output only. Whether any data segments are currently targeted.
+  bool has_data_segment_targeting = 2
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}

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

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 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,22 +42,23 @@ message TaxonomyCategory {
   string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
   // Output only. `TaxonomyCategory` ID.
-  int64 taxonomy_category_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+  optional int64 taxonomy_category_id = 2
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Display name of the `TaxonomyCategory`.
-  string display_name = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+  optional string display_name = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Whether this `TaxonomyCategory` only serves to group its
   // children.
-  bool grouping_only = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+  optional bool grouping_only = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The ID of the parent category this `TaxonomyCategory` descends
   // from.
-  int64 parent_taxonomy_category_id = 6
+  optional int64 parent_taxonomy_category_id = 6
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The taxonomy that this `TaxonomyCategory` belongs to.
-  TaxonomyTypeEnum.TaxonomyType taxonomy_type = 9
+  optional TaxonomyTypeEnum.TaxonomyType taxonomy_type = 9
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The list of names of the ancestors of this `TaxonomyCategory`.

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

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -33,6 +33,8 @@ option ruby_package = "Google::Ads::AdManager::V1";
 // Provides methods for handling `TaxonomyCategory` objects.
 service TaxonomyCategoryService {
   option (google.api.default_host) = "admanager.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/admanager";
 
   // API to retrieve a `TaxonomyCategory` object.
   rpc GetTaxonomyCategory(GetTaxonomyCategoryRequest)

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

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

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -39,8 +39,4 @@ message Team {
   // Identifier. The resource name of the `Team`.
   // Format: `networks/{network_code}/teams/{team_id}`
   string name = 1 [(google.api.field_behavior) = IDENTIFIER];
-
-  // Output only. The unique ID of the Team. This value is assigned by Google.
-  // Teams that are created by Google will have negative IDs.
-  int64 team_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 }

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

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

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -41,38 +41,39 @@ message User {
   string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
   // Output only. `User` ID.
-  int64 user_id = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
+  optional int64 user_id = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Required. The name of the User. It has a maximum length of 128 characters.
-  string display_name = 2 [(google.api.field_behavior) = REQUIRED];
+  optional string display_name = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The email or login of the User. In order to create a new user,
   // you must already have a Google Account.
-  string email = 3 [(google.api.field_behavior) = REQUIRED];
+  optional string email = 3 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The unique Role ID of the User. Roles that are created by Google
   // will have negative IDs.
-  string role = 4 [
+  optional string role = 4 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = { type: "admanager.googleapis.com/Role" }
   ];
 
   // Output only. Specifies whether or not the User is active. An inactive user
   // cannot log in to the system or perform any operations.
-  bool active = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
+  optional bool active = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Optional. An identifier for the User that is meaningful to the publisher.
   // This attribute has a maximum length of 255 characters.
-  string external_id = 7 [(google.api.field_behavior) = OPTIONAL];
+  optional string external_id = 7 [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. Whether the user is an OAuth2 service account user.
   // Service account users can only be added through the UI.
-  bool service_account = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
+  optional bool service_account = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Optional. The IANA Time Zone Database time zone, e.g. "America/New_York",
   // used in the orders and line items UI for this User. If not provided, the UI
   // then defaults to using the Network's timezone. This setting only affects
   // the UI for this user and does not affect the timezone of any dates and
   // times returned in API responses.
-  string orders_ui_local_time_zone = 9 [(google.api.field_behavior) = OPTIONAL];
+  optional string orders_ui_local_time_zone = 9
+      [(google.api.field_behavior) = OPTIONAL];
 }

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

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -33,6 +33,8 @@ option ruby_package = "Google::Ads::AdManager::V1";
 // Provides methods for handling User objects.
 service UserService {
   option (google.api.default_host) = "admanager.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/admanager";
 
   // API to retrieve a User object.
   //