Package google.ads.searchads360.v0.resources

Index

• AccessibleBiddingStrategy (message)
• AccessibleBiddingStrategy.MaximizeConversionValue (message)
• AccessibleBiddingStrategy.MaximizeConversions (message)
• AccessibleBiddingStrategy.TargetCpa (message)
• AccessibleBiddingStrategy.TargetImpressionShare (message)
• AccessibleBiddingStrategy.TargetRoas (message)
• AccessibleBiddingStrategy.TargetSpend (message)
• Ad (message)
• AdGroup (message)
• AdGroupAd (message)
• AdGroupAdEffectiveLabel (message)
• AdGroupAdLabel (message)
• AdGroupAsset (message)
• AdGroupAssetSet (message)
• AdGroupAudienceView (message)
• AdGroupBidModifier (message)
• AdGroupCriterion (message)
• AdGroupCriterion.PositionEstimates (message)
• AdGroupCriterion.QualityInfo (message)
• AdGroupCriterionEffectiveLabel (message)
• AdGroupCriterionLabel (message)
• AdGroupEffectiveLabel (message)
• AdGroupLabel (message)
• AgeRangeView (message)
• Asset (message)
• AssetGroup (message)
• AssetGroupAsset (message)
• AssetGroupAssetCombinationData (message)
• AssetGroupListingGroupFilter (message)
• AssetGroupSignal (message)
• AssetGroupTopCombinationView (message)
• AssetSet (message)
• AssetSetAsset (message)
• Audience (message)
• BiddingStrategy (message)
• Campaign (message)
• Campaign.DynamicSearchAdsSetting (message)
• Campaign.GeoTargetTypeSetting (message)
• Campaign.NetworkSettings (message)
• Campaign.OptimizationGoalSetting (message)
• Campaign.SelectiveOptimization (message)
• Campaign.ShoppingSetting (message)
• Campaign.TrackingSetting (message)
• CampaignAsset (message)
• CampaignAssetSet (message)
• CampaignAudienceView (message)
• CampaignBudget (message)
• CampaignCriterion (message)
• CampaignEffectiveLabel (message)
• CampaignLabel (message)
• CartDataSalesView (message)
• Conversion (message)
• ConversionAction (message)
• ConversionAction.AttributionModelSettings (message)
• ConversionAction.FloodlightSettings (message)
• ConversionAction.ValueSettings (message)
• ConversionCustomVariable (message)
• ConversionCustomVariable.FloodlightConversionCustomVariableInfo (message)
• ConversionTrackingSetting (message)
• CustomColumn (message)
• Customer (message)
• CustomerAsset (message)
• CustomerAssetSet (message)
• CustomerClient (message)
• CustomerManagerLink (message)
• DoubleClickCampaignManagerSetting (message)
• DynamicSearchAdsSearchTermView (message)
• GenderView (message)
• GeoTargetConstant (message)
• KeywordView (message)
• Label (message)
• LanguageConstant (message)
• ListingGroupFilterDimension (message)
• ListingGroupFilterDimension.ProductBiddingCategory (message)
• ListingGroupFilterDimension.ProductBrand (message)
• ListingGroupFilterDimension.ProductChannel (message)
• ListingGroupFilterDimension.ProductCondition (message)
• ListingGroupFilterDimension.ProductCustomAttribute (message)
• ListingGroupFilterDimension.ProductItemId (message)
• ListingGroupFilterDimension.ProductType (message)
• ListingGroupFilterDimensionPath (message)
• LocationView (message)
• ProductBiddingCategoryConstant (message)
• ProductGroupView (message)
• SearchAds360Field (message)
• ShoppingPerformanceView (message)
• UserList (message)
• UserLocationView (message)
• Visit (message)
• WebpageView (message)

AccessibleBiddingStrategy

Represents a view of BiddingStrategies owned by and shared with the customer.

In contrast to BiddingStrategy, this resource includes strategies owned by managers of the customer and shared with this customer - in addition to strategies owned by this customer. This resource does not provide metrics and only exposes a limited subset of the BiddingStrategy attributes.

Fields
resource_name	string The resource name of the accessible bidding strategy. AccessibleBiddingStrategy resource names have the form: customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}
id	int64 The ID of the bidding strategy.
name	string The name of the bidding strategy.
type	BiddingStrategyType The type of the bidding strategy.
owner_customer_id	int64 The ID of the Customer which owns the bidding strategy.
owner_descriptive_name	string descriptive_name of the Customer which owns the bidding strategy.
Union field scheme. The bidding scheme. Only one can be set. scheme can be only one of the following:
maximize_conversion_value	MaximizeConversionValue An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.
maximize_conversions	MaximizeConversions An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.
target_cpa	TargetCpa A bidding strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
target_impression_share	TargetImpressionShare A bidding strategy that automatically optimizes towards a chosen percentage of impressions.
target_roas	TargetRoas A bidding strategy that helps you maximize revenue while averaging a specific target Return On Ad Spend (ROAS).
target_spend	TargetSpend A bid strategy that sets your bids to help get as many clicks as possible within your budget.

MaximizeConversionValue

An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.

Fields
target_roas	double The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget.

MaximizeConversions

An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.

Fields
target_cpa	int64 The target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.
target_cpa_micros	int64 The target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.

TargetCpa

An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.

Fields
target_cpa_micros	int64 Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.

TargetImpressionShare

An automated bidding strategy that sets bids so that a certain percentage of search ads are shown at the top of the first page (or other targeted location).

Fields
location	TargetImpressionShareLocation The targeted location on the search results page.
location_fraction_micros	int64 The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
cpc_bid_ceiling_micros	int64 The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros.

TargetRoas

An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS).

Fields
target_roas	double The chosen revenue (based on conversion data) per unit of spend.

TargetSpend

An automated bid strategy that sets your bids to help get as many clicks as possible within your budget.

Fields
target_spend_micros (deprecated)	int64 This item is deprecated! The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details.
cpc_bid_ceiling_micros	int64 Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.

Ad

An ad.

Fields
resource_name	string The resource name of the ad. Ad resource names have the form: customers/{customer_id}/ads/{ad_id}
final_urls[]	string The list of possible final URLs after all cross-domain redirects for the ad.
type	AdType The type of ad.
id	int64 The ID of the ad.
display_url	string The URL that appears in the ad description for some ad formats.
name	string 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. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd.
Union field ad_data. Details pertinent to the ad type. Exactly one value must be set. ad_data can be only one of the following:
text_ad	SearchAds360TextAdInfo Details pertaining to a text ad.
expanded_text_ad	SearchAds360ExpandedTextAdInfo Details pertaining to an expanded text ad.
responsive_search_ad	SearchAds360ResponsiveSearchAdInfo Details pertaining to a responsive search ad.
product_ad	SearchAds360ProductAdInfo Details pertaining to a product ad.
expanded_dynamic_search_ad	SearchAds360ExpandedDynamicSearchAdInfo Details pertaining to an expanded dynamic search ad.

