feat: v0_6 Launch

feat: Enable hourly and geo segmentation feat: Adds start_time to customer_manager_link feat: Adds support for multimedia ads type feat: Adds support for average_quality_score feat: Adds SOCIAL_FACEBOOK_TRACKING_ONLY in advertising_sub_channel docs: A comment for message `SearchAds360Error` is changed docs: A comment for field `target_spend_micros` in message `.google.ads.searchads360.v0.common.TargetSpend` is changed docs: A comment for field `engine_id` in message `.google.ads.searchads360.v0.resources.AdGroupAd` is changed docs: A comment for field `merchant_id` in message `.google.ads.searchads360.v0.resources.Conversion` is changed docs: A comment for field `visit_id` in message `.google.ads.searchads360.v0.resources.Conversion` is changed docs: A comment for field `target_spend_micros` in message `.google.ads.searchads360.v0.common.TargetSpend` is changed docs: A comment for field `engine_id` in message `.google.ads.searchads360.v0.resources.AdGroupAd` is changed docs: A comment for field `merchant_id` in message `.google.ads.searchads360.v0.resources.Conversion` is changed docs: A comment for field `visit_id` in message `.google.ads.searchads360.v0.resources.Conversion` is changed PiperOrigin-RevId: 657352907
googleapis · Jul 29, 2024 · 87a20e3 · 87a20e3
1 parent e1d378c
commit 87a20e3
Show file tree

Hide file tree

Showing 176 changed files with 259 additions and 183 deletions.
diff --git a/google/ads/searchads360/v0/common/ad_asset.proto b/google/ads/searchads360/v0/common/ad_asset.proto
@@ -0,0 +1,34 @@
+// Copyright 2024 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 = "AdAssetProto";
+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 describing assets used inside an ad.
+
+// A text asset used inside an ad.
+message AdTextAsset {
+  // Asset text.
+  optional string text = 4;
+}
diff --git a/google/ads/searchads360/v0/common/ad_type_infos.proto b/google/ads/searchads360/v0/common/ad_type_infos.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -16,6 +16,8 @@ syntax = "proto3";
 
 package google.ads.searchads360.v0.common;
 
+import "google/ads/searchads360/v0/common/ad_asset.proto";
+
 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;
@@ -100,4 +102,12 @@ message SearchAds360ResponsiveSearchAdInfo {
 
   // The tracking id of the ad.
   optional int64 ad_tracking_id = 3;
+
+  // List of text assets for headlines. When the ad serves the headlines will
+  // be selected from this list.
+  repeated AdTextAsset headlines = 4;
+
+  // List of text assets for descriptions. When the ad serves the descriptions
+  // will be selected from this list.
+  repeated AdTextAsset descriptions = 5;
 }
