package google.ads.googleads.v0.resources
Get desktop application:
View/edit binary Protocol Buffers messages
message
account_budget.proto:51An account-level budget. It contains information about the budget itself, as well as the most recently approved changes to the budget and proposed changes that are pending approval. The proposed changes that are pending approval, if any, are found in 'pending_proposal'. Effective details about the budget are found in fields prefixed 'approved_', 'adjusted_' and those without a prefix. Since some effective details may differ from what the user had originally requested (e.g. spending limit), these differences are juxtaposed via 'proposed_', 'approved_', and possibly 'adjusted_' fields. This resource is mutated using AccountBudgetProposal and cannot be mutated directly. A budget may have at most one pending proposal at any given time. It is read through pending_proposal. Once approved, a budget may be subject to adjustments, such as credit adjustments. Adjustments create differences between the 'approved' and 'adjusted' fields, which would otherwise be identical.
Used as response type in: services.AccountBudgetService.GetAccountBudget
Used as field type in:
string resource_name = 1
The resource name of the account-level budget. AccountBudget resource names have the form: `customers/{customer_id}/accountBudgets/{account_budget_id}`
optional id = 2
The ID of the account-level budget.
optional billing_setup = 3
The resource name of the billing setup associated with this account-level budget. BillingSetup resource names have the form: `customers/{customer_id}/billingSetups/{billing_setup_id}`
enums.AccountBudgetStatusEnum.AccountBudgetStatus status = 4
The status of this account-level budget.
optional name = 5
The name of the account-level budget.
optional proposed_start_date_time = 6
The proposed start time of the account-level budget in yyyy-MM-dd HH:mm:ss format. If a start time type of NOW was proposed, this is the time of request.
optional approved_start_date_time = 7
The approved start time of the account-level budget in yyyy-MM-dd HH:mm:ss format. For example, if a new budget is approved after the proposed start time, the approved start time is the time of approval.
optional total_adjustments_micros = 18
The total adjustments amount. An example of an adjustment is courtesy credits.
optional amount_served_micros = 19
The value of Ads that have been served, in micros. This includes overdelivery costs, in which case a credit might be automatically applied to the budget (see total_adjustments_micros).
optional purchase_order_number = 20
A purchase order number is a value that helps users reference this budget in their monthly invoices.
optional notes = 21
Notes associated with the budget.
optional pending_proposal = 22
The pending proposal to modify this budget, if applicable.
oneof proposed_end_time
The proposed end time of the account-level budget.
proposed_end_date_time = 8
The proposed end time in yyyy-MM-dd HH:mm:ss format.
enums.TimeTypeEnum.TimeType proposed_end_time_type = 9
The proposed end time as a well-defined type, e.g. FOREVER.
oneof approved_end_time
The approved end time of the account-level budget. For example, if a budget's end time is updated and the proposal is approved after the proposed end time, the approved end time is the time of approval.
approved_end_date_time = 10
The approved end time in yyyy-MM-dd HH:mm:ss format.
enums.TimeTypeEnum.TimeType approved_end_time_type = 11
The approved end time as a well-defined type, e.g. FOREVER.
oneof proposed_spending_limit
The proposed spending limit.
proposed_spending_limit_micros = 12
The proposed spending limit in micros. One million is equivalent to one unit.
enums.SpendingLimitTypeEnum.SpendingLimitType proposed_spending_limit_type = 13
The proposed spending limit as a well-defined type, e.g. INFINITE.
oneof approved_spending_limit
The approved spending limit. For example, if the amount already spent by the account exceeds the proposed spending limit at the time the proposal is approved, the approved spending limit is set to the amount already spent.
approved_spending_limit_micros = 14
The approved spending limit in micros. One million is equivalent to one unit. This will only be populated if the proposed spending limit is finite, and will always be greater than or equal to the proposed spending limit.
enums.SpendingLimitTypeEnum.SpendingLimitType approved_spending_limit_type = 15
The approved spending limit as a well-defined type, e.g. INFINITE. This will only be populated if the approved spending limit is INFINITE.
oneof adjusted_spending_limit
The spending limit after adjustments have been applied. Adjustments are stored in total_adjustments_micros. This value has the final say on how much the account is allowed to spend.
adjusted_spending_limit_micros = 16
The adjusted spending limit in micros. One million is equivalent to one unit. If the approved spending limit is finite, the adjusted spending limit may vary depending on the types of adjustments applied to this budget, if applicable. The different kinds of adjustments are described here: https://support.google.com/google-ads/answer/1704323 For example, a debit adjustment reduces how much the account is allowed to spend.
enums.SpendingLimitTypeEnum.SpendingLimitType adjusted_spending_limit_type = 17
The adjusted spending limit as a well-defined type, e.g. INFINITE. This will only be populated if the adjusted spending limit is INFINITE, which is guaranteed to be true if the approved spending limit is INFINITE.
message
account_budget.proto:54A pending proposal associated with the enclosing account-level budget, if applicable.
Used in:
optional account_budget_proposal = 1
The resource name of the proposal. AccountBudgetProposal resource names have the form: `customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}`
enums.AccountBudgetProposalTypeEnum.AccountBudgetProposalType proposal_type = 2
The type of this proposal, e.g. END to end the budget associated with this proposal.
optional name = 3
The name to assign to the account-level budget.
optional start_date_time = 4
The start time in yyyy-MM-dd HH:mm:ss format.
optional purchase_order_number = 9
A purchase order number is a value that helps users reference this budget in their monthly invoices.
optional notes = 10
Notes associated with this budget.
optional creation_date_time = 11
The time when this account-level budget proposal was created. Formatted as yyyy-MM-dd HH:mm:ss.
oneof end_time
The end time of the account-level budget.
end_date_time = 5
The end time in yyyy-MM-dd HH:mm:ss format.
enums.TimeTypeEnum.TimeType end_time_type = 6
The end time as a well-defined type, e.g. FOREVER.
oneof spending_limit
The spending limit.
spending_limit_micros = 7
The spending limit in micros. One million is equivalent to one unit.
enums.SpendingLimitTypeEnum.SpendingLimitType spending_limit_type = 8
The spending limit as a well-defined type, e.g. INFINITE.
message
account_budget_proposal.proto:44An account-level budget proposal. All fields prefixed with 'proposed' may not necessarily be applied directly. For example, proposed spending limits may be adjusted before their application. This is true if the 'proposed' field has an 'approved' counterpart, e.g. spending limits. Please note that the proposal type (proposal_type) changes which fields are required and which must remain empty.
Used as response type in: services.AccountBudgetProposalService.GetAccountBudgetProposal
Used as field type in: ,
string resource_name = 1
The resource name of the proposal. AccountBudgetProposal resource names have the form: `customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}`
optional id = 14
The ID of the proposal.
optional billing_setup = 2
The resource name of the billing setup associated with this proposal.
optional account_budget = 3
The resource name of the account-level budget associated with this proposal.
enums.AccountBudgetProposalTypeEnum.AccountBudgetProposalType proposal_type = 4
The type of this proposal, e.g. END to end the budget associated with this proposal.
enums.AccountBudgetProposalStatusEnum.AccountBudgetProposalStatus status = 15
The status of this proposal. When a new proposal is created, the status defaults to PENDING.
optional proposed_name = 5
The name to assign to the account-level budget.
optional approved_start_date_time = 20
The approved start date time in yyyy-mm-dd hh:mm:ss format.
optional proposed_purchase_order_number = 12
A purchase order number is a value that enables the user to help them reference this budget in their monthly invoices.
optional proposed_notes = 13
Notes associated with this budget.
optional creation_date_time = 16
The date time when this account-level budget proposal was created, which is not the same as its approval date time, if applicable.
optional approval_date_time = 17
The date time when this account-level budget was approved, if applicable.
oneof proposed_start_time
The proposed start date time of the account-level budget, which cannot be in the past.
proposed_start_date_time = 18
The proposed start date time in yyyy-mm-dd hh:mm:ss format.
enums.TimeTypeEnum.TimeType proposed_start_time_type = 7
The proposed start date time as a well-defined type, e.g. NOW.
oneof proposed_end_time
The proposed end date time of the account-level budget, which cannot be in the past.
proposed_end_date_time = 19
The proposed end date time in yyyy-mm-dd hh:mm:ss format.
enums.TimeTypeEnum.TimeType proposed_end_time_type = 9
The proposed end date time as a well-defined type, e.g. FOREVER.
oneof approved_end_time
The approved end date time of the account-level budget.
approved_end_date_time = 21
The approved end date time in yyyy-mm-dd hh:mm:ss format.
enums.TimeTypeEnum.TimeType approved_end_time_type = 22
The approved end date time as a well-defined type, e.g. FOREVER.
oneof proposed_spending_limit
The proposed spending limit.
proposed_spending_limit_micros = 10
The proposed spending limit in micros. One million is equivalent to one unit.
enums.SpendingLimitTypeEnum.SpendingLimitType proposed_spending_limit_type = 11
The proposed spending limit as a well-defined type, e.g. INFINITE.
oneof approved_spending_limit
The approved spending limit.
approved_spending_limit_micros = 23
The approved spending limit in micros. One million is equivalent to one unit.
enums.SpendingLimitTypeEnum.SpendingLimitType approved_spending_limit_type = 24
The approved spending limit as a well-defined type, e.g. INFINITE.
message
ad.proto:36An ad.
Used in: , ,
optional id = 1
The ID of the ad.
repeated final_urls = 2
The list of possible final URLs after all cross-domain redirects for the ad.
repeated final_mobile_urls = 16
The list of possible final mobile URLs after all cross-domain redirects for the ad.
optional tracking_url_template = 12
The URL template for constructing a tracking URL.
repeated url_custom_parameters = 10
The list of mappings that can be used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
optional display_url = 4
The URL that appears in the ad description for some ad formats.
enums.AdTypeEnum.AdType type = 5
The type of ad.
optional added_by_google_ads = 19
Indicates if this ad was automatically added by Google Ads and not by a user. For example, this could happen when ads are automatically created as suggestions for new ads based on knowledge of how existing ads are performing.
enums.DeviceEnum.Device device_preference = 20
The device preference for the ad. You can only specify a preference for mobile devices. When this preference is set the ad will be preferred over other ads when being displayed on a mobile device. The ad can still be displayed on other device types, e.g. if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types.
optional name = 23
The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad.
oneof ad_data
Details pertinent to the ad type. Exactly one value must be set.
text_ad = 6
Details pertaining to a text ad.
expanded_text_ad = 7
Details pertaining to an expanded text ad.
dynamic_search_ad = 8
Details pertaining to a Dynamic Search Ad.
responsive_display_ad = 9
Details pertaining to a responsive display ad.
call_only_ad = 13
Details pertaining to a call-only ad.
expanded_dynamic_search_ad = 14
Details pertaining to an Expanded Dynamic Search Ad. This type of ad has its headline, final URLs, and display URL auto-generated at serving time according to domain name specific information provided by `dynamic_search_ads_setting` linked at the campaign level.
hotel_ad = 15
Details pertaining to a hotel ad.
shopping_smart_ad = 17
Details pertaining to a Smart Shopping ad.
shopping_product_ad = 18
Details pertaining to a Shopping product ad.
gmail_ad = 21
Details pertaining to a Gmail ad.
image_ad = 22
Details pertaining to an Image ad.
message
ad_group.proto:38An ad group.
Used as response type in: services.AdGroupService.GetAdGroup
Used as field type in: ,
string resource_name = 1
The resource name of the ad group. Ad group resource names have the form: `customers/{customer_id}/adGroups/{ad_group_id}`
optional id = 3
The ID of the ad group.
optional name = 4
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.
enums.AdGroupStatusEnum.AdGroupStatus status = 5
The status of the ad group.
enums.AdGroupTypeEnum.AdGroupType type = 12
The type of the ad group.
enums.AdGroupAdRotationModeEnum.AdGroupAdRotationMode ad_rotation_mode = 22
The ad rotation mode of the ad group.
optional tracking_url_template = 13
The URL template for constructing a tracking URL.
repeated url_custom_parameters = 6
The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
optional campaign = 10
The campaign to which the ad group belongs.
optional cpc_bid_micros = 14
The maximum CPC (cost-per-click) bid.
optional cpm_bid_micros = 15
The maximum CPM (cost-per-thousand viewable impressions) bid.
optional cpa_bid_micros = 16
The target cost-per-acquisition (conversion) bid.
optional cpv_bid_micros = 17
The CPV (cost-per-view) bid.
optional target_roas_override = 19
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.
optional percent_cpc_bid_micros = 20
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].
optional explorer_auto_optimizer_setting = 21
Settings for the Display Campaign Optimizer, initially termed "Explorer".
enums.TargetingDimensionEnum.TargetingDimension display_custom_bid_dimension = 23
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.
optional final_url_suffix = 24
URL template for appending params to Final URL.
message
ad_group_ad.proto:37An ad group ad.
Used as response type in: services.AdGroupAdService.GetAdGroupAd
Used as field type in: ,
string resource_name = 1
The resource name of the ad. Ad group ad resource names have the form: `customers/{customer_id}/adGroupAds/{ad_group_id}_{ad_id}`
enums.AdGroupAdStatusEnum.AdGroupAdStatus status = 3
The status of the ad.
optional ad_group = 4
The ad group to which the ad belongs.
optional ad = 5
The ad.
optional policy_summary = 6
Policy information for the ad.
message
ad_group_ad.proto:58Contains policy information for an ad.
Used in:
repeated policy_topic_entries = 1
The list of policy findings for this ad.
enums.PolicyReviewStatusEnum.PolicyReviewStatus review_status = 2
Where in the review process this ad is.
enums.PolicyApprovalStatusEnum.PolicyApprovalStatus approval_status = 3
The overall approval status of this ad, calculated based on the status of its individual policy topic entries.
message
ad_group_audience_view.proto:33An ad group audience view. Includes performance data from interests and remarketing lists for Display Network and YouTube Network ads, and remarketing lists for search ads (RLSA), aggregated at the audience level.
Used as response type in: services.AdGroupAudienceViewService.GetAdGroupAudienceView
Used as field type in:
string resource_name = 1
The resource name of the ad group audience view. Ad group audience view resource names have the form: `customers/{customer_id}/adGroupAudienceViews/{ad_group_id}_{criterion_id}`
message
ad_group_bid_modifier.proto:34Represents an ad group bid modifier.
Used as response type in: services.AdGroupBidModifierService.GetAdGroupBidModifier
Used as field type in: ,
string resource_name = 1
The resource name of the ad group bid modifier. Ad group bid modifier resource names have the form: `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}_{criterion_id}`
optional ad_group = 2
The ad group to which this criterion belongs.
optional criterion_id = 3
The ID of the criterion to bid modify. This field is ignored for mutates.
optional bid_modifier = 4
The modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. The range is 1.0 - 6.0 for PreferredContent. Use 0 to opt out of a Device type.
optional base_ad_group = 9
The base ad group from which this draft/trial adgroup bid modifier was created. If ad_group is a base ad group then this field will be equal to ad_group. If the ad group was created in the draft or trial and has no corresponding base ad group, then this field will be null. This field is readonly.
enums.BidModifierSourceEnum.BidModifierSource bid_modifier_source = 10
Bid modifier source.
oneof criterion
The criterion of this ad group bid modifier.
hotel_date_selection_type = 5
Criterion for hotel date selection (default dates vs. user selected).
hotel_advance_booking_window = 6
Criterion for number of days prior to the stay the booking is being made.
hotel_length_of_stay = 7
Criterion for length of hotel stay in nights.
hotel_check_in_day = 8
Criterion for day of the week the booking is for.
device = 11
A device criterion.
preferred_content = 12
A preferred content criterion.
message
ad_group_criterion.proto:38An ad group criterion.
Used as response type in: services.AdGroupCriterionService.GetAdGroupCriterion
Used as field type in: ,
string resource_name = 1
The resource name of the ad group criterion. Ad group criterion resource names have the form: `customers/{customer_id}/adGroupCriteria/{ad_group_id}_{criterion_id}`
optional criterion_id = 26
The ID of the criterion. This field is ignored for mutates.
enums.AdGroupCriterionStatusEnum.AdGroupCriterionStatus status = 3
The status of the criterion.
optional quality_info = 4
Information regarding the quality of the criterion.
optional ad_group = 5
The ad group to which the criterion belongs.
enums.CriterionTypeEnum.CriterionType type = 25
The type of the criterion.
optional negative = 31
Whether to target (`false`) or exclude (`true`) the criterion. This field is immutable. To switch a criterion from positive to negative, remove then re-add it.
optional bid_modifier = 44
The modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
optional cpc_bid_micros = 16
The CPC (cost-per-click) bid.
optional cpm_bid_micros = 17
The CPM (cost-per-thousand viewable impressions) bid.
optional cpv_bid_micros = 24
The CPV (cost-per-view) bid.
optional percent_cpc_bid_micros = 33
The 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].
optional effective_cpc_bid_micros = 18
The effective CPC (cost-per-click) bid.
optional effective_cpm_bid_micros = 19
The effective CPM (cost-per-thousand viewable impressions) bid.
optional effective_cpv_bid_micros = 20
The effective CPV (cost-per-view) bid.
optional effective_percent_cpc_bid_micros = 34
The effective Percent CPC bid amount.
enums.BiddingSourceEnum.BiddingSource effective_cpc_bid_source = 21
Source of the effective CPC bid.
enums.BiddingSourceEnum.BiddingSource effective_cpm_bid_source = 22
Source of the effective CPM bid.
enums.BiddingSourceEnum.BiddingSource effective_cpv_bid_source = 23
Source of the effective CPV bid.
enums.BiddingSourceEnum.BiddingSource effective_percent_cpc_bid_source = 35
Source of the effective Percent CPC bid.
optional position_estimates = 10
Estimates for criterion bids at various positions.
repeated final_urls = 11
The list of possible final URLs after all cross-domain redirects for the ad.
optional tracking_url_template = 13
The URL template for constructing a tracking URL.
repeated url_custom_parameters = 14
The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
oneof criterion
The ad group criterion. Exactly one must be set.
keyword = 27
Keyword.
placement = 28
Placement.
listing_group = 32
Listing group.
age_range = 36
Age range.
gender = 37
Gender.
income_range = 38
Income range.
parental_status = 39
Parental status.
user_list = 42
User List.
youtube_video = 40
YouTube Video.
youtube_channel = 41
YouTube Channel.
topic = 43
Topic.
user_interest = 45
User Interest.
message
ad_group_criterion.proto:58Estimates for criterion bids at various positions.
Used in:
optional first_page_cpc_micros = 1
The estimate of the CPC bid required for ad to be shown on first page of search results.
optional first_position_cpc_micros = 2
The estimate of the CPC bid required for ad to be displayed in first position, at the top of the first page of search results.
optional top_of_page_cpc_micros = 3
The estimate of the CPC bid required for ad to be displayed at the top of the first page of search results.
message
ad_group_criterion.proto:40A container for ad group criterion quality information.
Used in:
optional quality_score = 1
The quality score. This field may not be populated if Google does not have enough information to determine a value.
enums.QualityScoreBucketEnum.QualityScoreBucket creative_quality_score = 2
The performance of the ad compared to other advertisers.
enums.QualityScoreBucketEnum.QualityScoreBucket post_click_quality_score = 3
The quality score of the landing page.
enums.QualityScoreBucketEnum.QualityScoreBucket search_predicted_ctr = 4
The click-through rate compared to that of other advertisers.
message
ad_group_feed.proto:35An ad group feed.
Used as response type in: services.AdGroupFeedService.GetAdGroupFeed
Used as field type in: ,
string resource_name = 1
The resource name of the ad group feed. Ad group feed resource names have the form: `customers/{customer_id}/adGroupFeeds/{ad_group_id}_{feed_id}
optional feed = 2
The feed being linked to the ad group.
optional ad_group = 3
The ad group being linked to the feed.
repeated enums.PlaceholderTypeEnum.PlaceholderType placeholder_types = 4
Indicates which placeholder types the feed may populate under the connected ad group. Required.
optional matching_function = 5
Matching function associated with the AdGroupFeed. The matching function is used to filter the set of feed items selected. Required.
enums.FeedLinkStatusEnum.FeedLinkStatus status = 6
Status of the ad group feed. This field is read-only.
message
age_range_view.proto:30An age range view.
Used as response type in: services.AgeRangeViewService.GetAgeRangeView
Used as field type in:
string resource_name = 1
The resource name of the age range view. Age range view resource names have the form: `customers/{customer_id}/ageRangeViews/{ad_group_id}_{criterion_id}`
message
feed_mapping.proto:87Maps from feed attribute id to a placeholder or criterion field id.
Used in:
optional feed_attribute_id = 1
Feed attribute from which to map.
optional field_id = 2
The placeholder field ID. If a placeholder field enum is not published in the current API version, then this field will be populated and the field oneof will be empty. This field is read-only.
oneof field
Placeholder or criterion field to be populated using data from the above feed attribute. Required.
enums.SitelinkPlaceholderFieldEnum.SitelinkPlaceholderField sitelink_field = 3
Sitelink Placeholder Fields.
enums.CallPlaceholderFieldEnum.CallPlaceholderField call_field = 4
Call Placeholder Fields.
enums.AppPlaceholderFieldEnum.AppPlaceholderField app_field = 5
App Placeholder Fields.
enums.CalloutPlaceholderFieldEnum.CalloutPlaceholderField callout_field = 8
Callout Placeholder Fields.
enums.StructuredSnippetPlaceholderFieldEnum.StructuredSnippetPlaceholderField structured_snippet_field = 9
Structured Snippet Placeholder Fields.
enums.MessagePlaceholderFieldEnum.MessagePlaceholderField message_field = 10
Message Placeholder Fields.
enums.PricePlaceholderFieldEnum.PricePlaceholderField price_field = 11
Price Placeholder Fields.
enums.PromotionPlaceholderFieldEnum.PromotionPlaceholderField promotion_field = 12
Promotion Placeholder Fields.
enums.AdCustomizerPlaceholderFieldEnum.AdCustomizerPlaceholderField ad_customizer_field = 13
Ad Customizer Placeholder Fields
enums.EducationPlaceholderFieldEnum.EducationPlaceholderField education_field = 16
Education Placeholder Fields
enums.FlightPlaceholderFieldEnum.FlightPlaceholderField flight_field = 17
Flight Placeholder Fields
enums.CustomPlaceholderFieldEnum.CustomPlaceholderField custom_field = 18
Custom Placeholder Fields
enums.HotelPlaceholderFieldEnum.HotelPlaceholderField hotel_field = 19
Hotel Placeholder Fields
enums.RealEstatePlaceholderFieldEnum.RealEstatePlaceholderField real_estate_field = 20
Real Estate Placeholder Fields
enums.TravelPlaceholderFieldEnum.TravelPlaceholderField travel_field = 21
Travel Placeholder Fields
enums.LocalPlaceholderFieldEnum.LocalPlaceholderField local_field = 22
Local Placeholder Fields
enums.JobPlaceholderFieldEnum.JobPlaceholderField job_field = 23
Job Placeholder Fields
message
bidding_strategy.proto:34A bidding strategy.
Used as response type in: services.BiddingStrategyService.GetBiddingStrategy
Used as field type in: ,
string resource_name = 1
The resource name of the bidding strategy. Bidding strategy resource names have the form: `customers/{customer_id}/biddingStrategies/{bidding_strategy_id}`
optional id = 3
The ID of the bidding strategy.
optional name = 4
The name of the bidding strategy. All bidding strategies within an account must be named distinctly. The length of this string should be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
enums.BiddingStrategyTypeEnum.BiddingStrategyType type = 5
The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only.
oneof scheme
The bidding scheme. Only one can be set.
enhanced_cpc = 7
A bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely.
page_one_promoted = 8
A bidding strategy that sets max CPC bids to target impressions on page one or page one promoted slots on google.com.
target_cpa = 9
A bidding strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
target_outrank_share = 10
A bidding strategy that sets bids based on the target fraction of auctions where the advertiser should outrank a specific competitor.
target_roas = 11
A bidding strategy that helps you maximize revenue while averaging a specific target Return On Ad Spend (ROAS).
target_spend = 12
A bid strategy that sets your bids to help get as many clicks as possible within your budget.
message
billing_setup.proto:36A billing setup across Ads and Payments systems; an association between a Payments account and an advertiser. A billing setup is specific to one advertiser.
Used as response type in: services.BillingSetupService.GetBillingSetup
Used as field type in: ,
string resource_name = 1
The resource name of the billing setup. BillingSetup resource names have the form: `customers/{customer_id}/billingSetups/{billing_setup_id}`
optional id = 2
The ID of the billing setup.
enums.BillingSetupStatusEnum.BillingSetupStatus status = 3
The status of the billing setup.
optional payments_account = 11
The resource name of the Payments account associated with this billing setup. Payments resource names have the form: `customers/{customer_id}/paymentsAccounts/ {payments_profile_id}_{payments_account_id}` When setting up billing, this is used to signup with an existing Payments account (and then payments_account_info should not be set). When getting a billing setup, this and payments_account_info will be populated.
optional payments_account_info = 12
The Payments account information associated with this billing setup. When setting up billing, this is used to signup with a new Payments account (and then payments_account should not be set). When getting a billing setup, this and payments_account will be populated.
oneof start_time
When creating a new billing setup, this is when the setup should take effect. NOW is the only acceptable start time if the customer doesn't have any approved setups. When fetching an existing billing setup, this is the requested start time. However, if the setup was approved (see status) after the requested start time, then this is the approval time.
start_date_time = 9
The start date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format. Only a future time is allowed.
enums.TimeTypeEnum.TimeType start_time_type = 10
The start time as a type. Only NOW is allowed.
oneof end_time
When the billing setup ends / ended. This is either FOREVER or the start time of the next scheduled billing setup.
end_date_time = 13
The end date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format.
enums.TimeTypeEnum.TimeType end_time_type = 14
The end time as a type. The only possible value is FOREVER.
message
billing_setup.proto:38Container of Payments account information for this billing.
Used in:
optional payments_account_id = 1
A 16 digit id used to identify the Payments account associated with the billing setup. This must be passed as a string with dashes, e.g. "1234-5678-9012-3456".
optional payments_account_name = 2
The name of the Payments account associated with the billing setup. This enables the user to specify a meaningful name for a Payments account to aid in reconciling monthly invoices. This name will be printed in the monthly invoices.
optional payments_profile_id = 3
A 12 digit id used to identify the Payments profile associated with the billing setup. This must be passed in as a string with dashes, e.g. "1234-5678-9012".
optional payments_profile_name = 4
The name of the Payments profile associated with the billing setup.
optional secondary_payments_profile_id = 5
A secondary payments profile id present in uncommon situations, e.g. when a sequential liability agreement has been arranged.
message
customer.proto:72Call reporting setting for a customer.
Used in:
optional call_reporting_enabled = 1
Enable reporting of phone call events by redirecting them via Google System.
optional call_conversion_reporting_enabled = 2
Whether to enable call conversion reporting.
optional call_conversion_action = 9
Customer-level call conversion action to attribute a call conversion to. If not set a default conversion action is used. Only in effect when call_conversion_reporting_enabled is set to true.
message
campaign.proto:42A campaign.
Used as response type in: services.CampaignService.GetCampaign
Used as field type in: ,
string resource_name = 1
The resource name of the campaign. Campaign resource names have the form: `customers/{customer_id}/campaigns/{campaign_id}`
optional id = 3
The ID of the campaign.
optional name = 4
The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
enums.CampaignStatusEnum.CampaignStatus status = 5
The status of the campaign. When a new campaign is added, the status defaults to ENABLED.
enums.CampaignServingStatusEnum.CampaignServingStatus serving_status = 21
The ad serving status of the campaign.
enums.AdServingOptimizationStatusEnum.AdServingOptimizationStatus ad_serving_optimization_status = 8
The ad serving optimization status of the campaign.
enums.AdvertisingChannelTypeEnum.AdvertisingChannelType advertising_channel_type = 9
The primary serving target for ads within the campaign. The targeting options can be refined in `network_settings`. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed.
enums.AdvertisingChannelSubTypeEnum.AdvertisingChannelSubType advertising_channel_sub_type = 10
Optional refinement to `advertising_channel_type`. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed.
optional tracking_url_template = 11
The URL template for constructing a tracking URL.
repeated url_custom_parameters = 12
The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
optional real_time_bidding_setting = 39
Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network.
optional network_settings = 14
The network settings for the campaign.
optional hotel_setting = 32
The hotel setting for the campaign.
optional dynamic_search_ads_setting = 33
The setting for controlling Dynamic Search Ads (DSA).
optional shopping_setting = 36
The setting for controlling Shopping campaigns.
optional campaign_budget = 6
The budget of the campaign.
enums.BiddingStrategyTypeEnum.BiddingStrategyType bidding_strategy_type = 22
The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the `bidding_strategy` field to create a portfolio bidding strategy. This field is read-only.
optional start_date = 19
The date when campaign started. This field must not be used in WHERE clauses.
optional campaign_group = 35
The campaign group this campaign belongs to.
optional end_date = 20
The date when campaign ended. This field must not be used in WHERE clauses.
optional final_url_suffix = 38
Suffix used to append query parameters to landing pages that are served with parallel tracking.
repeated frequency_caps = 40
A list that limits how often each user will see this campaign's ads.
oneof campaign_bidding_strategy
The bidding strategy for the campaign. Must be either portfolio (created via BiddingStrategy service) or standard, that is embedded into the campaign.
bidding_strategy = 23
Portfolio bidding strategy used by campaign.
manual_cpc = 24
Standard Manual CPC bidding strategy. Manual click-based bidding where user pays per click.
manual_cpm = 25
Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
manual_cpv = 37
A bidding strategy that pays a configurable amount per video view.
maximize_conversions = 30
Standard Maximize Conversions bidding strategy that automatically maximizes number of conversions given a daily budget.
maximize_conversion_value = 31
Standard Maximize Conversion Value bidding strategy that automatically sets bids to maximize revenue while spending your budget.
target_cpa = 26
Standard Target CPA bidding strategy that automatically sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
target_roas = 29
Standard Target ROAS bidding strategy that automatically maximizes revenue while averaging a specific target return on ad spend (ROAS).
target_spend = 27
Standard Target Spend bidding strategy that automatically sets your bids to help get as many clicks as possible within your budget.
percent_cpc = 34
Standard Percent Cpc bidding strategy where bids are a fraction of the advertised price for some good or service.
message
campaign.proto:68The setting for controlling Dynamic Search Ads (DSA).
Used in:
optional domain_name = 1
The Internet domain name that this setting represents, e.g., "google.com" or "www.google.com".
optional language_code = 2
The language code specifying the language of the domain, e.g., "en".
optional use_supplied_urls_only = 3
Whether the campaign uses advertiser supplied URLs exclusively.
repeated feed_ids = 4
The list of page feeds associated with the campaign.
message
campaign.proto:62Campaign-level settings for hotel ads.
Used in:
optional hotel_center_id = 1
The linked Hotel Center account.
message
campaign.proto:44The network settings for the campaign.
Used in:
optional target_google_search = 1
Whether ads will be served with google.com search results.
optional target_search_network = 2
Whether ads will be served on partner sites in the Google Search Network (requires `target_google_search` to also be `true`).
optional target_content_network = 3
Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
optional target_partner_search_network = 4
Whether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.
message
campaign.proto:86The setting for Shopping campaigns. Defines the universe of products that can be advertised by the campaign, and how this campaign interacts with other Shopping campaigns.
Used in:
optional merchant_id = 1
ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
optional sales_country = 2
Sales country of products to include in the campaign. This field is required for Shopping campaigns. This field is immutable. This field is optional for non-Shopping campaigns, but it must be equal to 'ZZ' if set.
optional campaign_priority = 3
Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set.
optional enable_local = 4
Enable local inventory ads. This field is ignored for Smart Shopping campaigns.
message
campaign_audience_view.proto:34A campaign audience view. Includes performance data from interests and remarketing lists for Display Network and YouTube Network ads, and remarketing lists for search ads (RLSA), aggregated by campaign and audience criterion. This view only includes audiences attached at the campaign level.
Used as response type in: services.CampaignAudienceViewService.GetCampaignAudienceView
Used as field type in:
string resource_name = 1
The resource name of the campaign audience view. Campaign audience view resource names have the form: `customers/{customer_id}/campaignAudienceViews/{campaign_id}_{criterion_id}`
message
campaign_bid_modifier.proto:33Represents a bid-modifiable only criterion at the campaign level.
Used as response type in: services.CampaignBidModifierService.GetCampaignBidModifier
Used as field type in: ,
string resource_name = 1
The resource name of the campaign bid modifier. Campaign bid modifier resource names have the form: `customers/{customer_id}/campaignBidModifiers/{campaign_id}_{criterion_id}`
optional campaign = 2
The campaign to which this criterion belongs.
optional criterion_id = 3
The ID of the criterion to bid modify. This field is ignored for mutates.
optional bid_modifier = 4
The modifier for the bid when the criterion matches.
oneof criterion
The criterion of this campaign bid modifier.
interaction_type = 5
Criterion for interaction type. Only supported for search campaigns.
message
campaign_budget.proto:34A campaign budget.
Used as response type in: services.CampaignBudgetService.GetCampaignBudget
Used as field type in: ,
string resource_name = 1
The resource name of the campaign budget. Campaign budget resource names have the form: `customers/{customer_id}/campaignBudgets/{budget_id}`
optional id = 3
The ID of the campaign budget. A campaign budget is created using the CampaignBudgetService create operation and is assigned a budget ID. A budget ID can be shared across different campaigns; the system will then allocate the campaign budget among different campaigns to get optimum results.
optional name = 4
The name of the campaign budget. When creating a campaign budget through CampaignBudgetService, every explicitly shared campaign budget must have a non-null, non-empty name. Campaign budgets that are not explicitly shared derive their name from the attached campaign's name. The length of this string must be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
optional amount_micros = 5
The amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit.
optional total_amount_micros = 10
The lifetime amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit.
enums.BudgetStatusEnum.BudgetStatus status = 6
The status of this campaign budget. This field is read-only.
enums.BudgetDeliveryMethodEnum.BudgetDeliveryMethod delivery_method = 7
The delivery method that determines the rate at which the campaign budget is spent. Defaults to STANDARD if unspecified in a create operation.
optional explicitly_shared = 8
Whether the budget is explicitly shared. This field is set to false by default. If true, the budget was created with the purpose of sharing across one or more campaigns. If false, the budget was created with the intention of only being used with a single campaign. The budget's name and status will stay in sync with the campaign's name and status. Attempting to share the budget with a second campaign will result in an error. A non-shared budget can become an explicitly shared. The same operation must also assign the budget a name. A shared campaign budget can never become non-shared.
optional reference_count = 9
The number of campaigns actively using the budget. This field is read-only.
message
campaign_criterion.proto:34A campaign criterion.
Used as response type in: services.CampaignCriterionService.GetCampaignCriterion
Used as field type in: ,
string resource_name = 1
The resource name of the campaign criterion. Campaign criterion resource names have the form: `customers/{customer_id}/campaignCriteria/{campaign_id}_{criterion_id}`
optional campaign = 4
The campaign to which the criterion belongs.
optional criterion_id = 5
The ID of the criterion. This field is ignored during mutate.
optional bid_modifier = 14
The modifier for the bids when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. Use 0 to opt out of a Device type.
optional negative = 7
Whether to target (`false`) or exclude (`true`) the criterion.
enums.CriterionTypeEnum.CriterionType type = 6
The type of the criterion.
oneof criterion
The campaign criterion. Exactly one must be set.
keyword = 8
Keyword.
placement = 9
Placement.
location = 12
Location.
device = 13
Device.
ad_schedule = 15
Ad Schedule.
age_range = 16
Age range.
gender = 17
Gender.
income_range = 18
Income range.
parental_status = 19
Parental status.
user_list = 22
User List.
youtube_video = 20
YouTube Video.
youtube_channel = 21
YouTube Channel.
proximity = 23
Proximity.
topic = 24
Topic.
listing_scope = 25
Listing scope.
language = 26
Language.
ip_block = 27
IpBlock.
content_label = 28
ContentLabel.
carrier = 29
Carrier.
user_interest = 30
User Interest.
message
campaign_feed.proto:35A campaign feed.
Used as response type in: services.CampaignFeedService.GetCampaignFeed
Used as field type in: ,
string resource_name = 1
The resource name of the campaign feed. Campaign feed resource names have the form: `customers/{customer_id}/campaignFeeds/{campaign_id}_{feed_id}
optional feed = 2
The feed to which the CampaignFeed belongs.
optional campaign = 3
The campaign to which the CampaignFeed belongs.
repeated enums.PlaceholderTypeEnum.PlaceholderType placeholder_types = 4
Indicates which placeholder types the feed may populate under the connected campaign. Required.
optional matching_function = 5
Matching function associated with the CampaignFeed. The matching function is used to filter the set of feed items selected. Required.
enums.FeedLinkStatusEnum.FeedLinkStatus status = 6
Status of the campaign feed. This field is read-only.
message
campaign_group.proto:33A campaign group.
Used as response type in: services.CampaignGroupService.GetCampaignGroup
Used as field type in: ,
string resource_name = 1
The resource name of the campaign group. Campaign group resource names have the form: `customers/{customer_id}/campaignGroups/{campaign_group_id}`
optional id = 3
The ID of the campaign group.
optional name = 4
The name of the campaign group. This field is required and should not be empty when creating new campaign groups. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
enums.CampaignGroupStatusEnum.CampaignGroupStatus status = 5
The status of the campaign group. When a new campaign group is added, the status defaults to ENABLED.
CampaignSharedSets are used for managing the shared sets associated with a campaign.
Used as response type in: services.CampaignSharedSetService.GetCampaignSharedSet
Used as field type in: ,
string resource_name = 1
The resource name of the campaign shared set. Campaign shared set resource names have the form: `customers/{customer_id}/campaignSharedSets/{campaign_id}_{shared_set_id}`
optional campaign = 3
The campaign to which the campaign shared set belongs.
optional shared_set = 4
The shared set associated with the campaign. This may be a negative keyword shared set of another customer. This customer should be a manager of the other customer, otherwise the campaign shared set will exist but have no serving effect. Only negative keyword shared sets can be associated with Shopping campaigns. Only negative placement shared sets can be associated with Display mobile app campaigns.
enums.CampaignSharedSetStatusEnum.CampaignSharedSetStatus status = 2
The status of this campaign shared set. Read only.
message
carrier_constant.proto:32A carrier criterion that can be used in campaign targeting.
Used as response type in: services.CarrierConstantService.GetCarrierConstant
Used as field type in:
string resource_name = 1
The resource name of the carrier criterion. Carrier criterion resource names have the form: `carrierConstants/{criterion_id}`
optional id = 2
The ID of the carrier criterion.
optional name = 3
The full name of the carrier in English.
optional country_code = 4
The country code of the country where the carrier is located, e.g., "AR", "FR", etc.
message
change_status.proto:34Describes the status of returned resource.
Used as response type in: services.ChangeStatusService.GetChangeStatus
Used as field type in:
string resource_name = 1
The resource name of the change status. Change status resource names have the form: `customers/{customer_id}/changeStatus/{change_status_id}`
optional last_change_date_time = 3
Time at which the most recent change has occurred on this resource.
enums.ChangeStatusResourceTypeEnum.ChangeStatusResourceType resource_type = 4
Represents the type of the changed resource. This dictates what fields will be set. For example, for AD_GROUP, campaign and ad_group fields will be set.
optional campaign = 5
The Campaign affected by this change.
optional ad_group = 6
The AdGroup affected by this change.
enums.ChangeStatusOperationEnum.ChangeStatusOperation resource_status = 8
Represents the status of the changed resource.
optional ad_group_ad = 9
The AdGroupAd affected by this change.
optional ad_group_criterion = 10
The AdGroupCriterion affected by this change.
optional campaign_criterion = 11
The CampaignCriterion affected by this change.
message
conversion_action.proto:39A conversion action.
Used as response type in: services.ConversionActionService.GetConversionAction
Used as field type in:
string resource_name = 1
The resource name of the conversion action. Conversion action resource names have the form: `customers/{customer_id}/conversionActions/{conversion_action_id}`
optional id = 2
The ID of the conversion action.
optional name = 3
The name of the conversion action. This field is required and should not be empty when creating new conversion actions.
enums.ConversionActionStatusEnum.ConversionActionStatus status = 4
The status of this conversion action for conversion event accrual.
enums.ConversionActionTypeEnum.ConversionActionType type = 5
The type of this conversion action.
enums.ConversionActionCategoryEnum.ConversionActionCategory category = 6
The category of conversions reported for this conversion action.
optional owner_customer = 7
The resource name of the conversion action owner customer, or null if this is a system-defined conversion action.
optional include_in_conversions_metric = 8
Whether this conversion action should be included in the "conversions" metric.
optional click_through_lookback_window_days = 9
The maximum number of days that may elapse between an interaction (e.g., a click) and a conversion event.
optional view_through_lookback_window_days = 10
The maximum number of days which may elapse between an impression and a conversion without an interaction.
optional value_settings = 11
Settings related to the value for conversion events associated with this conversion action.
enums.ConversionActionCountingTypeEnum.ConversionActionCountingType counting_type = 12
How to count conversion events for the conversion action.
optional attribution_model_settings = 13
Settings related to this conversion action's attribution model.
repeated tag_snippets = 14
The snippets used for tracking conversions.
optional phone_call_duration_seconds = 15
The phone call duration in seconds after which a conversion should be reported for this conversion action. The value must be between 0 and 10000, inclusive.
optional app_id = 16
App ID for an app conversion action.
message
conversion_action.proto:41Settings related to this conversion action's attribution model.
Used in:
enums.AttributionModelEnum.AttributionModel attribution_model = 1
The attribution model type of this conversion action.
enums.DataDrivenModelStatusEnum.DataDrivenModelStatus data_driven_model_status = 2
The status of the data-driven attribution model for the conversion action.
message
conversion_action.proto:52Settings related to the value for conversion events associated with this conversion action.
Used in:
optional default_value = 1
The value to use when conversion events for this conversion action are sent with an invalid, disallowed or missing value, or when this conversion action is configured to always use the default value.
optional default_currency_code = 2
The currency code to use when conversion events for this conversion action are sent with an invalid or missing currency code, or when this conversion action is configured to always use the default value.
optional always_use_default_value = 3
Controls whether the default value and default currency code are used in place of the value and currency code specified in conversion events for this conversion action.
message
customer.proto:32A customer.
Used as response type in: services.CustomerService.GetCustomer
Used as field type in: , ,
string resource_name = 1
The resource name of the customer. Customer resource names have the form: `customers/{customer_id}`
optional id = 3
The ID of the customer.
optional descriptive_name = 4
Optional, non-unique descriptive name of the customer.
optional currency_code = 5
The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
optional time_zone = 6
The local timezone ID of the customer.
optional tracking_url_template = 7
The URL template for constructing a tracking URL out of parameters.
optional final_url_suffix = 11
The URL template for appending params to the final URL
optional auto_tagging_enabled = 8
Whether auto-tagging is enabled for the customer.
optional has_partners_badge = 9
Whether the Customer has a Partners program badge. If the Customer is not associated with the Partners program, this will be false. For more information, see https://support.google.com/partners/answer/3125774.
optional call_reporting_setting = 10
Call reporting setting for a customer.
message
customer_client.proto:32For a manager, it returns all the customers in its hierarchy and self.
Used as response type in: services.CustomerClientService.GetCustomerClient
Used as field type in:
string resource_name = 1
The resource name of the customer client. CustomerClient resource names have the form: `customers/{customer_id}/customerClients/{client_customer_id}`
optional client_customer = 3
The client customer linked to this customer. Read only.
optional hidden = 4
Whether the client is hidden or not. Default value is false. Read only.
optional level = 5
Distance between customer and client. For self link, the level value will be 0. Read only.
message
customer_client_link.proto:33Represents customer client link relationship.
Used as response type in: services.CustomerClientLinkService.GetCustomerClientLink
Used as field type in:
string resource_name = 1
Name of the resource. CustomerClientLink resource names have the form: `customers/{customer_id}/customerClientLinks/{client_customer_id}_{manager_link_id}`
optional client_customer = 3
The client customer linked to this customer. Read only.
optional manager_link_id = 4
This is uniquely identifies a customer client link. Read only.
enums.ManagerLinkStatusEnum.ManagerLinkStatus status = 5
This is the status of the link between client and manager.
optional hidden = 6
The visibility of the link. Users can choose whether or not to see hidden links in the AdWords UI. Default value is false
message
customer_feed.proto:35A customer feed.
Used as response type in: services.CustomerFeedService.GetCustomerFeed
Used as field type in: ,
string resource_name = 1
The resource name of the customer feed. Customer feed resource names have the form: `customers/{customer_id}/customerFeeds/{feed_id}`
optional feed = 2
The feed being linked to the customer.
repeated enums.PlaceholderTypeEnum.PlaceholderType placeholder_types = 3
Indicates which placeholder types the feed may populate under the connected customer. Required.
optional matching_function = 4
Matching function associated with the CustomerFeed. The matching function is used to filter the set of feed items selected. Required.
enums.FeedLinkStatusEnum.FeedLinkStatus status = 5
Status of the customer feed. This field is read-only.
message
customer_manager_link.proto:33Represents customer-manager link relationship.
Used as response type in: services.CustomerManagerLinkService.GetCustomerManagerLink
Used as field type in:
string resource_name = 1
Name of the resource. CustomerManagerLink resource names have the form: `customers/{customer_id}/customerManagerLinks/{manager_customer_id}_{manager_link_id}`
optional manager_customer = 3
The manager customer linked to the customer. This field is read only.
optional manager_link_id = 4
ID of the customer-manager link. This field is read only.
enums.ManagerLinkStatusEnum.ManagerLinkStatus status = 5
Status of the link between the customer and the manager.
message
display_keyword_view.proto:30A display keyword view.
Used as response type in: services.DisplayKeywordViewService.GetDisplayKeywordView
Used as field type in:
string resource_name = 1
The resource name of the display keyword view. Display Keyword view resource names have the form: `customers/{customer_id}/displayKeywordViews/{ad_group_id}_{criterion_id}`
message
feed.proto:36A feed.
Used as response type in: services.FeedService.GetFeed
Used as field type in: ,
string resource_name = 1
The resource name of the feed. Feed resource names have the form: `customers/{customer_id}/feeds/{feed_id}`
optional id = 2
The ID of the feed. This field is read-only.
optional name = 3
Name of the feed. Required.
repeated attributes = 4
The Feed's attributes. Required on CREATE. Disallowed on UPDATE. Use attribute_operations to add new attributes.
repeated attribute_operations = 9
The list of operations changing the feed attributes. Attributes can only be added, not removed.
enums.FeedOriginEnum.FeedOrigin origin = 5
Specifies who manages the FeedAttributes for the Feed.
enums.FeedStatusEnum.FeedStatus status = 8
Status of the feed. This field is read-only.
oneof system_feed_generation_data
The system data for the Feed. This data specifies information for generating the feed items of the system generated feed.
places_location_feed_data = 6
Data used to configure a location feed populated from Google My Business Locations.
affiliate_location_feed_data = 7
Data used to configure an affiliate location feed populated with the specified chains.
message
feed.proto:84Data used to configure an affiliate location feed populated with the specified chains.
Used in:
repeated chain_ids = 1
The list of chains that the affiliate location feed will sync the locations from.
enums.AffiliateLocationFeedRelationshipTypeEnum.AffiliateLocationFeedRelationshipType relationship_type = 2
The relationship the chains have with the advertiser.
message
feed.proto:39Data used to configure a location feed populated from Google My Business Locations.
Used in:
optional oauth_info = 1
Required authentication token (from OAuth API) for the email.
optional email_address = 2
Email address of a Google My Business account or email address of a manager of the Google My Business account. Required.
optional business_account_identifier = 3
Plus page ID of the managed business whose locations should be used. If this field is not set, then all businesses accessible by the user (specified by email_address) are used.
optional business_name_filter = 4
Used to filter Google My Business listings by business name. If business_name_filter is set, only listings with a matching business name are candidates to be sync'd into FeedItems.
repeated category_filters = 5
Used to filter Google My Business listings by categories. If entries exist in category_filters, only listings that belong to any of the categories are candidates to be sync'd into FeedItems. If no entries exist in category_filters, then all listings are candidates for syncing.
repeated label_filters = 6
Used to filter Google My Business listings by labels. If entries exist in label_filters, only listings that has any of the labels set are candidates to be synchronized into FeedItems. If no entries exist in label_filters, then all listings are candidates for syncing.
message
feed.proto:41Data used for authorization using OAuth.
Used in:
optional http_method = 1
The HTTP method used to obtain authorization.
optional http_request_url = 2
The HTTP request URL used to obtain authorization.
optional http_authorization_header = 3
The HTTP authorization header used to obtain authorization.
message
feed.proto:138FeedAttributes define the types of data expected to be present in a Feed. A single FeedAttribute specifies the expected type of the FeedItemAttributes with the same FeedAttributeId. Optionally, a FeedAttribute can be marked as being part of a FeedItem's unique key.
Used in: ,
optional id = 1
ID of the attribute.
optional name = 2
The name of the attribute. Required.
enums.FeedAttributeTypeEnum.FeedAttributeType type = 3
Data type for feed attribute. Required.
optional is_part_of_key = 4
Indicates that data corresponding to this attribute is part of a FeedItem's unique key. It defaults to false if it is unspecified. Note that a unique key is not required in a Feed's schema, in which case the FeedItems must be referenced by their feed_item_id.
message
feed.proto:156Operation to be performed on a feed attribute list in a mutate.
Used in:
FeedAttributeOperation.Operator operator = 1
Type of list operation to perform.
optional value = 2
The feed attribute being added to the list.
The operator.
Used in:
UNSPECIFIED = 0
Unspecified.
UNKNOWN = 1
Used for return value only. Represents value unknown in this version.
ADD = 2
Add the attribute to the existing attributes.
message
feed_item.proto:36A feed item.
Used as response type in: services.FeedItemService.GetFeedItem
Used as field type in: ,
string resource_name = 1
The resource name of the feed item. Feed item resource names have the form: `customers/{customer_id}/feedItems/{feed_id}_{feed_item_id}`
optional feed = 2
The feed to which this feed item belongs.
optional id = 3
The ID of this feed item.
optional start_date_time = 4
Start time in which this feed item is effective and can begin serving. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
optional end_date_time = 5
End time in which this feed item is no longer effective and will stop The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
repeated attribute_values = 6
The feed item's attribute values.
enums.GeoTargetingRestrictionEnum.GeoTargetingRestriction geo_targeting_restriction = 7
Geo targeting restriction specifies the type of location that can be used for targeting.
repeated url_custom_parameters = 8
The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
enums.FeedItemStatusEnum.FeedItemStatus status = 9
Status of the feed item. This field is read-only.
message
feed_item.proto:76A feed item attribute value.
Used in:
optional feed_attribute_id = 1
Id of the feed attribute for which the value is associated with.
optional integer_value = 2
Int64 value. Should be set if feed_attribute_id refers to a feed attribute of type INT64.
optional boolean_value = 3
Bool value. Should be set if feed_attribute_id refers to a feed attribute of type BOOLEAN.
optional string_value = 4
String value. Should be set if feed_attribute_id refers to a feed attribute of type STRING, URL or DATE_TIME. For STRING the maximum length is 1500 characters. For URL the maximum length is 2076 characters. For DATE_TIME the format of the string must be the same as start and end time for the feed item.
optional double_value = 5
Double value. Should be set if feed_attribute_id refers to a feed attribute of type DOUBLE.
optional price_value = 6
Price value. Should be set if feed_attribute_id refers to a feed attribute of type PRICE.
repeated integer_values = 7
Repeated int64 value. Should be set if feed_attribute_id refers to a feed attribute of type INT64_LIST.
repeated boolean_values = 8
Repeated bool value. Should be set if feed_attribute_id refers to a feed attribute of type BOOLEAN_LIST.
repeated string_values = 9
Repeated string value. Should be set if feed_attribute_id refers to a feed attribute of type STRING_LIST, URL_LIST or DATE_TIME_LIST. For STRING_LIST and URL_LIST the total size of the list in bytes may not exceed 3000. For DATE_TIME_LIST the number of elements may not exceed 200. For STRING_LIST the maximum length of each string element is 1500 characters. For URL_LIST the maximum length is 2076 characters. For DATE_TIME the format of the string must be the same as start and end time for the feed item.
repeated double_values = 10
Repeated double value. Should be set if feed_attribute_id refers to a feed attribute of type DOUBLE_LIST.
message
feed_mapping.proto:52A feed mapping.
Used as response type in: services.FeedMappingService.GetFeedMapping
Used as field type in: ,
string resource_name = 1
The resource name of the feed mapping. Feed mapping resource names have the form: `customers/{customer_id}/feedMappings/{feed_id}_{feed_mapping_id}`
optional feed = 2
The feed of this feed mapping.
repeated attribute_field_mappings = 5
Feed attributes to field mappings. These mappings are a one-to-many relationship meaning that 1 feed attribute can be used to populate multiple placeholder fields, but 1 placeholder field can only draw data from 1 feed attribute. Ad Customizer is an exception, 1 placeholder field can be mapped to multiple feed attributes. Required.
enums.FeedMappingStatusEnum.FeedMappingStatus status = 6
Status of the feed mapping. This field is read-only.
oneof target
Feed mapping target. Can be either a placeholder or a criterion. For a given feed, the active FeedMappings must have unique targets. Required.
enums.PlaceholderTypeEnum.PlaceholderType placeholder_type = 3
The placeholder type of this mapping (i.e., if the mapping maps feed attributes to placeholder fields).
enums.FeedMappingCriterionTypeEnum.FeedMappingCriterionType criterion_type = 4
The criterion type of this mapping (i.e., if the mapping maps feed attributes to criterion fields).
message
gender_view.proto:30A gender view.
Used as response type in: services.GenderViewService.GetGenderView
Used as field type in:
string resource_name = 1
The resource name of the gender view. Gender view resource names have the form: `customers/{customer_id}/genderViews/{ad_group_id}_{criterion_id}`
message
geo_target_constant.proto:33A geo target constant.
Used as response type in: services.GeoTargetConstantService.GetGeoTargetConstant
Used as field type in: ,
string resource_name = 1
The resource name of the geo target constant. Geo target constant resource names have the form: `geoTargetConstants/{geo_target_constant_id}`
optional id = 3
The ID of the geo target constant.
optional name = 4
Geo target constant English name.
optional country_code = 5
The ISO-3166-1 alpha-2 country code that is associated with the target.
optional target_type = 6
Geo target constant target type.
enums.GeoTargetConstantStatusEnum.GeoTargetConstantStatus status = 7
Geo target constant status.
message
google_ads_field.proto:34A field or resource (artifact) used by GoogleAdsService.
Used as response type in: services.GoogleAdsFieldService.GetGoogleAdsField
Used as field type in:
string resource_name = 1
The resource name of the artifact. Artifact resource names have the form: `googleAdsFields/{name}`
optional name = 2
The name of the artifact.
enums.GoogleAdsFieldCategoryEnum.GoogleAdsFieldCategory category = 3
The category of the artifact.
optional selectable = 4
Whether the artifact can be used in a SELECT clause in search queries.
optional filterable = 5
Whether the artifact can be used in a WHERE clause in search queries.
optional sortable = 6
Whether the artifact can be used in a ORDER BY clause in search queries.
repeated selectable_with = 7
The names of all resources, segments, and metrics that are selectable with the described artifact.
repeated attribute_resources = 8
The names of all resources that are selectable with the described artifact. Fields from these resources do not segment metrics when included in search queries. This field is only set for artifacts whose category is RESOURCE.
repeated metrics = 9
The names of all metrics that are selectable with the described artifact. This field is only set for artifacts whose category is either RESOURCE or SEGMENT.
repeated segments = 10
The names of all artifacts, whether a segment or another resource, that segment metrics when included in search queries. This field is only set for artifacts of category RESOURCE, SEGMENT or METRIC.
repeated enum_values = 11
Values the artifact can assume if it is a field of type ENUM. This field is only set for artifacts of category SEGMENT or ATTRIBUTE.
enums.GoogleAdsFieldDataTypeEnum.GoogleAdsFieldDataType data_type = 12
This field determines the operators that can be used with the artifact in WHERE clauses.
optional type_url = 13
The URL of proto describing the artifact's data type.
optional is_repeated = 14
Whether the field artifact is repeated.
message
hotel_group_view.proto:30A hotel group view.
Used as response type in: services.HotelGroupViewService.GetHotelGroupView
Used as field type in:
string resource_name = 1
The resource name of the hotel group view. Hotel Group view resource names have the form: `customers/{customer_id}/hotelGroupViews/{ad_group_id}_{criterion_id}`
message
hotel_performance_view.proto:30A hotel performance view.
Used as response type in: services.HotelPerformanceViewService.GetHotelPerformanceView
Used as field type in:
string resource_name = 1
The resource name of the hotel performance view. Hotel performance view resource names have the form: `customers/{customer_id}/hotelPerformanceView`
message
keyword_plan.proto:34A Keyword Planner plan.
Used as response type in: services.KeywordPlanService.GetKeywordPlan
Used as field type in: ,
string resource_name = 1
The resource name of the Keyword Planner plan. KeywordPlan resource names have the form: `customers/{customer_id}/keywordPlans/{kp_plan_id}`
optional id = 2
The ID of the keyword plan.
optional name = 3
The name of the keyword plan. This field is required and should not be empty when creating new keyword plans.
optional forecast_period = 4
The date period used for forecasting the plan.
message
keyword_plan_ad_group.proto:32A Keyword Planner ad group.
Used as response type in: services.KeywordPlanAdGroupService.GetKeywordPlanAdGroup
Used as field type in: ,
string resource_name = 1
The resource name of the Keyword Planner ad group. KeywordPlanAdGroup resource names have the form: `customers/{customer_id}/keywordPlanAdGroups/{kp_ad_group_id}`
optional keyword_plan_campaign = 2
The keyword plan campaign to which this ad group belongs.
optional id = 3
The ID of the keyword plan ad group.
optional name = 4
The name of the keyword plan ad group. This field is required and should not be empty when creating keyword plan ad group.
optional cpc_bid_micros = 5
A default ad group max cpc bid in micros in account currency for all biddable keywords under the keyword plan ad group. If not set, will inherit from parent campaign.
message
keyword_plan_campaign.proto:33A Keyword Plan campaign.
Used as response type in: services.KeywordPlanCampaignService.GetKeywordPlanCampaign
Used as field type in: ,
string resource_name = 1
The resource name of the Keyword Plan campaign. KeywordPlanCampaign resource names have the form: `customers/{customer_id}/keywordPlanCampaigns/{kp_campaign_id}`
optional keyword_plan = 2
The keyword plan this campaign belongs to.
optional id = 3
The ID of the Keyword Plan campaign.
optional name = 4
The name of the Keyword Plan campaign. This field is required and should not be empty when creating Keyword Plan campaigns.
repeated language_constants = 5
The languages targeted for the Keyword Plan campaign.
enums.KeywordPlanNetworkEnum.KeywordPlanNetwork keyword_plan_network = 6
Targeting network. This field is required and should not be empty when creating Keyword Plan campaigns.
optional cpc_bid_micros = 7
A default max cpc bid in micros, and in the account currency, for all ad groups under the campaign. This field is required and should not be empty when creating Keyword Plan campaigns.
repeated geo_targets = 8
The geo targets.
message
keyword_plan.proto:55The forecasting period associated with the keyword plan.
Used in:
oneof interval
Required. The date used for forecasting the Plan.
enums.KeywordPlanForecastIntervalEnum.KeywordPlanForecastInterval date_interval = 1
A future date range relative to the current date used for forecasting.
date_range = 2
The custom date range used for forecasting. The start and end dates must be in the future. Otherwise, an error will be returned when the forecasting action is performed.
message
keyword_plan_campaign.proto:74A geo target. Next ID: 3
Used in:
optional geo_target_constant = 1
Required. The resource name of the geo target.
message
keyword_plan_keyword.proto:33A Keyword Plan ad group keyword.
Used as response type in: services.KeywordPlanKeywordService.GetKeywordPlanKeyword
Used as field type in: ,
string resource_name = 1
The resource name of the Keyword Plan ad group keyword. KeywordPlanKeyword resource names have the form: `customers/{customer_id}/keywordPlanKeywords/{kp_ad_group_keyword_id}`
optional keyword_plan_ad_group = 2
The Keyword Plan ad group to which this keyword belongs.
optional id = 3
The ID of the Keyword Plan keyword.
optional text = 4
The keyword text.
enums.KeywordMatchTypeEnum.KeywordMatchType match_type = 5
The keyword match type.
optional cpc_bid_micros = 6
A keyword level max cpc bid in micros, in the account currency, that overrides the keyword plan ad group cpc bid.
A Keyword Plan negative keyword.
Used as response type in: services.KeywordPlanNegativeKeywordService.GetKeywordPlanNegativeKeyword
Used as field type in: ,
string resource_name = 1
The resource name of the Keyword Plan negative keyword. KeywordPlanNegativeKeyword resource names have the form: `customers/{customer_id}/keywordPlanNegativeKeywords/{kp_negative_keyword_id}`
optional keyword_plan_campaign = 2
The Keyword Plan campaign to which this negative keyword belongs.
optional id = 3
The ID of the Keyword Plan negative keyword.
optional text = 4
The keyword text.
enums.KeywordMatchTypeEnum.KeywordMatchType match_type = 5
The keyword match type.
message
keyword_view.proto:30A keyword view.
Used as response type in: services.KeywordViewService.GetKeywordView
Used as field type in:
string resource_name = 1
The resource name of the keyword view. Keyword view resource names have the form: `customers/{customer_id}/keywordViews/{ad_group_id}_{criterion_id}`
message
language_constant.proto:32A language.
Used as response type in: services.LanguageConstantService.GetLanguageConstant
Used as field type in:
string resource_name = 1
The resource name of the language constant. Language constant resource names have the form: `languageConstants/{criterion_id}`
optional id = 2
The ID of the language constant.
optional code = 3
The language code, e.g. "en_US", "en_AU", "es", "fr", etc.
optional name = 4
The full name of the language in English, e.g., "English (US)", "Spanish", etc.
message
managed_placement_view.proto:30A managed placement view.
Used as response type in: services.ManagedPlacementViewService.GetManagedPlacementView
Used as field type in:
string resource_name = 1
The resource name of the Managed Placement view. Managed placement view resource names have the form: `customers/{customer_id}/managedPlacementViews/{ad_group_id}_{criterion_id}`
message
media_file.proto:78Represents a ZIP archive media the content of which contains HTML5 assets.
Used in:
optional data = 1
Raw zipped data.
message
media_file.proto:34A media file.
Used as response type in: services.MediaFileService.GetMediaFile
Used as field type in:
string resource_name = 1
The resource name of the media file. Media file resource names have the form: `customers/{customer_id}/mediaFiles/{media_file_id}`
optional id = 2
The ID of the media file.
enums.MediaTypeEnum.MediaType type = 5
Type of the media file.
enums.MimeTypeEnum.MimeType mime_type = 6
The mime type of the media file.
optional source_url = 7
The URL of where the original media file was downloaded from (or a file name).
optional name = 8
The name of the media file. The name can be used by clients to help identify previously uploaded media.
optional file_size = 9
The size of the media file in bytes.
oneof mediatype
The specific type of the media file.
image = 3
Encapsulates an Image.
media_bundle = 4
A ZIP archive media the content of which contains HTML5 assets.
message
media_file.proto:72Encapsulates an Image.
Used in:
optional data = 1
Raw image data.
message
parental_status_view.proto:30A parental status view.
Used as response type in: services.ParentalStatusViewService.GetParentalStatusView
Used as field type in:
string resource_name = 1
The resource name of the parental status view. Parental Status view resource names have the form: `customers/{customer_id}/parentalStatusViews/{ad_group_id}_{criterion_id}`
message
payments_account.proto:32A Payments account, which can be used to set up billing for an Ads customer.
Used in:
string resource_name = 1
The resource name of the Payments account. PaymentsAccount resource names have the form: `customers/{customer_id}/paymentsAccounts/ {payments_profile_id}_{payments_account_id}`
optional payments_account_id = 2
A 16 digit ID used to identify a Payments account.
optional name = 3
The name of the Payments account.
optional currency_code = 4
The currency code of the Payments account. A subset of the currency codes derived from the ISO 4217 standard is supported.
optional payments_profile_id = 5
A 12 digit ID used to identify the Payments profile associated with the Payments account.
optional secondary_payments_profile_id = 6
A secondary Payments profile ID present in uncommon situations, e.g. when a sequential liability agreement has been arranged.
message
product_group_view.proto:30A product group view.
Used as response type in: services.ProductGroupViewService.GetProductGroupView
Used as field type in:
string resource_name = 1
The resource name of the product group view. Product group view resource names have the form: `customers/{customer_id}/productGroupViews/{ad_group_id}_{criterion_id}`
message
recommendation.proto:36A recommendation.
Used as response type in: services.RecommendationService.GetRecommendation
Used as field type in:
string resource_name = 1
The resource name of the recommendation. `customers/{customer_id}/recommendations/{recommendation_id}`
enums.RecommendationTypeEnum.RecommendationType type = 2
The type of recommendation.
optional impact = 3
The impact on account performance as a result of applying the recommendation.
optional campaign_budget = 5
The budget targeted by this recommendation. This will be set only when the recommendation affects a single campaign budget. This field will be set for the following recommendation types: CAMPAIGN_BUDGET
optional campaign = 6
The campaign targeted by this recommendation. This will be set only when the recommendation affects a single campaign. This field will be set for the following recommendation types: ENHANCED_CPC_OPT_IN, KEYWORD, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, OPTIMIZE_AD_ROTATION, SEARCH_PARTNERS_OPT_IN, TARGET_CPA_OPT_IN, TEXT_AD
optional ad_group = 7
The ad group targeted by this recommendation. This will be set only when the recommendation affects a single ad group. This field will be set for the following recommendation types: KEYWORD, OPTIMIZE_AD_ROTATION, TEXT_AD
optional dismissed = 13
Whether the recommendation is dismissed or not.
oneof recommendation
The details of recommendation.
campaign_budget_recommendation = 4
The campaign budget recommendation.
keyword_recommendation = 8
The keyword recommendation.
text_ad_recommendation = 9
Add expanded text ad recommendation.
target_cpa_opt_in_recommendation = 10
The TargetCPA opt-in recommendation.
maximize_conversions_opt_in_recommendation = 11
The MaximizeConversions Opt-In recommendation.
enhanced_cpc_opt_in_recommendation = 12
The Enhanced Cost-Per-Click Opt-In recommendation.
search_partners_opt_in_recommendation = 14
The Search Partners Opt-In recommendation.
maximize_clicks_opt_in_recommendation = 15
The MaximizeClicks Opt-In recommendation.
optimize_ad_rotation_recommendation = 16
The Optimize Ad Rotation recommendation.
message
recommendation.proto:67The budget recommendation for budget constrained campaigns.
Used in:
optional current_budget_amount_micros = 1
The current budget amount in micros.
optional recommended_budget_amount_micros = 2
The recommended budget amount in micros.
repeated budget_options = 3
The budget amounts and associated impact estimates for some values of possible budget amounts.
message
recommendation.proto:69The impact estimates for a given budget amount.
Used in:
optional budget_amount_micros = 1
The budget amount for this option.
optional impact = 2
The impact estimate if budget is changed to amount specified in this option.
message
recommendation.proto:148The Enhanced Cost-Per-Click Opt-In recommendation.
Used in:
(message has no fields)
message
recommendation.proto:90The keyword recommendation.
Used in:
optional keyword = 1
The recommended keyword.
optional recommended_cpc_bid_micros = 2
The recommended CPC (cost-per-click) bid.
message
recommendation.proto:158The Maximize Clicks opt-in recommendation.
Used in:
optional recommended_budget_amount_micros = 1
The recommended new budget amount. Only set if the current budget is too high.
message
recommendation.proto:142The Maximize Conversions Opt-In recommendation.
Used in:
optional recommended_budget_amount_micros = 1
The recommended new budget amount.
message
recommendation.proto:165The Optimize Ad Rotation recommendation.
Used in:
(message has no fields)
message
recommendation.proto:39The impact of making the change as described in the recommendation. Some types of recommendations may not have impact information.
Used in: , ,
optional base_metrics = 1
Base metrics at the time the recommendation was generated.
optional potential_metrics = 2
Estimated metrics if the recommendation is applied.
message
recommendation.proto:49Weekly account performance metrics. For some recommendation types, these are averaged over the past 90-day period and hence can be fractional.
Used in:
optional impressions = 1
Number of ad impressions.
optional clicks = 2
Number of ad clicks.
optional cost_micros = 3
Cost (in micros) for advertising, in the local currency for the account.
optional conversions = 4
Number of conversions.
optional video_views = 5
Number of video views for a video ad campaign.
message
recommendation.proto:153The Search Partners Opt-In recommendation.
Used in:
(message has no fields)
message
recommendation.proto:114The Target CPA opt-in recommendation.
Used in:
repeated options = 1
The available goals and corresponding options for Target CPA strategy.
optional recommended_target_cpa_micros = 2
The recommended average CPA target. See required budget amount and impact of using this recommendation in options list.
message
recommendation.proto:116The Target CPA opt-in option with impact estimate.
Used in:
enums.TargetCpaOptInRecommendationGoalEnum.TargetCpaOptInRecommendationGoal goal = 1
The goal achieved by this option.
optional target_cpa_micros = 2
Average CPA target.
optional required_campaign_budget_amount_micros = 3
The minimum campaign budget, in local currency for the account, required to achieve the target CPA. Amount is specified in micros, where one million is equivalent to one currency unit.
optional impact = 4
The impact estimate if this option is selected.
message
recommendation.proto:99The text ad recommendation.
Used in:
optional ad = 1
Recommended ad.
optional creation_date = 2
Creation date of the recommended ad. YYYY-MM-DD format, e.g., 2018-04-17.
optional auto_apply_date = 3
Date, if present, is the earliest when the recommendation will be auto applied. YYYY-MM-DD format, e.g., 2018-04-17.
message
search_term_view.proto:34A search term view with metrics aggregated by search term at the ad group level.
Used as response type in: services.SearchTermViewService.GetSearchTermView
Used as field type in:
string resource_name = 1
The resource name of the search term view. Search term view resource names have the form: `customers/{customer_id}/searchTermViews/{campaign_id}_{ad_group_id}_ {URL-base64 search term}`
optional search_term = 2
The search term.
optional ad_group = 3
The ad group the search term served in.
enums.SearchTermTargetingStatusEnum.SearchTermTargetingStatus status = 4
Indicates whether the search term is currently one of your targeted or excluded keywords.
A criterion belonging to a shared set.
Used as response type in: services.SharedCriterionService.GetSharedCriterion
Used as field type in: ,
string resource_name = 1
The resource name of the shared criterion. Shared set resource names have the form: `customers/{customer_id}/sharedCriteria/{shared_set_id}_{criterion_id}`
optional shared_set = 2
The shared set to which the shared criterion belongs.
optional criterion_id = 26
The ID of the criterion. This field is ignored for mutates.
enums.CriterionTypeEnum.CriterionType type = 4
The type of the criterion.
oneof criterion
The criterion. Exactly one must be set.
keyword = 3
Keyword.
youtube_video = 5
YouTube Video.
youtube_channel = 6
YouTube Channel.
placement = 7
Placement.
SharedSets are used for sharing criterion exclusions across multiple campaigns.
Used as response type in: services.SharedSetService.GetSharedSet
Used as field type in: ,
string resource_name = 1
The resource name of the shared set. Shared set resource names have the form: `customers/{customer_id}/sharedSets/{shared_set_id}`
optional id = 2
The ID of this shared set. Read only.
enums.SharedSetTypeEnum.SharedSetType type = 3
The type of this shared set: each shared set holds only a single kind of entity. Required. Immutable.
optional name = 4
The name of this shared set. Required. Shared Sets must have names that are unique among active shared sets of the same type. The length of this string should be between 1 and 255 UTF-8 bytes, inclusive.
enums.SharedSetStatusEnum.SharedSetStatus status = 5
The status of this shared set. Read only.
optional member_count = 6
The number of shared criteria within this shared set. Read only.
optional reference_count = 7
The number of campaigns associated with this shared set. Read only.
message
topic_constant.proto:34Use topics to target or exclude placements in the Google Display Network based on the category into which the placement falls (for example, "Pets & Animals/Pets/Dogs").
Used as response type in: services.TopicConstantService.GetTopicConstant
Used as field type in:
string resource_name = 1
The resource name of the topic constant. topic constant resource names have the form: `topicConstants/{topic_id}`
optional id = 2
The ID of the topic.
optional topic_constant_parent = 3
Resource name of parent of the topic constant.
repeated path = 4
The category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, {"Pets & Animals", "Pets", "Dogs"} represents the "Pets & Animals/Pets/Dogs" category. A complete list of available topic categories is available <a href="https://developers.google.com/adwords/api/docs/appendix/verticals"> here</a>
message
topic_view.proto:30A topic view.
Used as response type in: services.TopicViewService.GetTopicView
Used as field type in:
string resource_name = 1
The resource name of the topic view. Topic view resource names have the form: `customers/{customer_id}/topicViews/{ad_group_id}_{criterion_id}`
message
user_interest.proto:34A user interest: a particular interest-based vertical to be targeted.
Used as response type in: services.UserInterestService.GetUserInterest
Used as field type in:
string resource_name = 1
The resource name of the user interest. User interest resource names have the form: `customers/{customer_id}/userInterests/{user_interest_id}`
enums.UserInterestTaxonomyTypeEnum.UserInterestTaxonomyType taxonomy_type = 2
Taxonomy type of the user interest.
optional user_interest_id = 3
The ID of the user interest.
optional name = 4
The name of the user interest.
optional user_interest_parent = 5
The parent of the user interest.
optional launched_to_all = 6
True if the user interest is launched to all channels and locales.
repeated availabilities = 7
Availability information of the user interest.
message
user_list.proto:39A user list. This is a list of users a customer may target.
Used as response type in: services.UserListService.GetUserList
Used as field type in: ,
string resource_name = 1
The resource name of the user list. User list resource names have the form: `customers/{customer_id}/userLists/{user_list_id}`
optional id = 2
Id of the user list.
optional read_only = 3
A flag that indicates if a user may edit a list. Depends on the list ownership and list type. For example, external remarketing user lists are not editable. This field is read-only.
optional name = 4
Name of this user list. Depending on its access_reason, the user list name may not be unique (e.g. if access_reason=SHARED)
optional description = 5
Description of this user list.
enums.UserListMembershipStatusEnum.UserListMembershipStatus membership_status = 6
Membership status of this user list. Indicates whether a user list is open or active. Only open user lists can accumulate more users and can be targeted to.
optional integration_code = 7
An ID from external system. It is used by user list sellers to correlate IDs on their systems.
optional membership_life_span = 8
Number of days a user's cookie stays on your list since its most recent addition to the list. This field must be between 0 and 540 inclusive. However, for CRM based userlists, this field can be set to 10000 which means no expiration. It'll be ignored for logical_user_list.
optional size_for_display = 9
Estimated number of users in this user list, on the Google Display Network. This value is null if the number of users has not yet been determined. This field is read-only.
enums.UserListSizeRangeEnum.UserListSizeRange size_range_for_display = 10
Size range in terms of number of users of the UserList, on the Google Display Network. This field is read-only.
optional size_for_search = 11
Estimated number of users in this user list in the google.com domain. These are the users available for targeting in Search campaigns. This value is null if the number of users has not yet been determined. This field is read-only.
enums.UserListSizeRangeEnum.UserListSizeRange size_range_for_search = 12
Size range in terms of number of users of the UserList, for Search ads. This field is read-only.
enums.UserListTypeEnum.UserListType type = 13
Type of this list. This field is read-only.
enums.UserListClosingReasonEnum.UserListClosingReason closing_reason = 14
Indicating the reason why this user list membership status is closed. It is only populated on lists that were automatically closed due to inactivity, and will be cleared once the list membership status becomes open.
enums.AccessReasonEnum.AccessReason access_reason = 15
Indicates the reason this account has been granted access to the list. The reason can be SHARED, OWNED, LICENSED or SUBSCRIBED. This field is read-only.
enums.UserListAccessStatusEnum.UserListAccessStatus account_user_list_status = 16
Indicates if this share is still enabled. When a UserList is shared with the user this field is set to ENABLED. Later the userList owner can decide to revoke the share and make it DISABLED. The default value of this field is set to ENABLED.
optional eligible_for_search = 17
Indicates if this user list is eligible for Google Search Network.
optional eligible_for_display = 18
Indicates this user list is eligible for Google Display Network. This field is read-only.
oneof user_list
The user list. Exactly one must be set.
crm_based_user_list = 19
User list of CRM users provided by the advertiser.
similar_user_list = 20
User list which are similar to users from another UserList. These lists are readonly and automatically created by google.
message
video.proto:32A video.
Used as response type in: services.VideoService.GetVideo
Used as field type in:
string resource_name = 1
The resource name of the video. Video resource names have the form: `customers/{customer_id}/videos/{video_id}`
optional id = 2
The ID of the video.
optional channel_id = 3
The owner channel id of the video.
optional duration_millis = 4
The duration of the video in milliseconds.
optional title = 5
The title of the video.