@google-ads/admanager 0.4.0 → 0.5.0

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

@@ -0,0 +1,62 @@
+// 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/ad_review_center_ad_enums.proto";
+import "google/ads/admanager/v1/exchange_syndication_product_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 = "AdReviewCenterAdMessagesProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// Represents an ad that can be acted on or viewed in the Ad Review Center.
+// [AdReviewCenterAd][google.ads.admanager.v1.AdReviewCenterAd].
+message AdReviewCenterAd {
+  option (google.api.resource) = {
+    type: "admanager.googleapis.com/AdReviewCenterAd"
+    pattern: "networks/{network_code}/webProperties/{web_property_code}/adReviewCenterAds/{ad_review_center_ad}"
+    plural: "adReviewCenterAds"
+    singular: "adReviewCenterAd"
+  };
+
+  // Identifier. The resource name of the AdReviewCenterAd.
+  // Format:
+  // `networks/{network_code}/webProperties/{web_property_code}/adReviewCenterAds/{ad_review_center_ad_id}`
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Output only. `AdReviewCenterAd` ID.
+  string ad_review_center_ad_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Specifies the ExchangeSyndicationProduct for this
+  // AdReviewCenterAd.
+  ExchangeSyndicationProductEnum.ExchangeSyndicationProduct product_type = 3
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The status of the AdReviewCenterAd.
+  AdReviewCenterAdStatusEnum.AdReviewCenterAdStatus status = 4;
+
+  // Output only. The preview URL that can be embedded or accessed directly
+  // which will present the rendered contents of the ad. (This URL expires 72
+  // hours after being retrieved.).
+  optional string preview_url = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+}

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