AdGroup

An ad group.

Fields
resource_name	string The resource name of the ad group. Ad group resource names have the form: customers/{customer_id}/adGroups/{ad_group_id}
status	AdGroupStatus The status of the ad group.
type	AdGroupType The type of the ad group.
ad_rotation_mode	AdGroupAdRotationMode The ad rotation mode of the ad group.
creation_time	string The timestamp when this ad_group was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
targeting_setting	TargetingSetting Setting for targeting related features.
labels[]	string The resource names of labels attached to this ad group.
effective_labels[]	string The resource names of effective labels attached to this ad group. An effective label is a label inherited or directly assigned to this ad group.
engine_id	string ID of the ad group in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "ad_group.id" instead.
start_date	string Date when this ad group starts serving ads. By default, the ad group starts now or the ad group's start date, whichever is later. If this field is set, then the ad group starts at the beginning of the specified date in the customer's time zone. This field is only available for Microsoft Advertising and Facebook gateway accounts. Format: YYYY-MM-DD Example: 2019-03-14
end_date	string Date when the ad group ends serving ads. By default, the ad group ends on the ad group's end date. If this field is set, then the ad group ends at the end of the specified date in the customer's time zone. This field is only available for Microsoft Advertising and Facebook gateway accounts. Format: YYYY-MM-DD Example: 2019-03-14
language_code	string The language of the ads and keywords in an ad group. This field is only available for Microsoft Advertising accounts. More details: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
last_modified_time	string The datetime when this ad group was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
id	int64 The ID of the ad group.
name	string 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.
cpc_bid_micros	int64 The maximum CPC (cost-per-click) bid.
engine_status	AdGroupEngineStatus The Engine Status for ad group.

AdGroupAd

An ad group ad.

Fields
resource_name	string The resource name of the ad. Ad group ad resource names have the form: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}
status	AdGroupAdStatus The status of the ad.
ad	Ad The ad.
creation_time	string The timestamp when this ad_group_ad was created. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
labels[]	string The resource names of labels attached to this ad group ad.
effective_labels[]	string The resource names of effective labels attached to this ad. An effective label is a label inherited or directly assigned to this ad.
engine_id	string ID of the ad in the external engine account. This field is for Search Ads 360 account only, for example, Yahoo Japan, Microsoft, Baidu etc. For non-Search Ads 360 entity, use "ad_group_ad.ad.id" instead.
engine_status	AdGroupAdEngineStatus Additional status of the ad in the external engine account. Possible statuses (depending on the type of external account) include active, eligible, pending review, etc.
last_modified_time	string The datetime when this ad group ad was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.

AdGroupAdEffectiveLabel

A relationship between an ad group ad and an effective label. An effective label is a label inherited or directly assigned to this ad group ad.

Fields
resource_name	string The resource name of the ad group ad effective label. Ad group ad effective label resource names have the form: customers/{customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad	string The ad group ad to which the effective label is attached.
label	string The effective label assigned to the ad group ad.
owner_customer_id	int64 The ID of the Customer which owns the effective label.

AdGroupAdLabel

A relationship between an ad group ad and a label.

Fields
resource_name	string The resource name of the ad group ad label. Ad group ad label resource names have the form: customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad	string The ad group ad to which the label is attached.
label	string The label assigned to the ad group ad.
owner_customer_id	int64 The ID of the Customer which owns the label.

AdGroupAsset

A link between an ad group and an asset.

Fields
resource_name	string The resource name of the ad group asset. AdGroupAsset resource names have the form: customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}
ad_group	string Required. The ad group to which the asset is linked.
asset	string Required. The asset which is linked to the ad group.
status	AssetLinkStatus Status of the ad group asset.

AdGroupAssetSet

AdGroupAssetSet is the linkage between an ad group and an asset set. Creating an AdGroupAssetSet links an asset set with an ad group.

Fields
resource_name	string The resource name of the ad group asset set. Ad group asset set resource names have the form: customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
ad_group	string The ad group to which this asset set is linked.
asset_set	string The asset set which is linked to the ad group.
status	AssetSetLinkStatus The status of the ad group asset set. Read-only.

AdGroupAudienceView

An 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.

Fields
resource_name	string 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}

AdGroupBidModifier

Represents an ad group bid modifier.

Fields
resource_name	string 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}
bid_modifier	double 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.
Union field criterion. The criterion of this ad group bid modifier. Required in create operations starting in V5. criterion can be only one of the following:
device	DeviceInfo A device criterion.

AdGroupCriterion

An ad group criterion. The ad_group_criterion report only returns criteria that were explicitly added to the ad group.

Fields
resource_name	string 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}
creation_time	string The timestamp when this ad group criterion was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
status	AdGroupCriterionStatus The status of the criterion. This is the status of the ad group criterion entity, set by the client. Note: UI reports may incorporate additional information that affects whether a criterion is eligible to run. In some cases a criterion that's REMOVED in the API can still show as enabled in the UI. For example, campaigns by default show to users of all age ranges unless excluded. The UI will show each age range as "enabled", since they're eligible to see the ads; but AdGroupCriterion.status will show "removed", since no positive criterion was added.
quality_info	QualityInfo Information regarding the quality of the criterion.
type	CriterionType The type of the criterion.
labels[]	string The resource names of labels attached to this ad group criterion.
effective_labels[]	string The resource names of effective labels attached to this ad group criterion. An effective label is a label inherited or directly assigned to this ad group criterion.
position_estimates	PositionEstimates Estimates for criterion bids at various positions.
final_urls[]	string The list of possible final URLs after all cross-domain redirects for the ad.
engine_id	string ID of the ad group criterion in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "ad_group_criterion.criterion_id" instead.
last_modified_time	string The datetime when this ad group criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
criterion_id	int64 The ID of the criterion.
ad_group	string The ad group to which the criterion belongs.
negative	bool 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.
bid_modifier	double 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.
cpc_bid_micros	int64 The CPC (cost-per-click) bid.
effective_cpc_bid_micros	int64 The effective CPC (cost-per-click) bid.
engine_status	AdGroupCriterionEngineStatus The Engine Status for ad group criterion.
final_url_suffix	string URL template for appending params to final URL.
tracking_url_template	string The URL template for constructing a tracking URL.
Union field criterion. The ad group criterion. Exactly one must be set. criterion can be only one of the following:
keyword	KeywordInfo Keyword.
listing_group	ListingGroupInfo Listing group.
age_range	AgeRangeInfo Age range.
gender	GenderInfo Gender.
user_list	UserListInfo User List.
webpage	WebpageInfo Webpage
location	LocationInfo Location.

