xref: /aosp_15_r20/external/googleapis/google/ads/googleads/v16/common/ad_asset.proto (revision d5c09012810ac0c9f33fe448fb6da8260d444cc9)
1// Copyright 2023 Google LLC
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7//     http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15syntax = "proto3";
16
17package google.ads.googleads.v16.common;
18
19import "google/ads/googleads/v16/common/asset_policy.proto";
20import "google/ads/googleads/v16/enums/asset_performance_label.proto";
21import "google/ads/googleads/v16/enums/served_asset_field_type.proto";
22
23option csharp_namespace = "Google.Ads.GoogleAds.V16.Common";
24option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v16/common;common";
25option java_multiple_files = true;
26option java_outer_classname = "AdAssetProto";
27option java_package = "com.google.ads.googleads.v16.common";
28option objc_class_prefix = "GAA";
29option php_namespace = "Google\\Ads\\GoogleAds\\V16\\Common";
30option ruby_package = "Google::Ads::GoogleAds::V16::Common";
31
32// Proto file describing assets used inside an ad.
33
34// A text asset used inside an ad.
35message AdTextAsset {
36  // Asset text.
37  optional string text = 4;
38
39  // The pinned field of the asset. This restricts the asset to only serve
40  // within this field. Multiple assets can be pinned to the same field. An
41  // asset that is unpinned or pinned to a different field will not serve in a
42  // field where some other asset has been pinned.
43  google.ads.googleads.v16.enums.ServedAssetFieldTypeEnum.ServedAssetFieldType
44      pinned_field = 2;
45
46  // The performance label of this text asset.
47  google.ads.googleads.v16.enums.AssetPerformanceLabelEnum.AssetPerformanceLabel
48      asset_performance_label = 5;
49
50  // The policy summary of this text asset.
51  AdAssetPolicySummary policy_summary_info = 6;
52}
53
54// An image asset used inside an ad.
55message AdImageAsset {
56  // The Asset resource name of this image.
57  optional string asset = 2;
58}
59
60// A video asset used inside an ad.
61message AdVideoAsset {
62  // The Asset resource name of this video.
63  optional string asset = 2;
64}
65
66// A media bundle asset used inside an ad.
67message AdMediaBundleAsset {
68  // The Asset resource name of this media bundle.
69  optional string asset = 2;
70}
71
72// A discovery carousel card asset used inside an ad.
73message AdDiscoveryCarouselCardAsset {
74  // The Asset resource name of this discovery carousel card.
75  optional string asset = 1;
76}
77
78// A call to action asset used inside an ad.
79message AdCallToActionAsset {
80  // The Asset resource name of this call to action asset.
81  optional string asset = 1;
82}
83