@@ -0,0 +1,237 @@
+// 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/ad_review_center_ad_enums.proto";
+import "google/ads/admanager/v1/ad_review_center_ad_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/longrunning/operations.proto";
+import "google/rpc/status.proto";
+import "google/type/interval.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 = "AdReviewCenterAdServiceProto";
+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 AdReviewCenterAd objects.
+service AdReviewCenterAdService {
+  option (google.api.default_host) = "admanager.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/admanager";
+
+  // API to search for AdReviewCenterAds.
+  rpc SearchAdReviewCenterAds(SearchAdReviewCenterAdsRequest)
+      returns (SearchAdReviewCenterAdsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=networks/*/webProperties/*}/adReviewCenterAds:search"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // API to batch allow AdReviewCenterAds.
+  // This method supports partial success. Some operations may succeed while
+  // others fail. Callers should check the failedRequests field in the response
+  // to determine which operations failed.
+  rpc BatchAllowAdReviewCenterAds(BatchAllowAdReviewCenterAdsRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*/webProperties/*}/adReviewCenterAds:batchAllow"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent";
+    option (google.longrunning.operation_info) = {
+      response_type: "BatchAllowAdReviewCenterAdsResponse"
+      metadata_type: "BatchAdReviewCenterAdsOperationMetadata"
+    };
+  }
+
+  // API to batch block AdReviewCenterAds.
+  // This method supports partial success. Some operations may succeed while
+  // others fail. Callers should check the failedRequests field in the response
+  // to determine which operations failed.
+  rpc BatchBlockAdReviewCenterAds(BatchBlockAdReviewCenterAdsRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*/webProperties/*}/adReviewCenterAds:batchBlock"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent";
+    option (google.longrunning.operation_info) = {
+      response_type: "BatchBlockAdReviewCenterAdsResponse"
+      metadata_type: "BatchAdReviewCenterAdsOperationMetadata"
+    };
+  }
+}
+
+// Request object for `SearchAdReviewCenterAds` method.
+message SearchAdReviewCenterAdsRequest {
+  // Required. The parent, which owns this collection of AdReviewCenterAds.
+  // Format: networks/{network_code}/webProperties/{web_property_code}
+  //
+  // Since a network can only have a single web property of each
+  // `ExchangeSyndicationProduct`, you can use the
+  // `ExchangeSyndicationProduct` as an alias for the web property code:
+  //
+  // `networks/{network_code}/webProperties/display`
+  //
+  // `networks/{network_code}/webProperties/videoAndAudio`
+  //
+  // `networks/{network_code}/webProperties/mobileApp`
+  //
+  // `networks/{network_code}/webProperties/games`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/WebProperty"
+    }
+  ];
+
+  // Optional. The maximum number of AdReviewCenterAds to return. The service
+  // may return fewer than this value. If unspecified, at most 50
+  // AdReviewCenterAds 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. The page token to fetch the next page of AdReviewCenterAds. This
+  // is the value returned from a previous Search request, or empty.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Only return ads with the given status.
+  AdReviewCenterAdStatusEnum.AdReviewCenterAdStatus status = 4
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. If provided, only return ads with the given AdReviewCenterAd IDs.
+  repeated string ad_review_center_ad_id = 5
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If provided, only return ads that served within the given date
+  // range (inclusive). The  date range must be within the last 30 days. If not
+  // provided, the date range will be the last 30 days.
+  google.type.Interval date_time_range = 6
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If provided, restrict the search to AdReviewCenterAds associated
+  // with the text (including any text on the ad or in the destination URL). If
+  // more than one value is provided, the search will combine them in a logical
+  // AND. For example, ['car', 'blue'] will match ads that contain both "car"
+  // and "blue", but not an ad that only contains "car".
+  repeated string search_text = 7 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If provided, restrict the search to creatives belonging to one of
+  // the given Adx buyer account IDs. Only applicable to RTB creatives. Adx
+  // buyer account IDs can be found via the ProgrammaticBuyerService.
+  repeated int64 buyer_account_id = 8 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response object for `SearchAdReviewCenterAds` method.
+message SearchAdReviewCenterAdsResponse {
+  // The AdReviewCenterAds that match the search request.
+  repeated AdReviewCenterAd ad_review_center_ads = 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;
+}
+
+// Request object for `BatchAllowAdReviewCenterAds` method.
+message BatchAllowAdReviewCenterAdsRequest {
+  // Required. The parent, which owns this collection of AdReviewCenterAds.
+  // Format: networks/{network_code}/webProperties/{web_property_code}
+  //
+  // Since a network can only have a single web property of each
+  // `ExchangeSyndicationProduct`, you can use the
+  // `ExchangeSyndicationProduct` as an alias for the web property code:
+  //
+  // `networks/{network_code}/webProperties/display`
+  //
+  // `networks/{network_code}/webProperties/videoAndAudio`
+  //
+  // `networks/{network_code}/webProperties/mobileApp`
+  //
+  // `networks/{network_code}/webProperties/games`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/WebProperty"
+    }
+  ];
+
+  // Required. The resource names of the `AdReviewCenterAd`s to allow.
+  // Format:
+  // `networks/{network_code}/webProperties/{web_property_code}/adReviewCenterAds/{ad_review_center_ad_id}`
+  repeated string names = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/AdReviewCenterAd"
+    }
+  ];
+}
+
+// Response object for `BatchAllowAdReviewCenterAds` method.
+message BatchAllowAdReviewCenterAdsResponse {}
+
+// Request object for `BatchBlockAdReviewCenterAds` method.
+message BatchBlockAdReviewCenterAdsRequest {
+  // Required. The parent, which owns this collection of AdReviewCenterAds.
+  // Format: networks/{network_code}/webProperties/{web_property_code}
+  //
+  // Since a network can only have a single web property of each
+  // `ExchangeSyndicationProduct`, you can use the
+  // `ExchangeSyndicationProduct` as an alias for the web property code:
+  //
+  // `networks/{network_code}/webProperties/display`
+  //
+  // `networks/{network_code}/webProperties/videoAndAudio`
+  //
+  // `networks/{network_code}/webProperties/mobileApp`
+  //
+  // `networks/{network_code}/webProperties/games`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/WebProperty"
+    }
+  ];
+
+  // Required. The resource names of the `AdReviewCenterAd`s to block.
+  // Format:
+  // `networks/{network_code}/webProperties/{web_property_code}/adReviewCenterAds/{ad_review_center_ad_id}`
+  repeated string names = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/AdReviewCenterAd"
+    }
+  ];
+}
+
+// Response object for `BatchBlockAdReviewCenterAds` method.
+message BatchBlockAdReviewCenterAdsResponse {}
+
+// Metadata object for `BatchAllowAdReviewCenterAds` and
+// `BatchBlockAdReviewCenterAds` methods.
+message BatchAdReviewCenterAdsOperationMetadata {
+  // The status of each failed request, keyed by the index of the corresponding
+  // request in the batch request.
+  map<int32, google.rpc.Status> failed_requests = 1;
+}

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

@@ -191,10 +191,10 @@ message AdUnit {
 // Represents the size, environment, and companions of an ad in an ad unit.
 message AdUnitSize {
   // Required. The Size of the AdUnit.
-  Size size = 1 [(google.api.field_behavior) = REQUIRED];
+  optional Size size = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The EnvironmentType of the AdUnit
-  EnvironmentTypeEnum.EnvironmentType environment_type = 2
+  optional EnvironmentTypeEnum.EnvironmentType environment_type = 2
       [(google.api.field_behavior) = REQUIRED];
 
   // The companions for this ad unit size. Companions are only valid if the
@@ -207,7 +207,7 @@ message AdUnitSize {
 message AdUnitParent {
   // Output only. The parent of the current AdUnit
   // Format: `networks/{network_code}/adUnits/{ad_unit_id}`
-  string parent_ad_unit = 1 [
+  optional string parent_ad_unit = 1 [
     (google.api.field_behavior) = OUTPUT_ONLY,
     (google.api.resource_reference) = {
       type: "admanager.googleapis.com/AdUnit"
@@ -215,22 +215,22 @@ message AdUnitParent {
   ];
 
   // Output only. The display name of the parent AdUnit.
-  string display_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+  optional string display_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. A string used to uniquely identify the ad unit for the
   // purposes of serving the ad.
-  string ad_unit_code = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+  optional string ad_unit_code = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Frequency cap using a label.
 message LabelFrequencyCap {
   // Required. The label to used for frequency capping.
   // Format: "networks/{network_code}/labels/{label_id}"
-  string label = 1 [
+  optional string label = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = { type: "admanager.googleapis.com/Label" }
   ];
 
   // The frequency cap.
-  FrequencyCap frequency_cap = 2;
+  optional FrequencyCap frequency_cap = 2;
 }

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

@@ -87,8 +87,8 @@ message ListAdUnitsRequest {
 
   // Optional. The maximum number of AdUnits to return. The service may return
   // fewer than this value. If unspecified, at most 50 ad units will be
-  // returned. The maximum value is 1000; values above 1000 will be coerced to
-  // 1000.
+  // 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 `ListAdUnits` call.
@@ -125,7 +125,7 @@ message ListAdUnitsResponse {
   // If a filter was included in the request, this reflects the total number
   // after the filtering is applied.
   //
-  // `total_size` will not be calculated in the response unless it has been
+  // `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`.
@@ -148,8 +148,8 @@ message ListAdUnitSizesRequest {
 
   // Optional. The maximum number of AdUnitSizes to return. The service may
   // return fewer than this value. If unspecified, at most 50 ad unit sizes will
-  // be returned. The maximum value is 1000; values above 1000 will be coerced
-  // to 1000.
+  // 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 `ListAdUnitSizes` call.
@@ -186,7 +186,7 @@ message ListAdUnitSizesResponse {
   // If a filter was included in the request, this reflects the total number
   // after the filtering is applied.
   //
-  // `total_size` will not be calculated in the response unless it has been
+  // `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`.

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

@@ -0,0 +1,47 @@
+// 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/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 = "ApplicationMessagesProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// An application that has been added to or "claimed" by the network to be used
+// for targeting purposes. These mobile apps can come from various app stores.
+message Application {
+  option (google.api.resource) = {
+    type: "admanager.googleapis.com/Application"
+    pattern: "networks/{network_code}/applications/{application}"
+    plural: "applications"
+    singular: "application"
+  };
+
+  // Identifier. The resource name of the `Application`.
+  // Format: `networks/{network_code}/applications/{application_id}`
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Optional. The display name of the application. This attribute is required
+  // and has a maximum length of 80 characters.
+  optional string display_name = 4 [(google.api.field_behavior) = OPTIONAL];
+}

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

@@ -0,0 +1,129 @@
+// 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/application_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 = "ApplicationServiceProto";
+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 `Application` objects.
+service ApplicationService {
+  option (google.api.default_host) = "admanager.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/admanager";
+
+  // API to retrieve a `Application` object.
+  rpc GetApplication(GetApplicationRequest) returns (Application) {
+    option (google.api.http) = {
+      get: "/v1/{name=networks/*/applications/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // API to retrieve a list of `Application` objects.
+  rpc ListApplications(ListApplicationsRequest)
+      returns (ListApplicationsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=networks/*}/applications"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+}
+
+// Request object for `GetApplication` method.
+message GetApplicationRequest {
+  // Required. The resource name of the Application.
+  // Format: `networks/{network_code}/applications/{application_id}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Application"
+    }
+  ];
+}
+
+// Request object for `ListApplications` method.
+message ListApplicationsRequest {
+  // Required. The parent, which owns this collection of Applications.
+  // 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 `Applications` to return. The service may
+  // return fewer than this value. If unspecified, at most 50 `Applications`
+  // 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 `ListApplications` call.
+  // Provide this to retrieve the subsequent page.
+  //
+  // When paginating, all other parameters provided to `ListApplications` 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
+  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 `ListApplicationsRequest` containing matching
+// `Application` objects.
+message ListApplicationsResponse {
+  // The `Application` objects from the specified network.
+  repeated Application applications = 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 `Application` 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/audience_segment_messages.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;
+
+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 = "AudienceSegmentMessagesProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// The `AudienceSegment` resource.
+message AudienceSegment {
+  option (google.api.resource) = {
+    type: "admanager.googleapis.com/AudienceSegment"
+    pattern: "networks/{network_code}/audienceSegments/{audience_segment}"
+    plural: "audienceSegments"
+    singular: "audienceSegment"
+  };
+
+  // Identifier. The resource name of the `AudienceSegment`.
+  // Format: `networks/{network_code}/audienceSegments/{audience_segment_id}`
+  // The `audience_segment_id` may have up to 1 of the following suffixes:
+  //   - `~direct` for directly licensed third-party segments
+  //   - `~global` for globally licensed third-party segments
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Required. Display name of the `AudienceSegment`. The attribute has a
+  // maximum length of 255 characters.
+  optional string display_name = 2 [(google.api.field_behavior) = REQUIRED];
+}