PositionEstimates

Estimates for criterion bids at various positions.

Fields
top_of_page_cpc_micros	int64 The estimate of the CPC bid required for ad to be displayed at the top of the first page of search results.

QualityInfo

A container for ad group criterion quality information.

Fields
quality_score	int32 The quality score. This field may not be populated if Google does not have enough information to determine a value.

AdGroupCriterionEffectiveLabel

A relationship between an ad group criterion and an effective label. An effective label is a label inherited or directly assigned to this ad group criterion.

Fields
resource_name	string The resource name of the ad group criterion effective label. Ad group criterion effective label resource names have the form: customers/{customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion	string The ad group criterion to which the effective label is attached.
label	string The effective label assigned to the ad group criterion.
owner_customer_id	int64 The ID of the Customer which owns the effective label.

AdGroupCriterionLabel

A relationship between an ad group criterion and a label.

Fields
resource_name	string The resource name of the ad group criterion label. Ad group criterion label resource names have the form: customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion	string The ad group criterion to which the label is attached.
label	string The label assigned to the ad group criterion.
owner_customer_id	int64 The ID of the Customer which owns the label.

AdGroupEffectiveLabel

A relationship between an ad group and an effective label. An effective label is a label inherited or directly assigned to this ad group.

Fields
resource_name	string The resource name of the ad group effective label. Ad group effective label resource names have the form: customers/{customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}
ad_group	string The ad group to which the effective label is attached.
label	string The effective label assigned to the ad group.
owner_customer_id	int64 The ID of the Customer which owns the effective label.

AdGroupLabel

A relationship between an ad group and a label.

Fields
resource_name	string The resource name of the ad group label. Ad group label resource names have the form: customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}
ad_group	string The ad group to which the label is attached.
label	string The label assigned to the ad group.
owner_customer_id	int64 The ID of the Customer which owns the label.

AgeRangeView

An age range view.

Fields
resource_name	string 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}

Asset

Asset is a part of an ad which can be shared across multiple ads. It can be an image (ImageAsset), a video (YoutubeVideoAsset), etc. Assets are immutable and cannot be removed. To stop an asset from serving, remove the asset from the entity that is using it.

Fields
resource_name	string The resource name of the asset. Asset resource names have the form: customers/{customer_id}/assets/{asset_id}
type	AssetType Type of the asset.
final_urls[]	string A list of possible final URLs after all cross domain redirects.
status	AssetStatus The status of the asset.
creation_time	string The timestamp when this asset was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
last_modified_time	string The datetime when this asset was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
id	int64 The ID of the asset.
name	string Optional name of the asset.
tracking_url_template	string URL template for constructing a tracking URL.
engine_status	AssetEngineStatus The Engine Status for an asset.
Union field asset_data. The specific type of the asset. asset_data can be only one of the following:
youtube_video_asset	YoutubeVideoAsset A YouTube video asset.
image_asset	ImageAsset An image asset.
text_asset	TextAsset A text asset.
callout_asset	UnifiedCalloutAsset A unified callout asset.
sitelink_asset	UnifiedSitelinkAsset A unified sitelink asset.
page_feed_asset	UnifiedPageFeedAsset A unified page feed asset.
mobile_app_asset	MobileAppAsset A mobile app asset.
call_asset	UnifiedCallAsset A unified call asset.
call_to_action_asset	CallToActionAsset A call to action asset.
location_asset	UnifiedLocationAsset A unified location asset.

AssetGroup

An asset group. AssetGroupAsset is used to link an asset to the asset group. AssetGroupSignal is used to associate a signal to an asset group.

Fields
resource_name	string The resource name of the asset group. Asset group resource names have the form: customers/{customer_id}/assetGroups/{asset_group_id}
id	int64 The ID of the asset group.
campaign	string The campaign with which this asset group is associated. The asset which is linked to the asset group.
name	string Required. Name of the asset group. Required. It must have a minimum length of 1 and maximum length of 128. It must be unique under a campaign.
final_urls[]	string A list of final URLs after all cross domain redirects. In performance max, by default, the urls are eligible for expansion unless opted out.
final_mobile_urls[]	string A list of final mobile URLs after all cross domain redirects. In performance max, by default, the urls are eligible for expansion unless opted out.
status	AssetGroupStatus The status of the asset group.
path1	string First part of text that may appear appended to the url displayed in the ad.
path2	string Second part of text that may appear appended to the url displayed in the ad. This field can only be set when path1 is set.
ad_strength	AdStrength Overall ad strength of this asset group.

AssetGroupAsset

AssetGroupAsset is the link between an asset and an asset group. Adding an AssetGroupAsset links an asset with an asset group.

Fields
resource_name	string The resource name of the asset group asset. Asset group asset resource name have the form: customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}
asset_group	string The asset group which this asset group asset is linking.
asset	string The asset which this asset group asset is linking.
field_type	AssetFieldType The description of the placement of the asset within the asset group. For example: HEADLINE, YOUTUBE_VIDEO etc
status	AssetLinkStatus The status of the link between an asset and asset group.

AssetGroupAssetCombinationData

Asset group asset combination data

Fields
asset_combination_served_assets[]	AssetUsage Served assets.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter represents a listing group filter tree node in an asset group.

Fields
resource_name	string The resource name of the asset group listing group filter. Asset group listing group filter resource name have the form: customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
asset_group	string The asset group which this asset group listing group filter is part of.
id	int64 The ID of the ListingGroupFilter.
type	ListingGroupFilterType Type of a listing group filter node.
vertical	ListingGroupFilterVertical The vertical the current node tree represents. All nodes in the same tree must belong to the same vertical.
case_value	ListingGroupFilterDimension Dimension value with which this listing group is refining its parent. Undefined for the root group.
parent_listing_group_filter	string Resource name of the parent listing group subdivision. Null for the root listing group filter node.
path	ListingGroupFilterDimensionPath The path of dimensions defining this listing group filter.

AssetGroupSignal

AssetGroupSignal represents a signal in an asset group. The existence of a signal tells the performance max campaign who's most likely to convert. Performance Max uses the signal to look for new people with similar or stronger intent to find conversions across Search, Display, Video, and more.

Fields
resource_name	string The resource name of the asset group signal. Asset group signal resource name have the form: customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}
asset_group	string The asset group which this asset group signal belongs to.
Union field signal. The signal of the asset group. signal can be only one of the following:
audience	AudienceInfo The audience signal to be used by the performance max campaign.