diff --git a/google/ads/searchads360/v0/common/asset_types.proto b/google/ads/searchads360/v0/common/asset_types.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/common/asset_usage.proto b/google/ads/searchads360/v0/common/asset_usage.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/common/bidding.proto b/google/ads/searchads360/v0/common/bidding.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -165,7 +165,7 @@ message TargetRoas {
 // An automated bid strategy that sets your bids to help get as many clicks
 // as possible within your budget.
 message TargetSpend {
-  // The spend target under which to maximize clicks.
+  // Deprecated: The spend target under which to maximize clicks.
   // A TargetSpend bidder will attempt to spend the smaller of this value
   // or the natural throttling spend amount.
   // If not specified, the budget is used as the spend target.

diff --git a/google/ads/searchads360/v0/common/criteria.proto b/google/ads/searchads360/v0/common/criteria.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/common/custom_parameter.proto b/google/ads/searchads360/v0/common/custom_parameter.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/common/frequency_cap.proto b/google/ads/searchads360/v0/common/frequency_cap.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/common/metrics.proto b/google/ads/searchads360/v0/common/metrics.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -242,6 +242,9 @@ message Metrics {
   google.ads.searchads360.v0.enums.QualityScoreBucketEnum.QualityScoreBucket
       historical_creative_quality_score = 80;
 
+  // The average quality score.
+  optional double average_quality_score = 364;
+
   // The quality of historical landing page experience.
   google.ads.searchads360.v0.enums.QualityScoreBucketEnum.QualityScoreBucket
       historical_landing_page_quality_score = 81;

diff --git a/google/ads/searchads360/v0/common/real_time_bidding_setting.proto b/google/ads/searchads360/v0/common/real_time_bidding_setting.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/common/segments.proto b/google/ads/searchads360/v0/common/segments.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -69,6 +69,21 @@ message Segments {
   // Device to which metrics apply.
   google.ads.searchads360.v0.enums.DeviceEnum.Device device = 1;
 
+  // Resource name of the geo target constant that represents a city.
+  optional string geo_target_city = 118;
+
+  // Resource name of the geo target constant that represents a country.
+  optional string geo_target_country = 119;
+
+  // Resource name of the geo target constant that represents a metro.
+  optional string geo_target_metro = 122;
+
+  // Resource name of the geo target constant that represents a region.
+  optional string geo_target_region = 126;
+
+  // Hour of day as a number between 0 and 23, inclusive.
+  optional int32 hour = 88;
+
   // Keyword criterion.
   Keyword keyword = 61;
 

diff --git a/google/ads/searchads360/v0/common/targeting_setting.proto b/google/ads/searchads360/v0/common/targeting_setting.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/common/text_label.proto b/google/ads/searchads360/v0/common/text_label.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/common/value.proto b/google/ads/searchads360/v0/common/value.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/account_status.proto b/google/ads/searchads360/v0/enums/account_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/account_type.proto b/google/ads/searchads360/v0/enums/account_type.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/ad_group_ad_engine_status.proto b/google/ads/searchads360/v0/enums/ad_group_ad_engine_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/ad_group_ad_rotation_mode.proto b/google/ads/searchads360/v0/enums/ad_group_ad_rotation_mode.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/ad_group_ad_status.proto b/google/ads/searchads360/v0/enums/ad_group_ad_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/ad_group_criterion_engine_status.proto b/google/ads/searchads360/v0/enums/ad_group_criterion_engine_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/ad_group_criterion_status.proto b/google/ads/searchads360/v0/enums/ad_group_criterion_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/ad_group_engine_status.proto b/google/ads/searchads360/v0/enums/ad_group_engine_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/ad_group_status.proto b/google/ads/searchads360/v0/enums/ad_group_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/ad_group_type.proto b/google/ads/searchads360/v0/enums/ad_group_type.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/ad_network_type.proto b/google/ads/searchads360/v0/enums/ad_network_type.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/ad_serving_optimization_status.proto b/google/ads/searchads360/v0/enums/ad_serving_optimization_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/ad_strength.proto b/google/ads/searchads360/v0/enums/ad_strength.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/ad_type.proto b/google/ads/searchads360/v0/enums/ad_type.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -135,5 +135,8 @@ message AdTypeEnum {
 
     // Discovery video responsive ad.
     DISCOVERY_VIDEO_RESPONSIVE_AD = 38;
+
+    // Multimedia ad.
+    MULTIMEDIA_AD = 43;
   }
 }
diff --git a/google/ads/searchads360/v0/enums/advertising_channel_sub_type.proto b/google/ads/searchads360/v0/enums/advertising_channel_sub_type.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -100,5 +100,8 @@ message AdvertisingChannelSubTypeEnum {
 
     // Travel Activities campaigns.
     TRAVEL_ACTIVITIES = 20;
+
+    // Facebook tracking only social campaigns.
+    SOCIAL_FACEBOOK_TRACKING_ONLY = 21;
   }
 }
diff --git a/google/ads/searchads360/v0/enums/advertising_channel_type.proto b/google/ads/searchads360/v0/enums/advertising_channel_type.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -74,5 +74,8 @@ message AdvertisingChannelTypeEnum {
 
     // Travel campaigns.
     TRAVEL = 13;
+
+    // Social campaigns.
+    SOCIAL = 15;
   }
 }
diff --git a/google/ads/searchads360/v0/enums/age_range_type.proto b/google/ads/searchads360/v0/enums/age_range_type.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/asset_engine_status.proto b/google/ads/searchads360/v0/enums/asset_engine_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/asset_field_type.proto b/google/ads/searchads360/v0/enums/asset_field_type.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/asset_group_status.proto b/google/ads/searchads360/v0/enums/asset_group_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/asset_link_status.proto b/google/ads/searchads360/v0/enums/asset_link_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/asset_set_asset_status.proto b/google/ads/searchads360/v0/enums/asset_set_asset_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/asset_set_link_status.proto b/google/ads/searchads360/v0/enums/asset_set_link_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/asset_status.proto b/google/ads/searchads360/v0/enums/asset_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/asset_type.proto b/google/ads/searchads360/v0/enums/asset_type.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/attribution_model.proto b/google/ads/searchads360/v0/enums/attribution_model.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/attribution_type.proto b/google/ads/searchads360/v0/enums/attribution_type.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/bidding_strategy_status.proto b/google/ads/searchads360/v0/enums/bidding_strategy_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/bidding_strategy_system_status.proto b/google/ads/searchads360/v0/enums/bidding_strategy_system_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/bidding_strategy_type.proto b/google/ads/searchads360/v0/enums/bidding_strategy_type.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/budget_delivery_method.proto b/google/ads/searchads360/v0/enums/budget_delivery_method.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

diff --git a/google/ads/searchads360/v0/enums/budget_period.proto b/google/ads/searchads360/v0/enums/budget_period.proto
@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.