Hello,
How can I look up which fields are *required* to create a new campaign, ad
group, or ad etc.
For instance, the gRPC documentation for an AdGroup has all these fields
(below). Do all of these fields need to be filled out to create?
Fields
resource_name
string
The resource name of the ad group. Ad group resource names have the form:
customers/{customer_id}/adGroups/{ad_group_id}
id
Int64Value
<https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Int64Value>
The ID of the ad group.
name
StringValue
<https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.StringValue>
The name of the ad group.
This field is required and should not be empty when creating new ad groups.
It must contain fewer than 255 UTF-8 full-width characters.
It must not contain any null (code point 0x0), NL line feed (code point
0xA) or carriage return (code point 0xD) characters.
status
AdGroupStatus
<https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.enums#google.ads.googleads.v0.enums.AdGroupStatusEnum.AdGroupStatus>
The status of the ad group.
type
AdGroupType
<https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.enums#google.ads.googleads.v0.enums.AdGroupTypeEnum.AdGroupType>
The type of the ad group.
ad_rotation_mode
AdGroupAdRotationMode
<https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.enums#google.ads.googleads.v0.enums.AdGroupAdRotationModeEnum.AdGroupAdRotationMode>
The ad rotation mode of the ad group.
tracking_url_template
StringValue
<https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.StringValue>
The URL template for constructing a tracking URL.
url_custom_parameters[]
CustomParameter
<https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.common#google.ads.googleads.v0.common.CustomParameter>
The list of mappings used to substitute custom parameter tags in a
tracking_url_template, final_urls, or mobile_final_urls.
campaign
StringValue
<https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.StringValue>
The campaign to which the ad group belongs.
cpc_bid_micros
Int64Value
<https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Int64Value>
The maximum CPC (cost-per-click) bid.
cpm_bid_micros
Int64Value
<https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Int64Value>
The maximum CPM (cost-per-thousand viewable impressions) bid.
cpa_bid_micros
Int64Value
<https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Int64Value>
The target cost-per-acquisition (conversion) bid.
cpv_bid_micros
Int64Value
<https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Int64Value>
The CPV (cost-per-view) bid.
target_roas_override
DoubleValue
<https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.DoubleValue>
The target return on ad spend (ROAS) override. If the ad group's campaign
bidding strategy is a standard Target ROAS strategy, then this field
overrides the target ROAS specified in the campaign's bidding strategy.
Otherwise, this value is ignored.
percent_cpc_bid_micros
Int64Value
<https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Int64Value>
The percent cpc bid amount, expressed as a fraction of the advertised price
for some good or service. The valid range for the fraction is [0,1) and the
value stored here is 1,000,000 * [fraction].
explorer_auto_optimizer_setting
ExplorerAutoOptimizerSetting
<https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.common#google.ads.googleads.v0.common.ExplorerAutoOptimizerSetting>
Settings for the Display Campaign Optimizer, initially termed "Explorer".
display_custom_bid_dimension
TargetingDimension
<https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.enums#google.ads.googleads.v0.enums.TargetingDimensionEnum.TargetingDimension>
Allows advertisers to specify a targeting dimension on which to place
absolute bids. This is only applicable for campaigns that target only the
display network and not search.
final_url_suffix
StringValue
<https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.StringValue>
URL template for appending params to Final URL.
--
--
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
Also find us on our blog:
https://googleadsdeveloper.blogspot.com/
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
You received this message because you are subscribed to the Google
Groups "AdWords API and Google Ads API Forum" group.
To post to this group, send email to adwords-api@googlegroups.com
To unsubscribe from this group, send email to
adwords-api+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/adwords-api?hl=en
---
You received this message because you are subscribed to the Google Groups
"AdWords API and Google Ads API Forum" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to adwords-api+unsubscr...@googlegroups.com.
Visit this group at https://groups.google.com/group/adwords-api.
To view this discussion on the web visit
https://groups.google.com/d/msgid/adwords-api/621b163c-0248-43a8-b1b7-d87d4f339165%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