AssetGroupTopCombinationView

A view on the usage of ad group ad asset combination.

Fields
resource_name	string The resource name of the asset group top combination view. AssetGroup Top Combination view resource names have the form: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"
asset_group_top_combinations[]	AssetGroupAssetCombinationData The top combinations of assets that served together.

AssetSet

An asset set representing a collection of assets. Use AssetSetAsset to link an asset to the asset set.

Fields
id	int64 The ID of the asset set.
resource_name	string The resource name of the asset set. Asset set resource names have the form: customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

AssetSetAsset is the link between an asset and an asset set. Adding an AssetSetAsset links an asset with an asset set.

Fields
resource_name	string The resource name of the asset set asset. Asset set asset resource names have the form: customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}
asset_set	string The asset set which this asset set asset is linking to.
asset	string The asset which this asset set asset is linking to.
status	AssetSetAssetStatus The status of the asset set asset. Read-only.

Audience

Audience is an effective targeting option that lets you intersect different segment attributes, such as detailed demographics and affinities, to create audiences that represent sections of your target segments.

Fields
resource_name	string The resource name of the audience. Audience names have the form: customers/{customer_id}/audiences/{audience_id}
id	int64 ID of the audience.
name	string Required. Name of the audience. It should be unique across all audiences. It must have a minimum length of 1 and maximum length of 255.
description	string Description of this audience.

BiddingStrategy

A bidding strategy.

Fields
resource_name	string The resource name of the bidding strategy. Bidding strategy resource names have the form: customers/{customer_id}/biddingStrategies/{bidding_strategy_id}
status	BiddingStrategyStatus The status of the bidding strategy. This field is read-only.
type	BiddingStrategyType The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only.
currency_code	string The currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this currency can be set on creation and defaults to the manager customer's currency. For serving customers, this field cannot be set; all strategies in a serving customer implicitly use the serving customer's currency. In all cases the effective_currency_code field returns the currency used by the strategy.
id	int64 The ID of the bidding strategy.
name	string 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).
effective_currency_code	string The currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this is the currency set by the advertiser when creating the strategy. For serving customers, this is the customer's currency_code. Bidding strategy metrics are reported in this currency. This field is read-only.
campaign_count	int64 The number of campaigns attached to this bidding strategy. This field is read-only.
non_removed_campaign_count	int64 The number of non-removed campaigns attached to this bidding strategy. This field is read-only.
Union field scheme. The bidding scheme. Only one can be set. scheme can be only one of the following:
enhanced_cpc	EnhancedCpc 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.
maximize_conversion_value	MaximizeConversionValue An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.
maximize_conversions	MaximizeConversions An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.
target_cpa	TargetCpa A bidding strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
target_impression_share	TargetImpressionShare A bidding strategy that automatically optimizes towards a chosen percentage of impressions.
target_outrank_share	TargetOutrankShare A bidding strategy that sets bids based on the target fraction of auctions where the advertiser should outrank a specific competitor. This field is deprecated. Creating a new bidding strategy with this field or attaching bidding strategies with this field to a campaign will fail. Mutates to strategies that already have this scheme populated are allowed.
target_roas	TargetRoas A bidding strategy that helps you maximize revenue while averaging a specific target Return On Ad Spend (ROAS).
target_spend	TargetSpend A bid strategy that sets your bids to help get as many clicks as possible within your budget.

Campaign

A campaign.

Fields
resource_name	string The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id}
status	CampaignStatus The status of the campaign. When a new campaign is added, the status defaults to ENABLED.
serving_status	CampaignServingStatus The ad serving status of the campaign.
bidding_strategy_system_status	BiddingStrategySystemStatus The system status of the campaign's bidding strategy.
ad_serving_optimization_status	AdServingOptimizationStatus The ad serving optimization status of the campaign.
advertising_channel_type	AdvertisingChannelType 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.
advertising_channel_sub_type	AdvertisingChannelSubType 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.
url_custom_parameters[]	CustomParameter The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
real_time_bidding_setting	RealTimeBiddingSetting Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network.
network_settings	NetworkSettings The network settings for the campaign.
dynamic_search_ads_setting	DynamicSearchAdsSetting The setting for controlling Dynamic Search Ads (DSA).
shopping_setting	ShoppingSetting The setting for controlling Shopping campaigns.
geo_target_type_setting	GeoTargetTypeSetting The setting for ads geotargeting.
effective_labels[]	string The resource names of effective labels attached to this campaign. An effective label is a label inherited or directly assigned to this campaign.
labels[]	string The resource names of labels attached to this campaign.
bidding_strategy_type	BiddingStrategyType 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.
accessible_bidding_strategy	string Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource.
frequency_caps[]	FrequencyCapEntry A list that limits how often each user will see this campaign's ads.
selective_optimization	SelectiveOptimization Selective optimization setting for this campaign, which includes a set of conversion actions to optimize this campaign towards. This feature only applies to app campaigns that use MULTI_CHANNEL as AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as AdvertisingChannelSubType.
optimization_goal_setting	OptimizationGoalSetting Optimization goal setting for this campaign, which includes a set of optimization goal types.
tracking_setting	TrackingSetting Campaign-level settings for tracking information.
engine_id	string ID of the campaign in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "campaign.id" instead.
excluded_parent_asset_field_types[]	AssetFieldType The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level.
create_time	string The timestamp when this campaign was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. create_time will be deprecated in v1. Use creation_time instead.
creation_time	string The timestamp when this campaign was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
last_modified_time	string The datetime when this campaign was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
id	int64 The ID of the campaign.
name	string 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.
tracking_url_template	string The URL template for constructing a tracking URL.
campaign_budget	string The resource name of the campaign budget of the campaign.
start_date	string The date when campaign started in serving customer's timezone in YYYY-MM-DD format.
end_date	string The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. On create, defaults to 2037-12-30, which means the campaign will run indefinitely. To set an existing campaign to run indefinitely, set this field to 2037-12-30.
final_url_suffix	string Suffix used to append query parameters to landing pages that are served with parallel tracking.
url_expansion_opt_out	bool Represents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false.
Union field campaign_bidding_strategy. The bidding strategy for the campaign. Must be either portfolio (created through BiddingStrategy service) or standard, that is embedded into the campaign. campaign_bidding_strategy can be only one of the following:
bidding_strategy	string The resource name of the portfolio bidding strategy used by the campaign.
manual_cpa	ManualCpa Standard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns.
manual_cpc	ManualCpc Standard Manual CPC bidding strategy. Manual click-based bidding where user pays per click.
manual_cpm	ManualCpm Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
maximize_conversions	MaximizeConversions Standard Maximize Conversions bidding strategy that automatically maximizes number of conversions while spending your budget.
maximize_conversion_value	MaximizeConversionValue Standard Maximize Conversion Value bidding strategy that automatically sets bids to maximize revenue while spending your budget.
target_cpa	TargetCpa 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_impression_share	TargetImpressionShare Target Impression Share bidding strategy. An automated bidding strategy that sets bids to achieve a chosen percentage of impressions.
target_roas	TargetRoas Standard Target ROAS bidding strategy that automatically maximizes revenue while averaging a specific target return on ad spend (ROAS).
target_spend	TargetSpend Standard Target Spend bidding strategy that automatically sets your bids to help get as many clicks as possible within your budget.
percent_cpc	PercentCpc Standard Percent Cpc bidding strategy where bids are a fraction of the advertised price for some good or service.
target_cpm	TargetCpm A bidding strategy that automatically optimizes cost per thousand impressions.

