/resources/asset_group.proto

--- v23/resources/asset_group.proto 2026-06-18 21:20:45.000000000 +0000
+++ v24/resources/asset_group.proto 2026-06-18 18:20:00.000000000 +0000
@@ -1,159 +1,180 @@
 // 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.googleads.v23.resources;
+package google.ads.googleads.v24.resources;

-import "google/ads/googleads/v23/enums/ad_strength.proto";
-import "google/ads/googleads/v23/enums/ad_strength_action_item_type.proto";
-import "google/ads/googleads/v23/enums/asset_coverage_video_aspect_ratio_requirement.proto";
-import "google/ads/googleads/v23/enums/asset_field_type.proto";
-import "google/ads/googleads/v23/enums/asset_group_primary_status.proto";
-import "google/ads/googleads/v23/enums/asset_group_primary_status_reason.proto";
-import "google/ads/googleads/v23/enums/asset_group_status.proto";
+import "google/ads/googleads/v24/enums/ad_strength.proto";
+import "google/ads/googleads/v24/enums/ad_strength_action_item_type.proto";
+import "google/ads/googleads/v24/enums/asset_coverage_video_aspect_ratio_requirement.proto";
+import "google/ads/googleads/v24/enums/asset_field_type.proto";
+import "google/ads/googleads/v24/enums/asset_group_primary_status.proto";
+import "google/ads/googleads/v24/enums/asset_group_primary_status_reason.proto";
+import "google/ads/googleads/v24/enums/asset_group_status.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";

-option csharp_namespace = "Google.Ads.GoogleAds.V23.Resources";
-option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v23/resources;resources";
+option csharp_namespace = "Google.Ads.GoogleAds.V24.Resources";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v24/resources;resources";
 option java_multiple_files = true;
 option java_outer_classname = "AssetGroupProto";
-option java_package = "com.google.ads.googleads.v23.resources";
+option java_package = "com.google.ads.googleads.v24.resources";
 option objc_class_prefix = "GAA";
