--- v16/resources/asset.proto 2024-02-22 08:40:46.000000000 +0000
+++ v17/resources/asset.proto 2024-05-29 15:59:04.000000000 +0000
@@ -1,230 +1,230 @@
-// 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.
// 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.v16.resources;
+package google.ads.googleads.v17.resources;
-import "google/ads/googleads/v16/common/asset_types.proto";
-import "google/ads/googleads/v16/common/custom_parameter.proto";
-import "google/ads/googleads/v16/common/policy.proto";
-import "google/ads/googleads/v16/enums/asset_field_type.proto";
-import "google/ads/googleads/v16/enums/asset_source.proto";
-import "google/ads/googleads/v16/enums/asset_type.proto";
-import "google/ads/googleads/v16/enums/policy_approval_status.proto";
-import "google/ads/googleads/v16/enums/policy_review_status.proto";
+import "google/ads/googleads/v17/common/asset_types.proto";
+import "google/ads/googleads/v17/common/custom_parameter.proto";
+import "google/ads/googleads/v17/common/policy.proto";
+import "google/ads/googleads/v17/enums/asset_field_type.proto";
+import "google/ads/googleads/v17/enums/asset_source.proto";
+import "google/ads/googleads/v17/enums/asset_type.proto";
+import "google/ads/googleads/v17/enums/policy_approval_status.proto";
+import "google/ads/googleads/v17/enums/policy_review_status.proto";
import "google/api/field_behavior.proto";
import "google/api/resource.proto";
-option csharp_namespace = "Google.Ads.GoogleAds.V16.Resources";
-option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v16/resources;resources";
+option csharp_namespace = "Google.Ads.GoogleAds.V17.Resources";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v17/resources;resources";
option java_multiple_files = true;
option java_outer_classname = "AssetProto";
-option java_package = "com.google.ads.googleads.v16.resources";
+option java_package = "com.google.ads.googleads.v17.resources";
option objc_class_prefix = "GAA";
-option php_namespace = "Google\\Ads\\GoogleAds\\V16\\Resources";
-option ruby_package = "Google::Ads::GoogleAds::V16::Resources";
+option php_namespace = "Google\\Ads\\GoogleAds\\V17\\Resources";
+option ruby_package = "Google::Ads::GoogleAds::V17::Resources";
// Proto file describing the asset resource.
// Asset is a part of an ad which can be shared across multiple ads.
// It can be an image (ImageAsset), a video (YoutubeVideoAsset), etc.
// Assets are immutable and cannot be removed. To stop an asset from serving,
// remove the asset from the entity that is using it.
message Asset {
option (google.api.resource) = {
type: "googleads.googleapis.com/Asset"
pattern: "customers/{customer_id}/assets/{asset_id}"
};
// Immutable. The resource name of the asset.
// Asset resource names have the form:
//
// `customers/{customer_id}/assets/{asset_id}`
string resource_name = 1 [
(google.api.field_behavior) = IMMUTABLE,
(google.api.resource_reference) = { type: "googleads.googleapis.com/Asset" }
];
// Output only. The ID of the asset.
optional int64 id = 11 [(google.api.field_behavior) = OUTPUT_ONLY];
// Optional name of the asset.
optional string name = 12;
// Output only. Type of the asset.
- google.ads.googleads.v16.enums.AssetTypeEnum.AssetType type = 4
+ google.ads.googleads.v17.enums.AssetTypeEnum.AssetType type = 4
[(google.api.field_behavior) = OUTPUT_ONLY];
// A list of possible final URLs after all cross domain redirects.
repeated string final_urls = 14;
// A list of possible final mobile URLs after all cross domain redirects.
repeated string final_mobile_urls = 16;
// URL template for constructing a tracking URL.
optional string tracking_url_template = 17;
// A list of mappings to be used for substituting URL custom parameter tags in
// the tracking_url_template, final_urls, and/or final_mobile_urls.
- repeated google.ads.googleads.v16.common.CustomParameter
+ repeated google.ads.googleads.v17.common.CustomParameter
url_custom_parameters = 18;
// URL template for appending params to landing page URLs served with parallel
// tracking.
optional string final_url_suffix = 19;
// Output only. Source of the asset.
- google.ads.googleads.v16.enums.AssetSourceEnum.AssetSource source = 38
+ google.ads.googleads.v17.enums.AssetSourceEnum.AssetSource source = 38
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Policy information for the asset.
AssetPolicySummary policy_summary = 13
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Policy information for the asset for each FieldType.
repeated AssetFieldTypePolicySummary field_type_policy_summaries = 40
[(google.api.field_behavior) = OUTPUT_ONLY];
// The specific type of the asset.
oneof asset_data {
// Immutable. A YouTube video asset.
- google.ads.googleads.v16.common.YoutubeVideoAsset youtube_video_asset = 5
+ google.ads.googleads.v17.common.YoutubeVideoAsset youtube_video_asset = 5
[(google.api.field_behavior) = IMMUTABLE];
// Immutable. A media bundle asset.
- google.ads.googleads.v16.common.MediaBundleAsset media_bundle_asset = 6
+ google.ads.googleads.v17.common.MediaBundleAsset media_bundle_asset = 6
[(google.api.field_behavior) = IMMUTABLE];
// Output only. An image asset.
- google.ads.googleads.v16.common.ImageAsset image_asset = 7
+ google.ads.googleads.v17.common.ImageAsset image_asset = 7
[(google.api.field_behavior) = OUTPUT_ONLY];
// Immutable. A text asset.
- google.ads.googleads.v16.common.TextAsset text_asset = 8
+ google.ads.googleads.v17.common.TextAsset text_asset = 8
[(google.api.field_behavior) = IMMUTABLE];
// A lead form asset.
- google.ads.googleads.v16.common.LeadFormAsset lead_form_asset = 9;
+ google.ads.googleads.v17.common.LeadFormAsset lead_form_asset = 9;
// A book on google asset.
- google.ads.googleads.v16.common.BookOnGoogleAsset book_on_google_asset = 10;
+ google.ads.googleads.v17.common.BookOnGoogleAsset book_on_google_asset = 10;
// A promotion asset.
- google.ads.googleads.v16.common.PromotionAsset promotion_asset = 15;
+ google.ads.googleads.v17.common.PromotionAsset promotion_asset = 15;
// A callout asset.
- google.ads.googleads.v16.common.CalloutAsset callout_asset = 20;
+ google.ads.googleads.v17.common.CalloutAsset callout_asset = 20;
// A structured snippet asset.
- google.ads.googleads.v16.common.StructuredSnippetAsset
+ google.ads.googleads.v17.common.StructuredSnippetAsset
structured_snippet_asset = 21;
// A sitelink asset.
- google.ads.googleads.v16.common.SitelinkAsset sitelink_asset = 22;
+ google.ads.googleads.v17.common.SitelinkAsset sitelink_asset = 22;
// A page feed asset.
- google.ads.googleads.v16.common.PageFeedAsset page_feed_asset = 23;
+ google.ads.googleads.v17.common.PageFeedAsset page_feed_asset = 23;
// A dynamic education asset.
- google.ads.googleads.v16.common.DynamicEducationAsset
+ google.ads.googleads.v17.common.DynamicEducationAsset
dynamic_education_asset = 24;
// A mobile app asset.
- google.ads.googleads.v16.common.MobileAppAsset mobile_app_asset = 25;
+ google.ads.googleads.v17.common.MobileAppAsset mobile_app_asset = 25;
// A hotel callout asset.
- google.ads.googleads.v16.common.HotelCalloutAsset hotel_callout_asset = 26;
+ google.ads.googleads.v17.common.HotelCalloutAsset hotel_callout_asset = 26;
// A call asset.
- google.ads.googleads.v16.common.CallAsset call_asset = 27;
+ google.ads.googleads.v17.common.CallAsset call_asset = 27;
// A price asset.
- google.ads.googleads.v16.common.PriceAsset price_asset = 28;
+ google.ads.googleads.v17.common.PriceAsset price_asset = 28;
// Immutable. A call to action asset.
- google.ads.googleads.v16.common.CallToActionAsset call_to_action_asset = 29
+ google.ads.googleads.v17.common.CallToActionAsset call_to_action_asset = 29
[(google.api.field_behavior) = IMMUTABLE];
// A dynamic real estate asset.
- google.ads.googleads.v16.common.DynamicRealEstateAsset
+ google.ads.googleads.v17.common.DynamicRealEstateAsset
dynamic_real_estate_asset = 30;
// A dynamic custom asset.
- google.ads.googleads.v16.common.DynamicCustomAsset dynamic_custom_asset =
+ google.ads.googleads.v17.common.DynamicCustomAsset dynamic_custom_asset =
31;
// A dynamic hotels and rentals asset.
- google.ads.googleads.v16.common.DynamicHotelsAndRentalsAsset
+ google.ads.googleads.v17.common.DynamicHotelsAndRentalsAsset
dynamic_hotels_and_rentals_asset = 32;
// A dynamic flights asset.
- google.ads.googleads.v16.common.DynamicFlightsAsset dynamic_flights_asset =
+ google.ads.googleads.v17.common.DynamicFlightsAsset dynamic_flights_asset =
33;
- // Immutable. A discovery carousel card asset.
- google.ads.googleads.v16.common.DiscoveryCarouselCardAsset
- discovery_carousel_card_asset = 34
+ // Immutable. A Demand Gen carousel card asset.
+ google.ads.googleads.v17.common.DemandGenCarouselCardAsset
+ demand_gen_carousel_card_asset = 50
[(google.api.field_behavior) = IMMUTABLE];
// A dynamic travel asset.
- google.ads.googleads.v16.common.DynamicTravelAsset dynamic_travel_asset =
+ google.ads.googleads.v17.common.DynamicTravelAsset dynamic_travel_asset =
35;
// A dynamic local asset.
- google.ads.googleads.v16.common.DynamicLocalAsset dynamic_local_asset = 36;
+ google.ads.googleads.v17.common.DynamicLocalAsset dynamic_local_asset = 36;
// A dynamic jobs asset.
- google.ads.googleads.v16.common.DynamicJobsAsset dynamic_jobs_asset = 37;
+ google.ads.googleads.v17.common.DynamicJobsAsset dynamic_jobs_asset = 37;
// Output only. A location asset.
- google.ads.googleads.v16.common.LocationAsset location_asset = 39
+ google.ads.googleads.v17.common.LocationAsset location_asset = 39
[(google.api.field_behavior) = OUTPUT_ONLY];
// Immutable. A hotel property asset.
- google.ads.googleads.v16.common.HotelPropertyAsset hotel_property_asset = 41
+ google.ads.googleads.v17.common.HotelPropertyAsset hotel_property_asset = 41
[(google.api.field_behavior) = IMMUTABLE];
}
}
// Contains policy information for an asset under AssetFieldType context.
message AssetFieldTypePolicySummary {
// Output only. FieldType of this asset.
- optional google.ads.googleads.v16.enums.AssetFieldTypeEnum.AssetFieldType
+ optional google.ads.googleads.v17.enums.AssetFieldTypeEnum.AssetFieldType
asset_field_type = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Source of this asset.
- optional google.ads.googleads.v16.enums.AssetSourceEnum.AssetSource
+ optional google.ads.googleads.v17.enums.AssetSourceEnum.AssetSource
asset_source = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Policy summary.
optional AssetPolicySummary policy_summary_info = 3
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// Contains policy information for an asset.
message AssetPolicySummary {
// Output only. The list of policy findings for this asset.
- repeated google.ads.googleads.v16.common.PolicyTopicEntry
+ repeated google.ads.googleads.v17.common.PolicyTopicEntry
policy_topic_entries = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Where in the review process this asset is.
- google.ads.googleads.v16.enums.PolicyReviewStatusEnum.PolicyReviewStatus
+ google.ads.googleads.v17.enums.PolicyReviewStatusEnum.PolicyReviewStatus
review_status = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The overall approval status of this asset, calculated based on
// the status of its individual policy topic entries.
- google.ads.googleads.v16.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus
+ google.ads.googleads.v17.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus
approval_status = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
}
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-05-29 UTC.