DynamicSearchAdsSetting

The setting for controlling Dynamic Search Ads (DSA).

Fields
domain_name	string Required. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com".
language_code	string Required. The language code specifying the language of the domain, for example, "en".
use_supplied_urls_only	bool Whether the campaign uses advertiser supplied URLs exclusively.

GeoTargetTypeSetting

Represents a collection of settings related to ads geotargeting.

Fields
positive_geo_target_type	PositiveGeoTargetType The setting used for positive geotargeting in this particular campaign.
negative_geo_target_type	NegativeGeoTargetType The setting used for negative geotargeting in this particular campaign.

NetworkSettings

The network settings for the campaign.

Fields
target_google_search	bool Whether ads will be served with google.com search results.
target_search_network	bool Whether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true).
target_content_network	bool Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
target_partner_search_network	bool Whether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.

OptimizationGoalSetting

Optimization goal setting for this campaign, which includes a set of optimization goal types.

Fields
optimization_goal_types[]	OptimizationGoalType The list of optimization goal types.

SelectiveOptimization

Selective optimization setting for this campaign, which includes a set of conversion actions to optimize this campaign towards. This feature only applies to app campaigns that use MULTI_CHANNEL as AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as AdvertisingChannelSubType.

Fields
conversion_actions[]	string The selected set of resource names for conversion actions for optimizing this campaign.

ShoppingSetting

The 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.

Fields
feed_label	string Feed label of products to include in the campaign. Only one of feed_label or sales_country can be set. If used instead of sales_country, the feed_label field accepts country codes in the same format for example: 'XX'. Otherwise can be any string used for feed label in Google Merchant Center.
use_vehicle_inventory	bool Whether to target Vehicle Listing inventory.
merchant_id	int64 ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
sales_country	string Sales country of products to include in the campaign.
campaign_priority	int32 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.
enable_local	bool Whether to include local products.

TrackingSetting

Campaign-level settings for tracking information.

Fields
tracking_url	string The url used for dynamic tracking.

CampaignAsset

A link between a Campaign and an Asset.

Fields
resource_name	string The resource name of the campaign asset. CampaignAsset resource names have the form: customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}
status	AssetLinkStatus Status of the campaign asset.
campaign	string The campaign to which the asset is linked.
asset	string The asset which is linked to the campaign.

CampaignAssetSet

CampaignAssetSet is the linkage between a campaign and an asset set. Adding a CampaignAssetSet links an asset set with a campaign.

Fields
resource_name	string The resource name of the campaign asset set. Asset set asset resource names have the form: customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign	string The campaign to which this asset set is linked.
asset_set	string The asset set which is linked to the campaign.
status	AssetSetLinkStatus The status of the campaign asset set asset. Read-only.

CampaignAudienceView

A 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.

Fields
resource_name	string The resource name of the campaign audience view. Campaign audience view resource names have the form: customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

CampaignBudget

A campaign budget.

Fields
resource_name	string The resource name of the campaign budget. Campaign budget resource names have the form: customers/{customer_id}/campaignBudgets/{campaign_budget_id}
delivery_method	BudgetDeliveryMethod The delivery method that determines the rate at which the campaign budget is spent. Defaults to STANDARD if unspecified in a create operation.
period	BudgetPeriod Period over which to spend the budget. Defaults to DAILY if not specified.
amount_micros	int64 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. Monthly spend is capped at 30.4 times this amount.

CampaignCriterion

A campaign criterion.

Fields
resource_name	string The resource name of the campaign criterion. Campaign criterion resource names have the form: customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}
display_name	string The display name of the criterion. This field is ignored for mutates.
type	CriterionType The type of the criterion.
status	CampaignCriterionStatus The status of the criterion.
last_modified_time	string The datetime when this campaign criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
criterion_id	int64 The ID of the criterion. This field is ignored during mutate.
bid_modifier	float 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.
negative	bool Whether to target (false) or exclude (true) the criterion.
Union field criterion. The campaign criterion. Exactly one must be set. criterion can be only one of the following:
keyword	KeywordInfo Keyword.
location	LocationInfo Location.
device	DeviceInfo Device.
age_range	AgeRangeInfo Age range.
gender	GenderInfo Gender.
user_list	UserListInfo User List.
language	LanguageInfo Language.
webpage	WebpageInfo Webpage.
location_group	LocationGroupInfo Location Group

CampaignEffectiveLabel

Represents a relationship between a campaign and an effective label. An effective label is a label inherited or directly assigned to this campaign.

Fields
resource_name	string Name of the resource. CampaignEffectivelabel resource names have the form: customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign	string The campaign to which the effective label is attached.
label	string The effective label assigned to the campaign.
owner_customer_id	int64 The ID of the Customer which owns the effective label.

CampaignLabel

Represents a relationship between a campaign and a label.

Fields
resource_name	string Name of the resource. Campaign label resource names have the form: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}
campaign	string The campaign to which the label is attached.
label	string The label assigned to the campaign.
owner_customer_id	int64 The ID of the Customer which owns the label.

CartDataSalesView

Cart data sales view.

Fields
resource_name	string The resource name of the Cart data sales view. Cart data sales view resource names have the form: customers/{customer_id}/cartDataSalesView

Conversion

A conversion.