-option php_namespace = "Google\\Ads\\GoogleAds\\V23\\Resources";
-option ruby_package = "Google::Ads::GoogleAds::V23::Resources";
+option php_namespace = "Google\\Ads\\GoogleAds\\V24\\Resources";
+option ruby_package = "Google::Ads::GoogleAds::V24::Resources";

 // An asset group.
 // AssetGroupAsset is used to link an asset to the asset group.
 // AssetGroupSignal is used to associate a signal to an asset group.
 message AssetGroup {
   option (google.api.resource) = {
     type: "googleads.googleapis.com/AssetGroup"
     pattern: "customers/{customer_id}/assetGroups/{asset_group_id}"
     plural: "assetGroups"
     singular: "assetGroup"
   };

   // Immutable. The resource name of the asset group.
   // Asset group resource names have the form:
   //
   // `customers/{customer_id}/assetGroups/{asset_group_id}`
   string resource_name = 1 [
     (google.api.field_behavior) = IMMUTABLE,
     (google.api.resource_reference) = {
       type: "googleads.googleapis.com/AssetGroup"
     }
   ];

   // Output only. The ID of the asset group.
   int64 id = 9 [(google.api.field_behavior) = OUTPUT_ONLY];

   // Immutable. The campaign with which this asset group is associated.
   // The asset which is linked to the asset group.
   string campaign = 2 [
     (google.api.field_behavior) = IMMUTABLE,
     (google.api.resource_reference) = {
       type: "googleads.googleapis.com/Campaign"
     }
   ];

   // Required. Name of the asset group. Required. It must have a minimum length
   // of 1 and maximum length of 128. It must be unique under a campaign.
   string name = 3 [(google.api.field_behavior) = REQUIRED];

   // A list of final URLs after all cross domain redirects. In performance max,
   // by default, the urls are eligible for expansion unless opted out.
   repeated string final_urls = 4;

   // A list of final mobile URLs after all cross domain redirects. In
   // performance max, by default, the urls are eligible for expansion
   // unless opted out.
   repeated string final_mobile_urls = 5;

   // The status of the asset group.
-  google.ads.googleads.v23.enums.AssetGroupStatusEnum.AssetGroupStatus status =
+  google.ads.googleads.v24.enums.AssetGroupStatusEnum.AssetGroupStatus status =
       6;

   // Output only. The primary status of the asset group. Provides insights into
   // why an asset group is not serving or not serving optimally.
-  google.ads.googleads.v23.enums.AssetGroupPrimaryStatusEnum
+  google.ads.googleads.v24.enums.AssetGroupPrimaryStatusEnum
       .AssetGroupPrimaryStatus primary_status = 11
       [(google.api.field_behavior) = OUTPUT_ONLY];

   // Output only. Provides reasons into why an asset group is not serving or not
   // serving optimally. It will be empty when the asset group is serving without
   // issues.
-  repeated google.ads.googleads.v23.enums.AssetGroupPrimaryStatusReasonEnum
+  repeated google.ads.googleads.v24.enums.AssetGroupPrimaryStatusReasonEnum
       .AssetGroupPrimaryStatusReason primary_status_reasons = 12
       [(google.api.field_behavior) = OUTPUT_ONLY];

   // First part of text that may appear appended to the url displayed in
   // the ad.
   string path1 = 7;

   // Second part of text that may appear appended to the url displayed in
   // the ad. This field can only be set when path1 is set.
   string path2 = 8;

   // Output only. Overall ad strength of this asset group.
-  google.ads.googleads.v23.enums.AdStrengthEnum.AdStrength ad_strength = 10
+  google.ads.googleads.v24.enums.AdStrengthEnum.AdStrength ad_strength = 10
       [(google.api.field_behavior) = OUTPUT_ONLY];

   // Output only. The asset coverage of this asset group.
   AssetCoverage asset_coverage = 13 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Local services info of the asset group.
+  GoogleLocalServicesInfo google_local_services_info = 14;
 }

 // Information about the asset coverage of an asset group.
 message AssetCoverage {
   // Output only. A list of action items to improve the ad strength of an asset
   // group.
   repeated AdStrengthActionItem ad_strength_action_items = 1
       [(google.api.field_behavior) = OUTPUT_ONLY];
 }

 // An action item to improve the ad strength of an asset group.
 message AdStrengthActionItem {
   // The details of the asset to add.
   message AddAssetDetails {
     // Output only. The asset field type of the asset(s) to add.
-    google.ads.googleads.v23.enums.AssetFieldTypeEnum.AssetFieldType
+    google.ads.googleads.v24.enums.AssetFieldTypeEnum.AssetFieldType
         asset_field_type = 1 [(google.api.field_behavior) = OUTPUT_ONLY];

     // Output only. The number of assets to add.
     optional int32 asset_count = 2 [(google.api.field_behavior) = OUTPUT_ONLY];

     // Output only. For video field types, the required aspect ratio of the
     // video. When unset and asset_field_type is YOUTUBE_VIDEO, the system
     // recommends the advertiser upload any YouTube video, regardless of aspect
     // ratio.
-    optional google.ads.googleads.v23.enums
+    optional google.ads.googleads.v24.enums
         .AssetCoverageVideoAspectRatioRequirementEnum
         .AssetCoverageVideoAspectRatioRequirement
             video_aspect_ratio_requirement = 3
         [(google.api.field_behavior) = OUTPUT_ONLY];
   }

   // Output only. The action item type.
-  google.ads.googleads.v23.enums.AdStrengthActionItemTypeEnum
+  google.ads.googleads.v24.enums.AdStrengthActionItemTypeEnum
       .AdStrengthActionItemType action_item_type = 1
       [(google.api.field_behavior) = OUTPUT_ONLY];

   // The details of this action item.
   oneof action_details {
     // Output only. The action item details for action item type ADD_ASSET.
     AddAssetDetails add_asset_details = 2
         [(google.api.field_behavior) = OUTPUT_ONLY];
   }
 }
+
+// Local services info for the asset group.
+message GoogleLocalServicesInfo {
+  // Immutable. The local services category associated with this asset group.
+  // That is, XCAT format - xcat:service_area_business_plumber. See
+  // https://developers.google.com/google-ads/api/data/codes-formats#local-services-category-ids
+  // This field cannot be modified after the AssetGroup has been created.
+  optional string category_id = 1 [(google.api.field_behavior) = IMMUTABLE];
+
+  // Callouts selected by the advertiser to show.
+  repeated LocalServicesCallout callouts = 2;
+}
+
+// Local services callout of the asset group.
+message LocalServicesCallout {
+  // Required. The unique ID of the callout.
+  optional string callout_id = 1 [(google.api.field_behavior) = REQUIRED];
+}