Hi John,
You can check the fields if they are required by referring to the *Google
Ads API Fields section* in here
<https://developers.google.com/google-ads/api/reference/rpc/>. For
instance, for the ad group name, it is stated here
<https://developers.google.com/google-ads/api/docs/fields/ad_group#ad_groupname>
that this is required upon creation of the ad group entity. However, other
fields don't have this stated. You may also do the same checking with
campaign fields and other entities.
Let me know if you have further clarifications.
Regards,
Dannison
Google Ads API Team
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
Also find us on our blog and discussion group:
http://googleadsdeveloper.blogspot.com/search/label/adwords_api
https://developers.google.com/adwords/api/community/
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
On 01/31/19 02:40:22 j...@greenfieldlabs.ca wrote:
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
--
--
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
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/ijlio7umr0000000g35l180052fv32w6smjic9o6oo30c1g68q3ie1j%40mail.gmail.com.
For more options, visit https://groups.google.com/d/optout.