Fields
resource_name	string The resource name of the conversion. Conversion resource names have the form: customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}
id	int64 The ID of the conversion
criterion_id	int64 Search Ads 360 criterion ID. A value of 0 indicates that the criterion is unattributed.
merchant_id	int64 The Search Ads 360 inventory account ID containing the product that was clicked on. Search Ads 360 generates this ID when you link an inventory account in Search Ads 360.
ad_id	int64 Ad ID. A value of 0 indicates that the ad is unattributed.
click_id	string A unique string, for the visit that the conversion is attributed to, that is passed to the landing page as the click id URL parameter.
visit_id	int64 The Search Ads 360 visit ID that the conversion is attributed to.
advertiser_conversion_id	string For offline conversions, this is an ID provided by advertisers. If an advertiser doesn't specify such an ID, Search Ads 360 generates one. For online conversions, this is equal to the id column or the floodlight_order_id column depending on the advertiser's Floodlight instructions.
product_id	string The ID of the product clicked on.
product_channel	ProductChannel The sales channel of the product that was clicked on: Online or Local.
product_language_code	string The language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product.
product_store_id	string The store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed.
product_country_code	string The country (ISO-3166-format) registered for the inventory feed that contains the product clicked on.
attribution_type	AttributionType What the conversion is attributed to: Visit or Keyword+Ad.
conversion_date_time	string The timestamp of the conversion event.
conversion_last_modified_date_time	string The timestamp of the last time the conversion was modified.
conversion_visit_date_time	string The timestamp of the visit that the conversion is attributed to.
conversion_quantity	int64 The quantity of items recorded by the conversion, as determined by the qty url parameter. The advertiser is responsible for dynamically populating the parameter (such as number of items sold in the conversion), otherwise it defaults to 1.
conversion_revenue_micros	int64 The adjusted revenue in micros for the conversion event. This will always be in the currency of the serving account.
floodlight_original_revenue	int64 The original, unchanged revenue associated with the Floodlight event (in the currency of the current report), before Floodlight currency instruction modifications.
floodlight_order_id	string The Floodlight order ID provided by the advertiser for the conversion.
status	ConversionStatus The status of the conversion, either ENABLED or REMOVED..
asset_id	int64 ID of the asset which was interacted with during the conversion event.
asset_field_type	AssetFieldType Asset field type of the conversion event.

ConversionAction

A conversion action.

Fields
resource_name	string The resource name of the conversion action. Conversion action resource names have the form: customers/{customer_id}/conversionActions/{conversion_action_id}
creation_time	string Timestamp of the Floodlight activity's creation, formatted in ISO 8601.
status	ConversionActionStatus The status of this conversion action for conversion event accrual.
type	ConversionActionType The type of this conversion action.
category	ConversionActionCategory The category of conversions reported for this conversion action.
value_settings	ValueSettings Settings related to the value for conversion events associated with this conversion action.
attribution_model_settings	AttributionModelSettings Settings related to this conversion action's attribution model.
floodlight_settings	FloodlightSettings Floodlight settings for Floodlight conversion types.
id	int64 The ID of the conversion action.
name	string The name of the conversion action. This field is required and should not be empty when creating new conversion actions.
primary_for_goal	bool If a conversion action's primary_for_goal bit is false, the conversion action is non-biddable for all campaigns regardless of their customer conversion goal or campaign conversion goal. However, custom conversion goals do not respect primary_for_goal, so if a campaign has a custom conversion goal configured with a primary_for_goal = false conversion action, that conversion action is still biddable. By default, primary_for_goal will be true if not set. In V9, primary_for_goal can only be set to false after creation through an 'update' operation because it's not declared as optional.
owner_customer	string The resource name of the conversion action owner customer, or null if this is a system-defined conversion action.
include_in_client_account_conversions_metric	bool Whether this conversion action should be included in the "client_account_conversions" metric.
include_in_conversions_metric	bool Whether this conversion action should be included in the "conversions" metric.
click_through_lookback_window_days	int64 The maximum number of days that may elapse between an interaction (for example, a click) and a conversion event.
app_id	string App ID for an app conversion action.

AttributionModelSettings

Settings related to this conversion action's attribution model.

Fields
attribution_model	AttributionModel The attribution model type of this conversion action.
data_driven_model_status	DataDrivenModelStatus The status of the data-driven attribution model for the conversion action.

FloodlightSettings

Settings related to a Floodlight conversion action.

Fields
activity_group_tag	string String used to identify a Floodlight activity group when reporting conversions.
activity_tag	string String used to identify a Floodlight activity when reporting conversions.
activity_id	int64 ID of the Floodlight activity in DoubleClick Campaign Manager (DCM).

ValueSettings

Settings related to the value for conversion events associated with this conversion action.

Fields
default_value	double 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.
default_currency_code	string 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.
always_use_default_value	bool 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.

ConversionCustomVariable

A conversion custom variable. See "About custom Floodlight metrics and dimensions in the new Search Ads 360" at https://support.google.com/sa360/answer/13567857

Fields
resource_name	string The resource name of the conversion custom variable. Conversion custom variable resource names have the form: customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}
id	int64 The ID of the conversion custom variable.
name	string Required. The name of the conversion custom variable. Name should be unique. The maximum length of name is 100 characters. There should not be any extra spaces before and after.
tag	string Required. The tag of the conversion custom variable. Tag should be unique and consist of a "u" character directly followed with a number less than ormequal to 100. For example: "u4".
status	ConversionCustomVariableStatus The status of the conversion custom variable for conversion event accrual.
owner_customer	string The resource name of the customer that owns the conversion custom variable.
family	ConversionCustomVariableFamily Family of the conversion custom variable.
cardinality	ConversionCustomVariableCardinality Cardinality of the conversion custom variable.
floodlight_conversion_custom_variable_info	FloodlightConversionCustomVariableInfo Fields for Search Ads 360 floodlight conversion custom variables.
custom_column_ids[]	int64 The IDs of custom columns that use this conversion custom variable.

FloodlightConversionCustomVariableInfo

Information for Search Ads 360 Floodlight Conversion Custom Variables.

Fields
floodlight_variable_type	FloodlightVariableType Floodlight variable type defined in Search Ads 360.
floodlight_variable_data_type	FloodlightVariableDataType Floodlight variable data type defined in Search Ads 360.

ConversionTrackingSetting

A collection of customer-wide settings related to Search Ads 360 Conversion Tracking.

Fields
accepted_customer_data_terms	bool Whether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. For more information, see https://support.google.com/adspolicy/answer/7475709.
conversion_tracking_status	ConversionTrackingStatus Conversion tracking status. It indicates whether the customer is using conversion tracking, and who is the conversion tracking owner of this customer. If this customer is using cross-account conversion tracking, the value returned will differ based on the login-customer-id of the request.
enhanced_conversions_for_leads_enabled	bool Whether the customer is opted-in for enhanced conversions for leads. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only.
google_ads_conversion_customer	string The resource name of the customer where conversions are created and managed. This field is read-only.
conversion_tracking_id	int64 The conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversion_tracking_status does). This field is read-only.
google_ads_cross_account_conversion_tracking_id	int64 The conversion tracking id of the customer's manager. This is set when the customer is opted into conversion tracking, and it overrides conversion_tracking_id. This field can only be managed through the Google Ads UI. This field is read-only.
cross_account_conversion_tracking_id	int64 The conversion tracking id of the customer's manager. This is set when the customer is opted into cross-account conversion tracking, and it overrides conversion_tracking_id.

