feat: Add text_ad expanded_text_ad responsive_search_ad product_ad an…

…d expanded_dynamic_search_ad to ad_group_ad resource

PiperOrigin-RevId: 532267123

google/ads/searchads360/v0/common/ad_type_infos.proto

@@ -0,0 +1,103 @@
+// Copyright 2023 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.searchads360.v0.common;
+
+option csharp_namespace = "Google.Ads.SearchAds360.V0.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/searchads360/v0/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "AdTypeInfosProto";
+option java_package = "com.google.ads.searchads360.v0.common";
+option objc_class_prefix = "GASA360";
+option php_namespace = "Google\\Ads\\SearchAds360\\V0\\Common";
+option ruby_package = "Google::Ads::SearchAds360::V0::Common";
+
+// Proto file containing info messages for specific ad types.
+
+// A Search Ads 360 text ad.
+message SearchAds360TextAdInfo {
+  // The headline of the ad.
+  optional string headline = 1;
+
+  // The first line of the ad's description.
+  optional string description1 = 2;
+
+  // The second line of the ad's description.
+  optional string description2 = 3;
+
+  // The displayed URL of the ad.
+  optional string display_url = 4;
+
+  // The displayed mobile URL of the ad.
+  optional string display_mobile_url = 5;
+
+  // The tracking id of the ad.
+  optional int64 ad_tracking_id = 6;
+}
+
+// A Search Ads 360 expanded text ad.
+message SearchAds360ExpandedTextAdInfo {
+  // The headline of the ad.
+  optional string headline = 1;
+
+  // The second headline of the ad.
+  optional string headline2 = 2;
+
+  // The third headline of the ad.
+  optional string headline3 = 3;
+
+  // The first line of the ad's description.
+  optional string description1 = 4;
+
+  // The second line of the ad's description.
+  optional string description2 = 5;
+
+  // Text appended to the auto-generated visible URL with a delimiter.
+  optional string path1 = 6;
+
+  // Text appended to path1 with a delimiter.
+  optional string path2 = 7;
+
+  // The tracking id of the ad.
+  optional int64 ad_tracking_id = 8;
+}
+
+// An expanded dynamic search ad.
+message SearchAds360ExpandedDynamicSearchAdInfo {
+  // The first line of the ad's description.
+  optional string description1 = 1;
+
+  // The second line of the ad's description.
+  optional string description2 = 2;
+
+  // The tracking id of the ad.
+  optional int64 ad_tracking_id = 3;
+}
+
+// A Search Ads 360 product ad.
+message SearchAds360ProductAdInfo {}
+
+// A Search Ads 360 responsive search ad.
+message SearchAds360ResponsiveSearchAdInfo {
+  // Text appended to the auto-generated visible URL with a delimiter.
+  optional string path1 = 1;
+
+  // Text appended to path1 with a delimiter.
+  optional string path2 = 2;
+
+  // The tracking id of the ad.
+  optional int64 ad_tracking_id = 3;
+}

google/ads/searchads360/v0/common/segments.proto

@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.ads.searchads360.v0.common;
 
+import "google/ads/searchads360/v0/common/criteria.proto";
 import "google/ads/searchads360/v0/enums/conversion_action_category.proto";
 import "google/ads/searchads360/v0/enums/day_of_week.proto";
 import "google/ads/searchads360/v0/enums/device.proto";
@@ -56,6 +57,9 @@ message Segments {
   // Device to which metrics apply.
   google.ads.searchads360.v0.enums.DeviceEnum.Device device = 1;
 
+  // Keyword criterion.
+  Keyword keyword = 61;
+
   // Month as represented by the date of the first day of a month. Formatted as
   // yyyy-MM-dd.
   optional string month = 90;
@@ -72,3 +76,12 @@ message Segments {
   // Year, formatted as yyyy.
   optional int32 year = 131;
 }
+
+// A Keyword criterion segment.
+message Keyword {
+  // The AdGroupCriterion resource name.
+  optional string ad_group_criterion = 3;
+
+  // Keyword info.
+  KeywordInfo info = 2;
+}

google/ads/searchads360/v0/enums/asset_field_type.proto

@@ -71,7 +71,7 @@ message AssetFieldTypeEnum {
     // The asset is linked for use as a Structured Snippet extension.
     STRUCTURED_SNIPPET = 12;
 
-    // The asset is linked for use as a Sitelink extension.
+    // The asset is linked for use as a Sitelink.
     SITELINK = 13;
 
     // The asset is linked for use as a Mobile App extension.

google/ads/searchads360/v0/resources/ad.proto

@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.ads.searchads360.v0.resources;
 
+import "google/ads/searchads360/v0/common/ad_type_infos.proto";
 import "google/ads/searchads360/v0/enums/ad_type.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
@@ -66,4 +67,28 @@ message Ad {
   // name field is currently only supported for DisplayUploadAd, ImageAd,
   // ShoppingComparisonListingAd and VideoAd.
   optional string name = 47 [(google.api.field_behavior) = IMMUTABLE];
+
+  // Details pertinent to the ad type. Exactly one value must be set.
+  oneof ad_data {
+    // Immutable. Details pertaining to a text ad.
+    google.ads.searchads360.v0.common.SearchAds360TextAdInfo text_ad = 55
+        [(google.api.field_behavior) = IMMUTABLE];
+
+    // Immutable. Details pertaining to an expanded text ad.
+    google.ads.searchads360.v0.common.SearchAds360ExpandedTextAdInfo
+        expanded_text_ad = 56 [(google.api.field_behavior) = IMMUTABLE];
+
+    // Immutable. Details pertaining to a responsive search ad.
+    google.ads.searchads360.v0.common.SearchAds360ResponsiveSearchAdInfo
+        responsive_search_ad = 57 [(google.api.field_behavior) = IMMUTABLE];
+
+    // Immutable. Details pertaining to a product ad.
+    google.ads.searchads360.v0.common.SearchAds360ProductAdInfo product_ad = 58
+        [(google.api.field_behavior) = IMMUTABLE];
+
+    // Immutable. Details pertaining to an expanded dynamic search ad.
+    google.ads.searchads360.v0.common.SearchAds360ExpandedDynamicSearchAdInfo
+        expanded_dynamic_search_ad = 59
+        [(google.api.field_behavior) = IMMUTABLE];
+  }
 }

google/ads/searchads360/v0/resources/ad_group_criterion.proto

@@ -181,8 +181,8 @@ message AdGroupCriterion {
     google.ads.searchads360.v0.common.WebpageInfo webpage = 46
         [(google.api.field_behavior) = IMMUTABLE];
 
-    // Immutable. Location.
+    // Output only. Location.
     google.ads.searchads360.v0.common.LocationInfo location = 82
-        [(google.api.field_behavior) = IMMUTABLE];
+        [(google.api.field_behavior) = OUTPUT_ONLY];
   }
 }