CustomColumn

A custom column. See Search Ads 360 custom column at https://support.google.com/sa360/answer/9633916

Fields
resource_name	string The resource name of the custom column. Custom column resource names have the form: customers/{customer_id}/customColumns/{custom_column_id}
id	int64 ID of the custom column.
name	string User-defined name of the custom column.
description	string User-defined description of the custom column.
value_type	CustomColumnValueType The type of the result value of the custom column.
references_attributes	bool True when the custom column is referring to one or more attributes.
references_metrics	bool True when the custom column is referring to one or more metrics.
queryable	bool True when the custom column is available to be used in the query of SearchAds360Service.Search and SearchAds360Service.SearchStream.
referenced_system_columns[]	string The list of the referenced system columns of this custom column. For example, A custom column "sum of impressions and clicks" has referenced system columns of {"metrics.clicks", "metrics.impressions"}.
render_type	CustomColumnRenderType How the result value of the custom column should be interpreted.

Customer

A customer.

Fields
resource_name	string The resource name of the customer. Customer resource names have the form: customers/{customer_id}
conversion_tracking_setting	ConversionTrackingSetting Conversion tracking setting for a customer.
account_type	AccountType Engine account type, for example, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track, etc.
double_click_campaign_manager_setting	DoubleClickCampaignManagerSetting DoubleClick Campaign Manager (DCM) setting for a manager customer.
account_status	AccountStatus Account status, for example, Enabled, Paused, Removed, etc.
last_modified_time	string The datetime when this customer was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
engine_id	string ID of the account in the external engine account.
status	CustomerStatus The status of the customer.
creation_time	string The timestamp when this customer was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
id	int64 The ID of the customer.
descriptive_name	string Optional, non-unique descriptive name of the customer.
currency_code	string The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
time_zone	string The local timezone ID of the customer.
tracking_url_template	string The URL template for constructing a tracking URL out of parameters.
final_url_suffix	string The URL template for appending params to the final URL.
auto_tagging_enabled	bool Whether auto-tagging is enabled for the customer.
manager	bool Whether the customer is a manager.

CustomerAsset

A link between a customer and an asset.

Fields
resource_name	string The resource name of the customer asset. CustomerAsset resource names have the form: customers/{customer_id}/customerAssets/{asset_id}~{field_type}
asset	string Required. The asset which is linked to the customer.
status	AssetLinkStatus Status of the customer asset.

CustomerAssetSet

CustomerAssetSet is the linkage between a customer and an asset set. Adding a CustomerAssetSet links an asset set with a customer.

Fields
resource_name	string The resource name of the customer asset set. Asset set asset resource names have the form: customers/{customer_id}/customerAssetSets/{asset_set_id}
asset_set	string The asset set which is linked to the customer.
customer	string The customer to which this asset set is linked.
status	AssetSetLinkStatus The status of the customer asset set asset. Read-only.

CustomerClient

A link between the given customer and a client customer. CustomerClients only exist for manager customers. All direct and indirect client customers are included, as well as the manager itself.

Fields
resource_name	string The resource name of the customer client. CustomerClient resource names have the form: customers/{customer_id}/customerClients/{client_customer_id}
applied_labels[]	string The resource names of the labels owned by the requesting customer that are applied to the client customer. Label resource names have the form: customers/{customer_id}/labels/{label_id}
status	CustomerStatus The status of the client customer. Read only.
client_customer	string The resource name of the client-customer which is linked to the given customer. Read only.
hidden	bool Specifies whether this is a hidden account. Read only.
level	int64 Distance between given customer and client. For self link, the level value will be 0. Read only.
time_zone	string Common Locale Data Repository (CLDR) string representation of the time zone of the client, for example, America/Los_Angeles. Read only.
test_account	bool Identifies if the client is a test account. Read only.
manager	bool Identifies if the client is a manager. Read only.
descriptive_name	string Descriptive name for the client. Read only.
currency_code	string Currency code (for example, 'USD', 'EUR') for the client. Read only.
id	int64 The ID of the client customer. Read only.

CustomerManagerLink

Represents customer-manager link relationship.

Fields
resource_name	string Name of the resource. CustomerManagerLink resource names have the form: customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}
status	ManagerLinkStatus Status of the link between the customer and the manager.
manager_customer	string The manager customer linked to the customer.
manager_link_id	int64 ID of the customer-manager link. This field is read only.
start_time	string The timestamp when the CustomerManagerLink was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.

DoubleClickCampaignManagerSetting

DoubleClick Campaign Manager (DCM) setting for a manager customer.

Fields
advertiser_id	int64 ID of the Campaign Manager advertiser associated with this customer.
network_id	int64 ID of the Campaign Manager network associated with this customer.
time_zone	string Time zone of the Campaign Manager network associated with this customer in IANA Time Zone Database format, such as America/New_York.

DynamicSearchAdsSearchTermView

A dynamic search ads search term view.

Fields
resource_name	string The resource name of the dynamic search ads search term view. Dynamic search ads search term view resource names have the form: customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landing_page	string The dynamically selected landing page URL of the impression. This field is read-only.

GenderView

A gender view. The gender_view resource reflects the effective serving state, rather than what criteria were added. An ad group without gender criteria by default shows to all genders, so all genders appear in gender_view with stats.

Fields
resource_name	string The resource name of the gender view. Gender view resource names have the form: customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeoTargetConstant

A geo target constant.

Fields
resource_name	string The resource name of the geo target constant. Geo target constant resource names have the form: geoTargetConstants/{geo_target_constant_id}
status	GeoTargetConstantStatus Geo target constant status.
id	int64 The ID of the geo target constant.
name	string Geo target constant English name.
country_code	string The ISO-3166-1 alpha-2 country code that is associated with the target.
target_type	string Geo target constant target type.
canonical_name	string The fully qualified English name, consisting of the target's name and that of its parent and country.
parent_geo_target	string The resource name of the parent geo target constant. Geo target constant resource names have the form: geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

A keyword view.

Fields
resource_name	string The resource name of the keyword view. Keyword view resource names have the form: customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

Label

A label.

Fields
resource_name	string Name of the resource. Label resource names have the form: customers/{customer_id}/labels/{label_id}
status	LabelStatus Status of the label. Read only.
text_label	TextLabel A type of label displaying text on a colored background.
id	int64 ID of the label. Read only.
name	string The name of the label. This field is required and should not be empty when creating a new label. The length of this string should be between 1 and 80, inclusive.

LanguageConstant

A language.

Fields
resource_name	string The resource name of the language constant. Language constant resource names have the form: languageConstants/{criterion_id}
id	int64 The ID of the language constant.
code	string The language code, for example, "en_US", "en_AU", "es", "fr", etc.
name	string The full name of the language in English, for example, "English (US)", "Spanish", etc.
targetable	bool Whether the language is targetable.

ListingGroupFilterDimension

Listing dimensions for the asset group listing group filter.

Fields
Union field dimension. Dimension of one of the types below is always present. dimension can be only one of the following:
product_bidding_category	ProductBiddingCategory Bidding category of a product offer.
product_brand	ProductBrand Brand of a product offer.
product_channel	ProductChannel Locality of a product offer.
product_condition	ProductCondition Condition of a product offer.
product_custom_attribute	ProductCustomAttribute Custom attribute of a product offer.
product_item_id	ProductItemId Item id of a product offer.
product_type	ProductType Type of a product offer.

ProductBiddingCategory

One element of a bidding category at a certain level. Top-level categories are at level 1, their children at level 2, and so on. We currently support up to 5 levels. The user must specify a dimension type that indicates the level of the category. All cases of the same subdivision must have the same dimension type (category level).

Fields
level	ListingGroupFilterBiddingCategoryLevel Indicates the level of the category in the taxonomy.
id	int64 ID of the product bidding category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436

ProductBrand

Brand of the product.

Fields
value	string String value of the product brand.

ProductChannel

Locality of a product offer.

Fields
channel	ListingGroupFilterProductChannel Value of the locality.

ProductCondition

Condition of a product offer.

Fields
condition	ListingGroupFilterProductCondition Value of the condition.

ProductCustomAttribute

Custom attribute of a product offer.

Fields
index	ListingGroupFilterCustomAttributeIndex Indicates the index of the custom attribute.
value	string String value of the product custom attribute.

ProductItemId

Item id of a product offer.

Fields
value	string Value of the id.

ProductType

Type of a product offer.

Fields
level	ListingGroupFilterProductTypeLevel Level of the type.
value	string Value of the type.

ListingGroupFilterDimensionPath

The path defining of dimensions defining a listing group filter.

Fields
dimensions[]	ListingGroupFilterDimension The complete path of dimensions through the listing group filter hierarchy (excluding the root node) to this listing group filter.

LocationView

A location view summarizes the performance of campaigns by a Location criterion.

Fields
resource_name	string The resource name of the location view. Location view resource names have the form: customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

A Product Bidding Category.

Fields
resource_name	string The resource name of the product bidding category. Product bidding category resource names have the form: productBiddingCategoryConstants/{country_code}~{level}~{id}
level	ProductBiddingCategoryLevel Level of the product bidding category.
status	ProductBiddingCategoryStatus Status of the product bidding category.
id	int64 ID of the product bidding category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436.
country_code	string Two-letter upper-case country code of the product bidding category.
product_bidding_category_constant_parent	string Resource name of the parent product bidding category.
language_code	string Language code of the product bidding category.
localized_name	string Display value of the product bidding category localized according to language_code.

ProductGroupView

A product group view.

Fields
resource_name	string 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}

SearchAds360Field

A field or resource (artifact) used by SearchAds360Service.

Fields
resource_name	string The resource name of the artifact. Artifact resource names have the form: SearchAds360Fields/{name}
category	SearchAds360FieldCategory The category of the artifact.
selectable_with[]	string The names of all resources, segments, and metrics that are selectable with the described artifact.
attribute_resources[]	string 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.
metrics[]	string This field lists the names of all metrics that are selectable with the described artifact when it is used in the FROM clause. It is only set for artifacts whose category is RESOURCE.
segments[]	string This field lists the names of all artifacts, whether a segment or another resource, that segment metrics when included in search queries and when the described artifact is used in the FROM clause. It is only set for artifacts whose category is RESOURCE.
enum_values[]	string 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.
data_type	SearchAds360FieldDataType This field determines the operators that can be used with the artifact in WHERE clauses.
name	string The name of the artifact.
selectable	bool Whether the artifact can be used in a SELECT clause in search queries.
filterable	bool Whether the artifact can be used in a WHERE clause in search queries.
sortable	bool Whether the artifact can be used in a ORDER BY clause in search queries.
type_url	string The URL of proto describing the artifact's data type.
is_repeated	bool Whether the field artifact is repeated.

ShoppingPerformanceView

Shopping performance view. Provides Shopping campaign statistics aggregated at several product dimension levels. Product dimension values from Merchant Center such as brand, category, custom attributes, product condition and product type will reflect the state of each dimension as of the date and time when the corresponding event was recorded.

Fields
resource_name	string The resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customer_id}/shoppingPerformanceView

UserList

A user list. This is a list of users a customer may target.

Fields
resource_name	string The resource name of the user list. User list resource names have the form: customers/{customer_id}/userLists/{user_list_id}
type	UserListType Type of this list. This field is read-only.
id	int64 Id of the user list.
name	string Name of this user list. Depending on its access_reason, the user list name may not be unique (for example, if access_reason=SHARED)

UserLocationView

A user location view.

User Location View includes all metrics aggregated at the country level, one row per country. It reports metrics at the actual physical location of the user by targeted or not targeted location. If other segment fields are used, you may get more than one row per country.

Fields
resource_name	string The resource name of the user location view. UserLocation view resource names have the form: customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}
country_criterion_id	int64 Criterion Id for the country.
targeting_location	bool Indicates whether location was targeted or not.

Visit

A visit.

Fields
resource_name	string The resource name of the visit. Visit resource names have the form: customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}
id	int64 The ID of the visit.
criterion_id	int64 Search Ads 360 keyword ID. A value of 0 indicates that the keyword is unattributed.
merchant_id	int64 The Search Ads 360 inventory account ID containing the product that was clicked on. Search Ads 360 generates this ID when you link an inventory account in Search Ads 360.
ad_id	int64 Ad ID. A value of 0 indicates that the ad is unattributed.
click_id	string A unique string for each visit that is passed to the landing page as the click id URL parameter.
visit_date_time	string The timestamp of the visit event. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
product_id	string The ID of the product clicked on.
product_channel	ProductChannel The sales channel of the product that was clicked on: Online or Local.
product_language_code	string The language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product.
product_store_id	string The store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed.
product_country_code	string The country (ISO-3166 format) registered for the inventory feed that contains the product clicked on.
asset_id	int64 ID of the asset which was interacted with during the visit event.
asset_field_type	AssetFieldType Asset field type of the visit event.

WebpageView

A webpage view.

Fields
resource_name	string The resource name of the webpage view. Webpage view resource names have the form: customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}