GoogleAdsRow

从查询中返回的行。

JSON 表示法 
{
  "accountBudget": {
    object (AccountBudget)
  },
  "accountBudgetProposal": {
    object (AccountBudgetProposal)
  },
  "accountLink": {
    object (AccountLink)
  },
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdAssetCombinationView": {
    object (AdGroupAdAssetCombinationView)
  },
  "adGroupAdAssetView": {
    object (AdGroupAdAssetView)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionCustomizer": {
    object (AdGroupCriterionCustomizer)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupCriterionSimulation": {
    object (AdGroupCriterionSimulation)
  },
  "adGroupCustomizer": {
    object (AdGroupCustomizer)
  },
  "adGroupExtensionSetting": {
    object (AdGroupExtensionSetting)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "adGroupSimulation": {
    object (AdGroupSimulation)
  },
  "adParameter": {
    object (AdParameter)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "adScheduleView": {
    object (AdScheduleView)
  },
  "domainCategory": {
    object (DomainCategory)
  },
  "asset": {
    object (Asset)
  },
  "assetFieldTypeView": {
    object (AssetFieldTypeView)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupProductGroupView": {
    object (AssetGroupProductGroupView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "assetSetTypeView": {
    object (AssetSetTypeView)
  },
  "batchJob": {
    object (BatchJob)
  },
  "biddingDataExclusion": {
    object (BiddingDataExclusion)
  },
  "biddingSeasonalityAdjustment": {
    object (BiddingSeasonalityAdjustment)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "biddingStrategySimulation": {
    object (BiddingStrategySimulation)
  },
  "billingSetup": {
    object (BillingSetup)
  },
  "callView": {
    object (CallView)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignBidModifier": {
    object (CampaignBidModifier)
  },
  "campaignConversionGoal": {
    object (CampaignConversionGoal)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignCustomizer": {
    object (CampaignCustomizer)
  },
  "campaignDraft": {
    object (CampaignDraft)
  },
  "campaignExtensionSetting": {
    object (CampaignExtensionSetting)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "campaignGroup": {
    object (CampaignGroup)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "campaignSearchTermInsight": {
    object (CampaignSearchTermInsight)
  },
  "campaignSharedSet": {
    object (CampaignSharedSet)
  },
  "campaignSimulation": {
    object (CampaignSimulation)
  },
  "carrierConstant": {
    object (CarrierConstant)
  },
  "changeEvent": {
    object (ChangeEvent)
  },
  "changeStatus": {
    object (ChangeStatus)
  },
  "combinedAudience": {
    object (CombinedAudience)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "conversionGoalCampaignConfig": {
    object (ConversionGoalCampaignConfig)
  },
  "conversionValueRule": {
    object (ConversionValueRule)
  },
  "conversionValueRuleSet": {
    object (ConversionValueRuleSet)
  },
  "clickView": {
    object (ClickView)
  },
  "currencyConstant": {
    object (CurrencyConstant)
  },
  "customAudience": {
    object (CustomAudience)
  },
  "customConversionGoal": {
    object (CustomConversionGoal)
  },
  "customInterest": {
    object (CustomInterest)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerCustomizer": {
    object (CustomerCustomizer)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClientLink": {
    object (CustomerClientLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "customerConversionGoal": {
    object (CustomerConversionGoal)
  },
  "customerExtensionSetting": {
    object (CustomerExtensionSetting)
  },
  "customerFeed": {
    object (CustomerFeed)
  },
  "customerLabel": {
    object (CustomerLabel)
  },
  "customerNegativeCriterion": {
    object (CustomerNegativeCriterion)
  },
  "customerSearchTermInsight": {
    object (CustomerSearchTermInsight)
  },
  "customerUserAccess": {
    object (CustomerUserAccess)
  },
  "customerUserAccessInvitation": {
    object (CustomerUserAccessInvitation)
  },
  "customizerAttribute": {
    object (CustomizerAttribute)
  },
  "detailPlacementView": {
    object (DetailPlacementView)
  },
  "detailedDemographic": {
    object (DetailedDemographic)
  },
  "displayKeywordView": {
    object (DisplayKeywordView)
  },
  "distanceView": {
    object (DistanceView)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "expandedLandingPageView": {
    object (ExpandedLandingPageView)
  },
  "extensionFeedItem": {
    object (ExtensionFeedItem)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "feedItemSet": {
    object (FeedItemSet)
  },
  "feedItemSetLink": {
    object (FeedItemSetLink)
  },
  "feedItemTarget": {
    object (FeedItemTarget)
  },
  "feedMapping": {
    object (FeedMapping)
  },
  "feedPlaceholderView": {
    object (FeedPlaceholderView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geographicView": {
    object (GeographicView)
  },
  "groupPlacementView": {
    object (GroupPlacementView)
  },
  "hotelGroupView": {
    object (HotelGroupView)
  },
  "hotelPerformanceView": {
    object (HotelPerformanceView)
  },
  "hotelReconciliation": {
    object (HotelReconciliation)
  },
  "incomeRangeView": {
    object (IncomeRangeView)
  },
  "keywordView": {
    object (KeywordView)
  },
  "keywordPlan": {
    object (KeywordPlan)
  },
  "keywordPlanCampaign": {
    object (KeywordPlanCampaign)
  },
  "keywordPlanCampaignKeyword": {
    object (KeywordPlanCampaignKeyword)
  },
  "keywordPlanAdGroup": {
    object (KeywordPlanAdGroup)
  },
  "keywordPlanAdGroupKeyword": {
    object (KeywordPlanAdGroupKeyword)
  },
  "keywordThemeConstant": {
    object (KeywordThemeConstant)
  },
  "label": {
    object (Label)
  },
  "landingPageView": {
    object (LandingPageView)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "managedPlacementView": {
    object (ManagedPlacementView)
  },
  "mediaFile": {
    object (MediaFile)
  },
  "mobileAppCategoryConstant": {
    object (MobileAppCategoryConstant)
  },
  "mobileDeviceConstant": {
    object (MobileDeviceConstant)
  },
  "offlineUserDataJob": {
    object (OfflineUserDataJob)
  },
  "operatingSystemVersionConstant": {
    object (OperatingSystemVersionConstant)
  },
  "paidOrganicSearchTermView": {
    object (PaidOrganicSearchTermView)
  },
  "qualifyingQuestion": {
    object (QualifyingQuestion)
  },
  "parentalStatusView": {
    object (ParentalStatusView)
  },
  "perStoreView": {
    object (PerStoreView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "productLink": {
    object (ProductLink)
  },
  "recommendation": {
    object (Recommendation)
  },
  "searchTermView": {
    object (SearchTermView)
  },
  "sharedCriterion": {
    object (SharedCriterion)
  },
  "sharedSet": {
    object (SharedSet)
  },
  "smartCampaignSetting": {
    object (SmartCampaignSetting)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "smartCampaignSearchTermView": {
    object (SmartCampaignSearchTermView)
  },
  "thirdPartyAppAnalyticsLink": {
    object (ThirdPartyAppAnalyticsLink)
  },
  "topicView": {
    object (TopicView)
  },
  "travelActivityGroupView": {
    object (TravelActivityGroupView)
  },
  "travelActivityPerformanceView": {
    object (TravelActivityPerformanceView)
  },
  "experiment": {
    object (Experiment)
  },
  "experimentArm": {
    object (ExperimentArm)
  },
  "userInterest": {
    object (UserInterest)
  },
  "lifeEvent": {
    object (LifeEvent)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "remarketingAction": {
    object (RemarketingAction)
  },
  "topicConstant": {
    object (TopicConstant)
  },
  "video": {
    object (Video)
  },
  "webpageView": {
    object (WebpageView)
  },
  "leadFormSubmissionData": {
    object (LeadFormSubmissionData)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  }
}
字段
accountBudget

object (AccountBudget)

查询中的帐号预算。
accountBudgetProposal

object (AccountBudgetProposal)

查询中引用的帐号预算提案。
adGroup

object (AdGroup)

查询中引用的广告组。
adGroupAd

object (AdGroupAd)

查询中引用的广告。
adGroupAdAssetCombinationView

object (AdGroupAdAssetCombinationView)

查询中的广告组广告素材资源组合视图。
adGroupAdAssetView

object (AdGroupAdAssetView)

查询中的广告组广告素材资源视图。
adGroupAdLabel

object (AdGroupAdLabel)

查询中引用的广告组广告标签。
adGroupAsset

object (AdGroupAsset)

查询中引用的广告组素材资源。
adGroupAssetSet

object (AdGroupAssetSet)

查询中引用的广告组素材资源组。
adGroupAudienceView

object (AdGroupAudienceView)

查询中引用的广告组受众群体视图。
adGroupBidModifier

object (AdGroupBidModifier)

查询中引用的出价调节系数。
adGroupCriterion

object (AdGroupCriterion)

查询中引用的条件。
adGroupCriterionCustomizer

object (AdGroupCriterionCustomizer)

查询中引用的广告组条件定制参数。
adGroupCriterionLabel

object (AdGroupCriterionLabel)

查询中引用的广告组条件标签。
adGroupCriterionSimulation

object (AdGroupCriterionSimulation)

查询中引用的广告组条件模拟。
adGroupCustomizer

object (AdGroupCustomizer)

查询中引用的广告组定制参数。
adGroupExtensionSetting

object (AdGroupExtensionSetting)

查询中引用的广告组附加信息设置。
adGroupFeed

object (AdGroupFeed)

查询中引用的广告组 Feed。
adGroupLabel

object (AdGroupLabel)

查询中引用的广告组标签。
adGroupSimulation

object (AdGroupSimulation)

查询中提及的广告组模拟。
adParameter

object (AdParameter)

查询中引用的广告参数。
ageRangeView

object (AgeRangeView)

查询中引用的年龄段视图。
adScheduleView

object (AdScheduleView)

查询中引用的广告投放时间视图。
domainCategory

object (DomainCategory)

查询中引用的网域类别。
asset

object (Asset)

查询中引用的素材资源。
assetFieldTypeView

object (AssetFieldTypeView)

查询中引用的素材资源字段类型视图。
assetGroupAsset

object (AssetGroupAsset)

查询中引用的素材资源组素材资源。
assetGroupSignal

object (AssetGroupSignal)

查询中引用的素材资源组信号。
assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

查询中引用的素材资源组产品信息组过滤条件。
assetGroupProductGroupView

object (AssetGroupProductGroupView)

查询中引用的素材资源组产品组视图。
assetGroup

object (AssetGroup)

查询中引用的素材资源组。
assetSetAsset

object (AssetSetAsset)

查询中引用的素材资源组素材资源。
assetSet

object (AssetSet)

查询中引用的素材资源集。
assetSetTypeView

object (AssetSetTypeView)

查询中引用的素材资源集类型视图。
batchJob

object (BatchJob)

查询中引用的批量作业。
biddingDataExclusion

object (BiddingDataExclusion)

查询中引用的出价数据排除项。
biddingSeasonalityAdjustment

object (BiddingSeasonalityAdjustment)

查询中引用的出价季节性调整。
biddingStrategy

object (BiddingStrategy)

查询中引用的出价策略。
biddingStrategySimulation

object (BiddingStrategySimulation)

查询中引用的出价策略模拟。
billingSetup

object (BillingSetup)

查询中引用的结算设置。
callView

object (CallView)

查询中引用的通话视图。
campaignBudget

object (CampaignBudget)

查询中引用的广告系列预算。
campaign

object (Campaign)

查询中引用的广告系列。
campaignAsset

object (CampaignAsset)

查询中引用的广告系列素材资源。
campaignAssetSet

object (CampaignAssetSet)

查询中引用的广告系列素材资源集。
campaignAudienceView

object (CampaignAudienceView)

查询中引用的广告系列受众群体视图。
campaignBidModifier

object (CampaignBidModifier)

查询中引用的广告系列出价调节系数。
campaignConversionGoal

object (CampaignConversionGoal)

查询中引用的 CampaignConversionGoal。
campaignCriterion

object (CampaignCriterion)

查询中引用的广告系列条件。
campaignCustomizer

object (CampaignCustomizer)

查询中引用的广告系列定制参数。
campaignDraft

object (CampaignDraft)

查询中引用的广告系列草稿。
campaignExtensionSetting

object (CampaignExtensionSetting)

查询中引用的广告系列级附加信息设置。
campaignFeed

object (CampaignFeed)

查询中引用的广告系列 Feed。
campaignGroup

object (CampaignGroup)

AWQL 查询中引用的广告系列组。
campaignLabel

object (CampaignLabel)

查询中引用的广告系列标签。
campaignSearchTermInsight

object (CampaignSearchTermInsight)

查询中引用的广告系列搜索字词数据分析。
campaignSharedSet

object (CampaignSharedSet)

AWQL 查询中引用的广告系列共享集。
campaignSimulation

object (CampaignSimulation)

查询中提及的广告系列模拟。
carrierConstant

object (CarrierConstant)

查询中引用的运营商常量。
changeEvent

object (ChangeEvent)

查询中引用的 ChangeEvent。
changeStatus

object (ChangeStatus)

查询中引用的 ChangeStatus。
combinedAudience

object (CombinedAudience)

查询中引用的 CombinedAudience。
audience

object (Audience)

查询中引用的受众群体。
conversionAction

object (ConversionAction)

查询中引用的转化操作。
conversionCustomVariable

object (ConversionCustomVariable)

查询中引用的转化自定义变量。
conversionGoalCampaignConfig

object (ConversionGoalCampaignConfig)

查询中引用的 ConversionGoalCampaignConfig。
conversionValueRule

object (ConversionValueRule)

查询中引用的转化价值规则。
conversionValueRuleSet

object (ConversionValueRuleSet)

查询中引用的转化价值规则集。
clickView

object (ClickView)

查询中引用的 ClickView。
currencyConstant

object (CurrencyConstant)

查询中引用的货币常量。
customAudience

object (CustomAudience)

查询中引用的 CustomAudience。
customConversionGoal

object (CustomConversionGoal)

查询中引用的 CustomConversionGoal。
customInterest

object (CustomInterest)

查询中引用的 CustomInterest。
customer

object (Customer)

查询中引用的客户。
customerAsset

object (CustomerAsset)

查询中引用的客户素材资源。
customerAssetSet

object (CustomerAssetSet)

查询中引用的客户素材资源集。
accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

查询中引用的可访问性出价策略。
customerCustomizer

object (CustomerCustomizer)

查询中引用的客户定制参数。
customerClient

object (CustomerClient)

查询中引用的 CustomerClient。
customerConversionGoal

object (CustomerConversionGoal)

查询中引用的 CustomerConversionGoal。
customerExtensionSetting

object (CustomerExtensionSetting)

查询中引用的客户附加信息设置。
customerFeed

object (CustomerFeed)

查询中引用的客户 Feed。
customerLabel

object (CustomerLabel)

查询中引用的客户标签。
customerNegativeCriterion

object (CustomerNegativeCriterion)

查询中引用的客户排除条件。
customerSearchTermInsight

object (CustomerSearchTermInsight)

查询中引用的客户搜索字词数据分析。
customerUserAccess

object (CustomerUserAccess)

查询中引用的 CustomerUserAccess。
customerUserAccessInvitation

object (CustomerUserAccessInvitation)

查询中引用的 CustomerUserAccessInvitation。
customizerAttribute

object (CustomizerAttribute)

查询中引用的定制参数属性。
detailPlacementView

object (DetailPlacementView)

查询中引用的展示位置详情视图。
detailedDemographic

object (DetailedDemographic)

查询中引用的详细受众特征。
displayKeywordView

object (DisplayKeywordView)

查询中引用的展示广告网络关键字视图。
distanceView

object (DistanceView)

查询中引用的距离视图。
dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

查询中引用的动态搜索广告搜索字词视图。
expandedLandingPageView

object (ExpandedLandingPageView)

查询中引用的展开后着陆页视图。
extensionFeedItem

object (ExtensionFeedItem)

查询中引用的附加信息 Feed 项。
feed

object (Feed)

查询中引用的 Feed。
feedItem

object (FeedItem)

查询中引用的 Feed 项。
feedItemSet

object (FeedItemSet)

查询中引用的 Feed 项集。
feedItemTarget

object (FeedItemTarget)

查询中引用的 Feed 项目标。
feedMapping

object (FeedMapping)

查询中引用的 Feed 映射。
feedPlaceholderView

object (FeedPlaceholderView)

查询中引用的 Feed 占位符视图。
genderView

object (GenderView)

查询中引用的性别视图。
geoTargetConstant

object (GeoTargetConstant)

查询中引用的地理位置定位常量。
geographicView

object (GeographicView)

查询中引用的地理位置视图。
groupPlacementView

object (GroupPlacementView)

查询中引用的组展示位置视图。
hotelGroupView

object (HotelGroupView)

查询中引用的酒店组视图。
hotelPerformanceView

object (HotelPerformanceView)

查询中引用的酒店效果视图。
hotelReconciliation

object (HotelReconciliation)

查询中引用的酒店对账。
incomeRangeView

object (IncomeRangeView)

查询中引用的收入范围视图。
keywordView

object (KeywordView)

查询中引用的关键字视图。
keywordPlan

object (KeywordPlan)

查询中引用的关键字方案。
keywordPlanCampaign

object (KeywordPlanCampaign)

查询中引用的关键字方案广告系列。
keywordPlanCampaignKeyword

object (KeywordPlanCampaignKeyword)

查询中引用的关键字方案广告系列关键字。
keywordPlanAdGroup

object (KeywordPlanAdGroup)

查询中引用的关键字方案广告组。
keywordPlanAdGroupKeyword

object (KeywordPlanAdGroupKeyword)

查询中引用的关键字方案广告组。
keywordThemeConstant

object (KeywordThemeConstant)

查询中引用的关键字主题常量。
label

object (Label)

查询中引用的标签。
landingPageView

object (LandingPageView)

查询中引用的着陆页视图。
languageConstant

object (LanguageConstant)

查询中引用的语言常量。
locationView

object (LocationView)

查询中引用的营业地点视图。
managedPlacementView

object (ManagedPlacementView)

查询中引用的自选展示位置视图。
mediaFile

object (MediaFile)

查询中引用的媒体文件。
mobileAppCategoryConstant

object (MobileAppCategoryConstant)

查询中引用的移动应用类别常量。
mobileDeviceConstant

object (MobileDeviceConstant)

查询中引用的移动设备常量。
offlineUserDataJob

object (OfflineUserDataJob)

查询中引用的离线用户数据作业。
operatingSystemVersionConstant

object (OperatingSystemVersionConstant)

查询中引用的操作系统版本常量。
paidOrganicSearchTermView

object (PaidOrganicSearchTermView)

查询中引用的付费自然搜索字词视图。
qualifyingQuestion

object (QualifyingQuestion)

查询中引用的限定问题。
parentalStatusView

object (ParentalStatusView)

查询中引用的生育情况视图。
perStoreView

object (PerStoreView)

查询中引用的按商店视图。
productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

查询中引用的产品出价类别。
productGroupView

object (ProductGroupView)

查询中引用的产品组视图。
recommendation

object (Recommendation)

查询中引用的建议。
searchTermView

object (SearchTermView)

查询中引用的搜索字词视图。
sharedCriterion

object (SharedCriterion)

查询中引用的共享集。
sharedSet

object (SharedSet)

查询中引用的共享集。
smartCampaignSetting

object (SmartCampaignSetting)

查询中引用的智能广告系列设置。
shoppingPerformanceView

object (ShoppingPerformanceView)

查询中引用的购物效果视图。
smartCampaignSearchTermView

object (SmartCampaignSearchTermView)

查询中引用的智能广告系列搜索字词视图。
topicView

object (TopicView)

查询中引用的主题视图。
travelActivityGroupView

object (TravelActivityGroupView)

查询中引用的旅行活动组视图。
travelActivityPerformanceView

object (TravelActivityPerformanceView)

查询中引用的旅行活动表现视图。
experiment

object (Experiment)

查询中引用的实验。
experimentArm

object (ExperimentArm)

查询中引用的实验组。
userInterest

object (UserInterest)

查询中引用的用户兴趣。
lifeEvent

object (LifeEvent)

查询中引用的人生大事。
userList

object (UserList)

查询中引用的用户名单。
userLocationView

object (UserLocationView)

查询中引用的用户地理位置视图。
remarketingAction

object (RemarketingAction)

查询中引用的再营销操作。
topicConstant

object (TopicConstant)

查询中引用的主题常量。
video

object (Video)

查询中引用的视频。
webpageView

object (WebpageView)

查询中引用的网页视图。
leadFormSubmissionData

object (LeadFormSubmissionData)

查询中引用的潜在客户表单用户提交内容。
metrics

object (Metrics)

指标。
segments

object (Segments)

细分。

AccountBudget

帐号级预算。其中包含有关预算本身的信息，以及最近批准的预算更改和待审批的建议更改。可以在“pendingProposal”中找到待审批的建议更改（如果有）。有关预算的有效详情，请参见前缀为“Approved_”“adjusted_”的字段以及不带前缀的字段。由于一些有效细节可能会与用户最初请求的内容（例如支出限额）有所不同，因此这些差异会并排显示：“proposed_”“Approved_”和可能的“adjusted_”字段。

系统使用 AccountBudgetProposal 更改此资源，无法直接更改该资源。在任何给定时间，一项预算最多只能有一个待处理的提案。通过 pendingProposal 读取。

获得批准后，预算可能会发生调整，如贷记调整。调整项会导致“已批准”字段和“调整后”字段之间存在差异，这两个字段在其他情况下完全相同。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (AccountBudgetStatus),
  "totalAdjustmentsMicros": string,
  "amountServedMicros": string,
  "pendingProposal": {
    object (PendingAccountBudgetProposal)
  },
  "id": string,
  "billingSetup": string,
  "name": string,
  "proposedStartDateTime": string,
  "approvedStartDateTime": string,
  "purchaseOrderNumber": string,
  "notes": string,

  // Union field proposed_end_time can be only one of the following:
  "proposedEndDateTime": string,
  "proposedEndTimeType": enum (TimeType)
  // End of list of possible types for union field proposed_end_time.

  // Union field approved_end_time can be only one of the following:
  "approvedEndDateTime": string,
  "approvedEndTimeType": enum (TimeType)
  // End of list of possible types for union field approved_end_time.

  // Union field proposed_spending_limit can be only one of the following:
  "proposedSpendingLimitMicros": string,
  "proposedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field proposed_spending_limit.

  // Union field approved_spending_limit can be only one of the following:
  "approvedSpendingLimitMicros": string,
  "approvedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field approved_spending_limit.

  // Union field adjusted_spending_limit can be only one of the following:
  "adjustedSpendingLimitMicros": string,
  "adjustedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field adjusted_spending_limit.
}
字段
resourceName

string

仅限输出。账号级预算的资源名称。AccountBudget 资源名称的格式如下：

customers/{customerId}/accountBudgets/{account_budget_id}
status

enum (AccountBudgetStatus)

仅限输出。此账号级预算的状态。
totalAdjustmentsMicros

string (int64 format)

仅限输出。调整项总额。

例如，礼节性赠送金额就属于调整项。
amountServedMicros

string (int64 format)

仅限输出。已投放的广告的价值，以微单位表示。

这包括超额投放费用，在这种情况下，系统可能会自动向预算发放赠送金额（请参阅 totalAdjustmentsMicros）。
pendingProposal

object (PendingAccountBudgetProposal)

仅限输出。修改此预算的待处理提案（如果适用）。
id

string (int64 format)

仅限输出。账号级预算的 ID。
billingSetup

string

仅限输出。与此账号级预算关联的结算设置的资源名称。BillingSetup 资源名称采用以下格式：

customers/{customerId}/billingSetups/{billing_setup_id}
name

string

仅限输出。账号级预算的名称。
proposedStartDateTime

string

仅限输出。账号级预算的建议开始时间，采用 yyyy-MM-dd HH:mm:ss 格式。如果建议的开始时间类型为 NOW，则该时间为请求时间。
approvedStartDateTime

string

仅限输出。帐号级预算的获批开始时间，采用 yyyy-MM-dd HH:mm:ss 格式。

例如，如果新预算在建议的开始时间之后获得批准，则获批开始时间就是批准时间。
purchaseOrderNumber

string

仅限输出。采购订单编号是一个值，可帮助用户在月度账单中引用此预算。
notes

string

仅限输出。与预算相关的备注。
联合字段 proposed_end_time。账号级预算的建议结束时间。proposed_end_time 只能是下列其中一项：
proposedEndDateTime

string

仅限输出。建议的结束时间，格式为 yyyy-MM-dd HH:mm:ss。
proposedEndTimeType

enum (TimeType)

仅限输出。建议的结束时间，采用明确定义的类型，例如 FOREVER。

联合字段 approved_end_time。账号级预算已获批准的结束时间。

例如，如果预算的结束时间已更新，且提案在建议的结束时间之后获得批准，则获批的结束时间就是批准时间。approved_end_time 只能是下列其中一项：
approvedEndDateTime

string

仅限输出。已获批准的结束时间，格式为 yyyy-MM-dd HH:mm:ss。
approvedEndTimeType

enum (TimeType)

仅限输出。批准的结束时间，采用明确定义的类型，例如 FOREVER。
联合字段 proposed_spending_limit。建议的支出限额。proposed_spending_limit 只能是下列其中一项：
proposedSpendingLimitMicros

string (int64 format)

仅限输出。提议的支出限额，以微单位表示。一百万个微单位为一个单位。
proposedSpendingLimitType

enum (SpendingLimitType)

仅限输出。建议的支出限额，其类型为明确定义的类型，例如 INFINITE。

联合字段 approved_spending_limit。已获批准的支出限额。

例如，如果在提案获得批准后，帐号已支出的金额超出了建议的支出限额，则已批准的支出限额将设为已支出的金额。approved_spending_limit 只能是下列其中一项：
approvedSpendingLimitMicros

string (int64 format)

仅限输出。已批准的支出限额，以微单位表示。一百万个单位等于一个单位。仅当建议的支出限额为有限金额时，系统才会填充此字段，且始终大于或等于建议的支出限额。
approvedSpendingLimitType

enum (SpendingLimitType)

仅限输出。已批准的支出限额，定义为明确定义的类型，例如 INFINITE。仅当已获批准的支出限额为 INFINITE 时，系统才会填充此字段。

联合字段 adjusted_spending_limit。应用调整后的支出限额。调整存储在 total_adjustments_micros 中。

此值对帐号可以支出的金额拥有最终决定权。adjusted_spending_limit 只能是下列其中一项：
adjustedSpendingLimitMicros

string (int64 format)

仅限输出。调整后的支出限额，以微单位表示。一百万个微单位为一个单位。

如果批准的支出限额有限，调整后的支出限额可能会因应用于此预算的调整类型（如适用）而异。

有关各种调整项的说明，请访问：https://support.google.com/google-ads/answer/1704323

例如，借记调整项会减少帐号可以支出的金额。
adjustedSpendingLimitType

enum (SpendingLimitType)

仅限输出。调整后的支出限额，类型为明确定义的类型，例如 INFINITE。仅当调整后的支出限额为 INFINITE 时，才会填充此字段；如果批准的支出限额为 INFINITE，则保证为 true。

AccountBudgetStatus

AccountBudget 的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
PENDING 账号预算正在等待审批。
APPROVED 账号预算已获批准。
CANCELLED 用户已取消账号预算。

PendingAccountBudgetProposal

与所属帐号级预算相关联的待处理提案（如适用）。

JSON 表示法 
{
  "proposalType": enum (AccountBudgetProposalType),
  "accountBudgetProposal": string,
  "name": string,
  "startDateTime": string,
  "purchaseOrderNumber": string,
  "notes": string,
  "creationDateTime": string,

  // Union field end_time can be only one of the following:
  "endDateTime": string,
  "endTimeType": enum (TimeType)
  // End of list of possible types for union field end_time.

  // Union field spending_limit can be only one of the following:
  "spendingLimitMicros": string,
  "spendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field spending_limit.
}
字段
proposalType

enum (AccountBudgetProposalType)

仅限输出。此提案的类型，例如 END，用于结束与此提案相关联的预算。
accountBudgetProposal

string

仅限输出。提案的资源名称。AccountBudgetProposal 资源名称采用以下格式：

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id}
name

string

仅限输出。要分配给账号级预算的名称。
startDateTime

string

仅限输出。采用 yyyy-MM-dd HH:mm:ss 格式的开始时间。
purchaseOrderNumber

string

仅限输出。采购订单编号是一个值，可帮助用户在月度账单中引用此预算。
notes

string

仅限输出。与此预算关联的备注。
creationDateTime

string

仅限输出。此账号级预算提案的创建时间。格式为 yyyy-MM-dd HH:mm:ss。
联合字段 end_time。账号级预算的结束时间。end_time 只能是下列其中一项：
endDateTime

string

仅限输出。格式为 yyyy-MM-dd HH:mm:ss 的结束时间。
endTimeType

enum (TimeType)

仅限输出。结束时间，采用明确定义的类型，例如 FOREVER。
联合字段 spending_limit。支出限额。spending_limit 只能是下列其中一项：
spendingLimitMicros

string (int64 format)

仅限输出。支出限额（以微单位表示）。一百万个微单位为一个单位。
spendingLimitType

enum (SpendingLimitType)

仅限输出。支出限额，采用明确定义的类型，例如 INFINITE。

AdGroupAdAssetCombinationView

广告组广告素材资源组合使用情况视图。现在，我们仅支持将 AdGroupAdAssetCombinationView 用于自适应搜索广告，未来还将增加更多广告类型。

JSON 表示法 
{
  "resourceName": string,
  "servedAssets": [
    {
      object (AssetUsage)
    }
  ],
  "enabled": boolean
}
字段
resourceName

string

仅限输出。广告组广告素材资源组合视图的资源名称。组合 ID 的长度为 128 位，其中高 64 位存储在 asset_combination_id_high 中，低 64 位存储在 asset_combination_id_low 中。广告组广告素材资源组合视图资源名称的格式如下：customers/{customerId}/adGroupAdAssetCombinationViews/{AdGroupAd.ad_group_id}~{AdGroupAd.ad.ad_id}~{AssetCombination.asset_combination_id_low}~{AssetCombination.asset_combination_id_high}
servedAssets[]

object (AssetUsage)

仅限输出。投放的素材资源。
enabled

boolean

仅限输出。素材资源组合与广告最新版本的状态。如果为 true，则表示素材资源组合已关联到最新版本的广告。如果为 false，则表示该链接曾经存在过，但已被移除，不再出现在最新版本的广告中。

AssetUsage

包含资产的使用情况信息。

JSON 表示法 
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
字段
asset

string

资产的资源名称。
servedAssetFieldType

enum (ServedAssetFieldType)

素材资源的投放字段类型。

AdGroupAdAssetView

广告组广告与素材资源之间的关联。目前，我们仅支持将 AdGroupAdAssetView 用于应用广告和自适应搜索广告。

JSON 表示法 
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType),
  "policySummary": {
    object (AdGroupAdAssetPolicySummary)
  },
  "performanceLabel": enum (AssetPerformanceLabel),
  "pinnedField": enum (ServedAssetFieldType),
  "adGroupAd": string,
  "asset": string,
  "enabled": boolean
}
字段
resourceName

string

仅限输出。广告组广告素材资源视图的资源名称。广告组广告素材资源视图资源名称的格式为（V4 之前）：

customers/{customerId}/adGroupAdAssets/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type}

广告组广告素材资源视图资源名称采用以下格式（从 V4 开始）：

customers/{customerId}/adGroupAdAssetViews/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type}
fieldType

enum (AssetFieldType)

仅限输出。素材资源在广告中扮演的角色。
policySummary

object (AdGroupAdAssetPolicySummary)

仅限输出。广告组广告素材资源的政策信息。
performanceLabel

enum (AssetPerformanceLabel)

仅限输出。素材资源关联的效果。
pinnedField

enum (ServedAssetFieldType)

仅限输出。固定字段。
adGroupAd

string

仅限输出。与素材资源相关联的广告组广告。
asset

string

仅限输出。与广告组广告相关联的素材资源。
enabled

boolean

仅限输出。素材资源与广告最新版本的状态。如果为 true，则该素材资源已关联到最新版本的广告。如果为 false，则表示该链接曾经存在过，但已被移除，不再出现在最新版本的广告中。

AdGroupAdAssetPolicySummary

包含广告组广告素材资源的政策信息。

JSON 表示法 
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
字段
policyTopicEntries[]

object (PolicyTopicEntry)

仅限输出。广告组广告素材资源的政策发现结果列表。
reviewStatus

enum (PolicyReviewStatus)

仅限输出。此广告组广告素材资源在审核过程中所处的阶段。
approvalStatus

enum (PolicyApprovalStatus)

仅限输出。此广告组广告素材资源的整体审批状态，根据其各个政策主题条目的状态计算得出。

AdGroupAudienceView

广告组受众群体视图。包括在受众群体一级汇总的来自展示广告网络和 YouTube 广告网络广告的兴趣和再营销名单，以及搜索广告再营销名单 (RLSA) 的效果数据。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。广告组受众群体视图的资源名称。广告组受众群体视图资源名称采用以下格式：

customers/{customerId}/adGroupAudienceViews/{adGroupId}~{criterionId}

AdGroupCriterionSimulation

广告组条件模拟。下面分别列出了支持的广告渠道类型、条件类型、模拟类型和模拟修改方法组合。从 V5 开始执行酒店 IDFA 模拟操作。

  1. 展示广告 - 关键字 - 每次点击费用出价 - 统一
  2. 搜索广告 - 关键字 - 每次点击费用出价 - 统一
  3. 购物广告系列 - LISTING_GROUP - 每次点击费用出价 - 统一
  4. 酒店 - LISTING_GROUP - CPC_bid - UNIFORM
  5. 酒店 - LISTING_GROUP - PERCENT_CPC_bid - UNIFORM
JSON 表示法 
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "criterionId": string,
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "percentCpcBidPointList": {
    object (PercentCpcBidSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
字段
resourceName

string

仅限输出。广告组条件模拟的资源名称。广告组条件模拟资源名称采用以下格式：

customers/{customerId}/adGroupCriterionSimulations/{adGroupId}~{criterionId}~{type}~{modificationMethod}~{startDate}~{endDate}
type

enum (SimulationType)

仅限输出。模拟修改的字段。
modificationMethod

enum (SimulationModificationMethod)

仅限输出。模拟如何修改字段。
adGroupId

string (int64 format)

仅限输出。模拟的广告组 ID。
criterionId

string (int64 format)

仅限输出。模拟的条件 ID。
startDate

string

仅限输出。模拟所依据的第一天，采用 YYYY-MM-DD 格式。
endDate

string

仅限输出。模拟所依据的最后一天，采用 YYYY-MM-DD 格式。
联合字段 point_list。模拟点列表。point_list 只能是下列其中一项：
cpcBidPointList

object (CpcBidSimulationPointList)

仅限输出。模拟类型为 CPC_bid 时模拟的点数。
percentCpcBidPointList

object (PercentCpcBidSimulationPointList)

仅限输出。如果模拟类型为 PERCENT_CPC_BID，则模拟点数。

SimulationType

描述模拟所修改字段的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
CPC_BID 模拟时使用的是每次点击费用出价。
CPV_BID 模拟时使用的是每次观看费用出价。
TARGET_CPA 模拟时采用的是每次转化费用目标值。
BID_MODIFIER 模拟是针对出价调节系数的。
TARGET_ROAS 该模拟针对的是广告支出回报率目标值。
PERCENT_CPC_BID 模拟显示的是百分比形式的每次点击费用出价。
TARGET_IMPRESSION_SHARE 模拟的对象是展示次数份额目标。
BUDGET 模拟是针对预算的。

SimulationModificationMethod

描述模拟修改字段所用的方法的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
UNIFORM 模拟中的值会统一应用于给定资源的所有子级。系统未遵循对子资源的替换。
DEFAULT 模拟中的值已应用于给定资源。系统会遵循子资源的覆盖设置，流量估算值不包括这些资源。
SCALING 模拟中的所有值均按相同系数进行了缩放。例如，在模拟的 TargetCpa 广告系列中，广告系列目标和所有广告组目标都按 X 的系数进行了缩放。

CpcBidSimulationPointList

用于表示 CPC_Bid 类型的模拟点的容器。

JSON 表示法 
{
  "points": [
    {
      object (CpcBidSimulationPoint)
    }
  ]
}
字段
points[]

object (CpcBidSimulationPoint)

一系列每次点击费用出价金额的预计指标。

CpcBidSimulationPoint

特定每次点击费用出价金额的预计指标。

JSON 表示法 
{
  "requiredBudgetAmountMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,

  // Union field cpc_simulation_key_value can be only one of the following:
  "cpcBidMicros": string,
  "cpcBidScalingModifier": number
  // End of list of possible types for union field cpc_simulation_key_value.
}
字段
requiredBudgetAmountMicros

string (int64 format)

广告客户为获得估算的流量而必须设置的预计每日预算（以广告客户币种的微单位表示）。
biddableConversions

number

预计的可出价转化次数。
biddableConversionsValue

number

可出价转化的预计总价值。
clicks

string (int64 format)

预计点击次数。
costMicros

string (int64 format)

预计费用（以微单位表示）。
impressions

string (int64 format)

预计的展示次数。
topSlotImpressions

string (int64 format)

页首广告位的预计展示次数。只有搜索广告渠道类型支持此字段。
联合字段 cpc_simulation_key_value。当 SimulationModificationMethod = UNIFORM 或 DEFAULT 时，将设置 cpc_bid_micros。当 SimulationModificationMethod = SCALING 时，设置 cpc_bid_Scaling_modifier。cpc_simulation_key_value 只能是下列其中一项：
cpcBidMicros

string (int64 format)

预测指标所依据的模拟每次点击费用出价。
cpcBidScalingModifier

number

投影指标所依据的模拟扩缩修饰符。与模拟实体相关的所有每次点击费用出价都将根据此系数进行调节。

PercentCpcBidSimulationPointList

用于容纳 PERCENT_CPC_bid 类型的模拟的模拟点的容器。

JSON 表示法 
{
  "points": [
    {
      object (PercentCpcBidSimulationPoint)
    }
  ]
}
字段
points[]

object (PercentCpcBidSimulationPoint)

一系列百分比形式的每次点击费用出价金额的预计指标。

PercentCpcBidSimulationPoint

特定百分比形式的每次点击费用金额的预计指标。只有酒店广告渠道类型支持此字段。

JSON 表示法 
{
  "percentCpcBidMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
字段
percentCpcBidMicros

string (int64 format)

预计指标所依据的模拟每次点击费用百分比。百分比形式的每次点击费用，表示为某些商品或服务的广告宣传价格所占的比例。此处存储的值为 1,000,000 * [分数]。
biddableConversions

number

预计的可出价转化次数。
biddableConversionsValue

number

可出价转化的预计总价值（以本地货币计）。
clicks

string (int64 format)

预计点击次数。
costMicros

string (int64 format)

预计费用（以微单位表示）。
impressions

string (int64 format)

预计的展示次数。
topSlotImpressions

string (int64 format)

页首广告位的预计展示次数。

AdGroupSimulation

广告组模拟。下面分别详细介绍了支持的广告渠道类型、模拟类型和模拟修改方法组合。

  1. 搜索网络 - CPC_bid - 默认
  2. 搜索广告 - 每次点击费用出价 - 统一
  3. 搜索广告系列 - 目标每次转化费用 - 统一
  4. 搜索广告系列 - 目标广告支出回报率 - 统一
  5. 展示广告 - CPC_bid - 默认
  6. 展示广告 - 每次点击费用出价 - 统一
  7. 展示广告系列 - 目标每次转化费用 - 统一
JSON 表示法 
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "cpvBidPointList": {
    object (CpvBidSimulationPointList)
  },
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
字段
resourceName

string

仅限输出。广告组模拟的资源名称。广告组模拟资源名称采用以下格式：

customers/{customerId}/adGroupSimulations/{adGroupId}~{type}~{modificationMethod}~{startDate}~{endDate}
type

enum (SimulationType)

仅限输出。模拟修改的字段。
modificationMethod

enum (SimulationModificationMethod)

仅限输出。模拟如何修改字段。
adGroupId

string (int64 format)

仅限输出。模拟的广告组 ID。
startDate

string

仅限输出。模拟所依据的第一天，采用 YYYY-MM-DD 格式。
endDate

string

仅限输出。模拟所依据的最后一天，采用 YYYY-MM-DD 格式
联合字段 point_list。模拟点列表。point_list 只能是下列其中一项：
cpcBidPointList

object (CpcBidSimulationPointList)

仅限输出。模拟类型为 CPC_bid 时模拟的点数。
cpvBidPointList

object (CpvBidSimulationPointList)

仅限输出。模拟类型为 CPV_Bid 的模拟点数。
targetCpaPointList

object (TargetCpaSimulationPointList)

仅限输出。模拟类型为 TARGET_CPA 时，统计的模拟积分数。
targetRoasPointList

object (TargetRoasSimulationPointList)

仅限输出。如果模拟类型为 TARGET_ROAS，则模拟点数。

CpvBidSimulationPointList

用于存储类型为 CPV_Bid 的模拟的模拟点容器。

JSON 表示法 
{
  "points": [
    {
      object (CpvBidSimulationPoint)
    }
  ]
}
字段
points[]

object (CpvBidSimulationPoint)

一系列每次观看费用出价金额的预计指标。

CpvBidSimulationPoint

特定每次观看费用出价金额的预计指标。

JSON 表示法 
{
  "cpvBidMicros": string,
  "costMicros": string,
  "impressions": string,
  "views": string
}
字段
cpvBidMicros

string (int64 format)

预计每次观看费用所依据的模拟每次观看费用出价。
costMicros

string (int64 format)

预计费用（以微单位表示）。
impressions

string (int64 format)

预计的展示次数。
views

string (int64 format)

预计观看次数。

TargetCpaSimulationPointList

用于存储类型为 TARGET_CPA 的模拟的模拟点的容器。

JSON 表示法 
{
  "points": [
    {
      object (TargetCpaSimulationPoint)
    }
  ]
}
字段
points[]

object (TargetCpaSimulationPoint)

一系列目标每次转化费用金额的预计指标。

TargetCpaSimulationPoint

特定目标每次转化费用金额的预计指标。

JSON 表示法 
{
  "requiredBudgetAmountMicros": string,
  "appInstalls": number,
  "inAppActions": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,

  // Union field target_cpa_simulation_key_value can be only one of the
  // following:
  "targetCpaMicros": string,
  "targetCpaScalingModifier": number
  // End of list of possible types for union field
  // target_cpa_simulation_key_value.
}
字段
requiredBudgetAmountMicros

string (int64 format)

广告客户为获得估算的流量而必须设置的预计每日预算（以广告客户币种的微单位表示）。
appInstalls

number

应用的预计安装量。
inAppActions

number

预计的应用内操作次数。
biddableConversions

number

预计的可出价转化次数。
biddableConversionsValue

number

可出价转化的预计总价值。
clicks

string (int64 format)

预计点击次数。
costMicros

string (int64 format)

预计费用（以微单位表示）。
impressions

string (int64 format)

预计的展示次数。
topSlotImpressions

string (int64 format)

页首广告位的预计展示次数。只有搜索广告渠道类型支持此字段。
联合字段 target_cpa_simulation_key_value。当 SimulationModificationMethod = UNIFORM 或 DEFAULT 时，会设置 target_cpa_micros。当 SimulationModificationMethod = SCALING 时，会设置 target_cpa_Scaling_modifier。target_cpa_simulation_key_value 只能是下列其中一项：
targetCpaMicros

string (int64 format)

估算的目标每次转化费用所依据的模拟目标每次转化费用。
targetCpaScalingModifier

number

投影指标所依据的模拟扩缩修饰符。与模拟实体相关的所有每次转化费用目标都会由此调节系数。

TargetRoasSimulationPointList

用于存储类型为 TARGET_ROAS 的模拟的模拟点的容器。

JSON 表示法 
{
  "points": [
    {
      object (TargetRoasSimulationPoint)
    }
  ]
}
字段
points[]

object (TargetRoasSimulationPoint)

一系列目标广告支出回报率金额的预计指标。

TargetRoasSimulationPoint

特定目标广告支出回报率金额的预计指标。

JSON 表示法 
{
  "requiredBudgetAmountMicros": string,
  "targetRoas": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
字段
requiredBudgetAmountMicros

string (int64 format)

广告客户为获得估算的流量而必须设置的预计每日预算（以广告客户币种的微单位表示）。
targetRoas

number

所依据的预测性指标所依据的模拟目标广告支出回报率。
biddableConversions

number

预计的可出价转化次数。
biddableConversionsValue

number

可出价转化的预计总价值。
clicks

string (int64 format)

预计点击次数。
costMicros

string (int64 format)

预计费用（以微单位表示）。
impressions

string (int64 format)

预计的展示次数。
topSlotImpressions

string (int64 format)

页首广告位的预计展示次数。只有搜索广告渠道类型支持此字段。

AgeRangeView

年龄段视图。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。年龄段视图的资源名称。年龄段视图资源名称的格式如下：

customers/{customerId}/ageRangeViews/{adGroupId}~{criterionId}

AdScheduleView

广告投放时间视图按 AdSchedule 条件汇总了广告系列的效果。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。广告投放时间视图的资源名称。AdSchedule 视图资源名称的格式如下：

customers/{customerId}/adScheduleViews/{campaignId}~{criterionId}

DomainCategory

通过抓取网域自动生成的类别。如果广告系列使用 DynamicSearchAdsSetting，则系统将为该网域生成网域类别。可以使用 WebpageConditionInfo 来定位这些类别。请参阅：https://support.google.com/google-ads/answer/2471185

JSON 表示法 
{
  "resourceName": string,
  "campaign": string,
  "category": string,
  "languageCode": string,
  "domain": string,
  "coverageFraction": number,
  "categoryRank": string,
  "hasChildren": boolean,
  "recommendedCpcBidMicros": string
}
字段
resourceName

string

仅限输出。网域类别的资源名称。网域类别资源名称的格式如下：

customers/{customerId}/domainCategories/{campaignId}~{category_base64}~{languageCode}
campaign

string

仅限输出。此类别的推荐广告系列。
category

string

仅限输出。建议为网站网域使用类别。例如，如果您有一个电子产品网站，则类别可以是“相机”“电视”等。
languageCode

string

仅限输出。用于指定网站语言的语言代码，例如“en”表示英语。可以在动态搜索广告要求的 DynamicSearchAdsSetting 中指定语言。即您希望 Google Ads 查找您网站上的网页、为这些网页制作广告并匹配搜索时所使用的网页语言。
domain

string

仅限输出。网站的域名。可以在动态搜索广告要求的 DynamicSearchAdsSetting 中指定网域。
coverageFraction

number

仅限输出。您网站上符合此类别的网页所占的比例。
categoryRank

string (int64 format)

仅限输出。此类别在类别集中的位置。数字越小，表示此网域的匹配度越高，表示不推荐使用 null。
hasChildren

boolean

仅限输出。指明此类别是否有子类别。
recommendedCpcBidMicros

string (int64 format)

仅限输出。针对相应类别的建议每次点击费用。

AssetFieldTypeView

资产字段类型视图。当素材资源用作附加信息时，此视图会报告每种素材资源字段类型未过多统计的指标。

JSON 表示法 
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType)
}
字段
resourceName

string

仅限输出。资产字段类型视图的资源名称。资产字段类型视图资源名称的格式如下：

customers/{customerId}/assetFieldTypeViews/{fieldType}
fieldType

enum (AssetFieldType)

仅限输出。资产字段类型视图的资产字段类型。

AssetGroupProductGroupView

素材资源组产品组视图。

JSON 表示法 
{
  "resourceName": string,
  "assetGroup": string,
  "assetGroupListingGroupFilter": string
}
字段
resourceName

string

仅限输出。素材资源组产品组视图的资源名称。素材资源组产品组视图资源名称采用以下格式：

customers/{customerId}/assetGroupProductGroupViews/{asset_group_id}~{listing_group_filter_id}
assetGroup

string

仅限输出。与产品信息组过滤条件相关联的素材资源组。
assetGroupListingGroupFilter

string

仅限输出。素材资源组产品信息组过滤条件的资源名称。

AssetSetTypeView

素材资源集类型视图。此视图会报告各类素材资源中未出现过多的指标。此报告不包含子素材资源集类型。其统计信息会汇总到父级素材资源集类型下。

JSON 表示法 
{
  "resourceName": string,
  "assetSetType": enum (AssetSetType)
}
字段
resourceName

string

仅限输出。资产集类型视图的资源名称。素材资源组类型视图资源名称采用以下格式：

customers/{customerId}/assetSetTypeViews/{assetSetType}
assetSetType

enum (AssetSetType)

仅限输出。素材资源组类型视图的素材资源集类型。

BiddingStrategySimulation

出价策略模拟。下面分别详细介绍了模拟类型和模拟修改方法支持的组合。

  1. 目标每次转化费用 - 统一
  2. 目标广告支出回报率 - 统一
JSON 表示法 
{
  "resourceName": string,
  "biddingStrategyId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
字段
resourceName

string

仅限输出。出价策略模拟的资源名称。出价策略模拟资源名称的格式如下：

customers/{customerId}/biddingStrategySimulations/{biddingStrategyId}~{type}~{modificationMethod}~{startDate}~{endDate}
biddingStrategyId

string (int64 format)

仅限输出。模拟的出价策略共享集 ID。
type

enum (SimulationType)

仅限输出。模拟修改的字段。
modificationMethod

enum (SimulationModificationMethod)

仅限输出。模拟如何修改字段。
startDate

string

仅限输出。模拟所依据的第一天，采用 YYYY-MM-DD 格式。
endDate

string

仅限输出。模拟所依据的最后一天，采用 YYYY-MM-DD 格式
联合字段 point_list。模拟点列表。point_list 只能是下列其中一项：
targetCpaPointList

object (TargetCpaSimulationPointList)

仅限输出。模拟类型为 TARGET_CPA 时，统计的模拟积分数。
targetRoasPointList

object (TargetRoasSimulationPointList)

仅限输出。如果模拟类型为 TARGET_ROAS，则模拟点数。

CallView

一种来电视图，其中包含用于对来电专用广告或附加电话信息进行来电跟踪的数据。

JSON 表示法 
{
  "resourceName": string,
  "callerCountryCode": string,
  "callerAreaCode": string,
  "callDurationSeconds": string,
  "startCallDateTime": string,
  "endCallDateTime": string,
  "callTrackingDisplayLocation": enum (CallTrackingDisplayLocation),
  "type": enum (CallType),
  "callStatus": enum (GoogleVoiceCallStatus)
}
字段
resourceName

string

仅限输出。调用视图的资源名称。调用视图资源名称采用以下格式：

customers/{customerId}/callViews/{call_detail_id}
callerCountryCode

string

仅限输出。来电者的国家/地区代码。
callerAreaCode

string

仅限输出。来电者的区号。如果通话时长短于 15 秒，则为 null。
callDurationSeconds

string (int64 format)

仅限输出。广告主提供的通话时长（以秒为单位）。
startCallDateTime

string

仅限输出。广告客户提供的调用开始日期时间。
endCallDateTime

string

仅限输出。广告客户提供的调用结束时间。
callTrackingDisplayLocation

enum (CallTrackingDisplayLocation)

仅限输出。来电跟踪的显示位置。
type

enum (CallType)

仅限输出。调用的类型。
callStatus

enum (GoogleVoiceCallStatus)

仅限输出。调用的状态。

CallTrackingDisplayLocation

可能的来电跟踪显示位置。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
AD 广告促成的来电。
LANDING_PAGE 从着陆页广告所指向的电话。

CallType

发出调用的可能属性类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
MANUALLY_DIALED 来电是手动拨打的。

GoogleVoiceCallStatus

Google 语音通话的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
MISSED 您错过了来电。
RECEIVED 接到了来电。

CampaignAudienceView

广告系列受众群体视图。包括来自展示广告网络和 YouTube 广告网络广告的兴趣和再营销名单，以及搜索广告再营销名单 (RLSA) 的效果数据，这些数据按广告系列和受众群体条件进行了汇总。此视图仅包含在广告系列一级附加的受众群体。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。广告系列受众群体视图的资源名称。广告系列受众群体视图资源名称采用以下格式：

customers/{customerId}/campaignAudienceViews/{campaignId}~{criterionId}

CampaignSearchTermInsight

广告系列搜索字词视图。历史数据从 2023 年 3 月开始提供。

JSON 表示法 
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string,
  "campaignId": string
}
字段
resourceName

string

仅限输出。广告系列级搜索字词数据分析的资源名称。广告系列级搜索字词数据分析资源名称采用以下格式：

customers/{customerId}/campaignSearchTermInsights/{campaignId}~{categoryId}
categoryLabel

string

仅限输出。搜索类别的标签。空字符串表示不属于其他类别的搜索字词的无限类别。
id

string (int64 format)

仅限输出。数据分析的 ID。
campaignId

string (int64 format)

仅限输出。广告系列的 ID。

CampaignSimulation

广告系列模拟。下面分别详细介绍了支持的广告渠道类型、模拟类型和模拟修改方法组合。

  • 搜索广告 - 每次点击费用出价 - 统一
  • 搜索广告系列 - 每次点击费用出价 - 扩展
  • 搜索广告系列 - 目标每次转化费用 - 统一
  • 搜索广告系列 - 目标每次转化费用 - 扩展
  • 搜索广告系列 - 目标广告支出回报率 - 统一
  • 搜索广告系列 - 目标展示次数份额 - 统一
  • 搜索广告系列 - 预算 - 统一
  • 购物广告 - 预算 - 统一
  • 购物广告系列 - 目标广告支出回报率 - 统一
  • 多渠道 - 目标每次转化费用 - 统一
  • 多渠道 - 目标广告支出回报率 - 统一
  • 发现广告系列 - 目标每次转化费用 - 默认
  • 展示广告系列 - 目标每次转化费用 - 统一
  • 效果最大化广告系列 - 目标每次转化费用 - 统一
  • 效果最大化广告系列 - 目标广告支出回报率 - 统一
  • PERFORMANCE_MAX - 预算 - 统一
JSON 表示法 
{
  "resourceName": string,
  "campaignId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  },
  "targetImpressionSharePointList": {
    object (TargetImpressionShareSimulationPointList)
  },
  "budgetPointList": {
    object (BudgetSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
字段
resourceName

string

仅限输出。广告系列模拟的资源名称。广告系列模拟资源名称的格式如下：

customers/{customerId}/campaignSimulations/{campaignId}~{type}~{modificationMethod}~{startDate}~{endDate}
campaignId

string (int64 format)

仅限输出。模拟的广告系列 ID。
type

enum (SimulationType)

仅限输出。模拟修改的字段。
modificationMethod

enum (SimulationModificationMethod)

仅限输出。模拟如何修改字段。
startDate

string

仅限输出。模拟所依据的第一天，采用 YYYY-MM-DD 格式。
endDate

string

仅限输出。模拟所依据的最后一天，采用 YYYY-MM-DD 格式
联合字段 point_list。模拟点列表。point_list 只能是下列其中一项：
cpcBidPointList

object (CpcBidSimulationPointList)

仅限输出。模拟类型为 CPC_bid 时模拟的点数。
targetCpaPointList

object (TargetCpaSimulationPointList)

仅限输出。模拟类型为 TARGET_CPA 时，统计的模拟积分数。
targetRoasPointList

object (TargetRoasSimulationPointList)

仅限输出。如果模拟类型为 TARGET_ROAS，则模拟点数。
targetImpressionSharePointList

object (TargetImpressionShareSimulationPointList)

仅限输出。模拟类型为 TARGET_IMPRESSION_SHARE 的模拟点。
budgetPointList

object (BudgetSimulationPointList)

仅限输出。模拟类型为 BUDGET 时模拟的积分数。

TargetImpressionShareSimulationPointList

用于存储 TARGET_IMPRESSION_SHARE 类型模拟的模拟点的容器。

JSON 表示法 
{
  "points": [
    {
      object (TargetImpressionShareSimulationPoint)
    }
  ]
}
字段
points[]

object (TargetImpressionShareSimulationPoint)

特定目标展示次数份额值的预计指标。

TargetImpressionShareSimulationPoint

特定目标展示次数份额值的预计指标。

JSON 表示法 
{
  "targetImpressionShareMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "requiredBudgetAmountMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "absoluteTopImpressions": string
}
字段
targetImpressionShareMicros

string (int64 format)

预计指标所依据的模拟的目标展示次数份额值（以微单位表示）。例如，10% 的展示次数份额（等于 0.1）存储为 100_000。该值已经过验证，不会超过 100 万 (100%)。
requiredCpcBidCeilingMicros

string (int64 format)

广告客户为实现此模拟而必须设置的预计每日每次点击费用出价上限（以广告客户币种的微单位表示）。
requiredBudgetAmountMicros

string (int64 format)

广告客户为获得估算的流量而必须设置的预计每日预算（以广告客户币种的微单位表示）。
biddableConversions

number

预计的可出价转化次数。
biddableConversionsValue

number

可出价转化的预计总价值。
clicks

string (int64 format)

预计点击次数。
costMicros

string (int64 format)

预计费用（以微单位表示）。
impressions

string (int64 format)

预计的展示次数。
topSlotImpressions

string (int64 format)

页首广告位的预计展示次数。只有搜索广告渠道类型支持此字段。
absoluteTopImpressions

string (int64 format)

预计的绝对页首展示次数。只有搜索广告渠道类型支持此字段。

BudgetSimulationPointList

用于存储类型为 BUDGET 的模拟的模拟点的容器。

JSON 表示法 
{
  "points": [
    {
      object (BudgetSimulationPoint)
    }
  ]
}
字段
points[]

object (BudgetSimulationPoint)

一系列预算金额的预计指标。

BudgetSimulationPoint

特定预算金额的预计指标。

JSON 表示法 
{
  "budgetAmountMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
字段
budgetAmountMicros

string (int64 format)

预计指标所依据的模拟预算。
requiredCpcBidCeilingMicros

string (int64 format)

广告客户为实现此模拟而必须设置的预计每日每次点击费用出价上限（以广告客户币种的微单位表示）。只有采用“目标支出”出价策略的广告系列支持此字段。
biddableConversions

number

预计的可出价转化次数。
biddableConversionsValue

number

可出价转化的预计总价值。
clicks

string (int64 format)

预计点击次数。
costMicros

string (int64 format)

预计费用（以微单位表示）。
impressions

string (int64 format)

预计的展示次数。
topSlotImpressions

string (int64 format)

页首广告位的预计展示次数。只有搜索广告渠道类型支持此字段。

CarrierConstant

可以在广告系列定位中使用的运营商条件。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "countryCode": string
}
字段
resourceName

string

仅限输出。运营商标准的资源名称。运营商条件资源名称的格式如下：

carrierConstants/{criterionId}
id

string (int64 format)

仅限输出。运营商标准的 ID。
name

string

仅限输出。运输公司的全名（英文）。
countryCode

string

仅限输出。运营商所在国家/地区的国家/地区代码，例如“AR”“FR”等。

ChangeEvent

描述某些资源类型的所返回资源的精细变化。过去 30 天内通过界面或 API 所做的更改都包含在内。系统会显示已更改字段的旧值和新值。ChangeEvent 最长可能会有 3 分钟的延迟来反映新的更改。

JSON 表示法 
{
  "resourceName": string,
  "changeDateTime": string,
  "changeResourceType": enum (ChangeEventResourceType),
  "changeResourceName": string,
  "clientType": enum (ChangeClientType),
  "userEmail": string,
  "oldResource": {
    object (ChangedResource)
  },
  "newResource": {
    object (ChangedResource)
  },
  "resourceChangeOperation": enum (ResourceChangeOperation),
  "changedFields": string,
  "campaign": string,
  "adGroup": string,
  "feed": string,
  "feedItem": string,
  "asset": string
}
字段
resourceName

string

仅限输出。更改事件的资源名称。更改事件资源名称采用以下格式：

customers/{customerId}/changeEvents/{timestamp_micros}~{command_index}~{mutate_index}
changeDateTime

string

仅限输出。在此资源上提交更改的时间。
changeResourceType

enum (ChangeEventResourceType)

仅限输出。更改后的资源的类型。此参数指示将在 oldResource 和 newResource 中设置什么资源。
changeResourceName

string

仅限输出。发生此更改的只是资源。
clientType

enum (ChangeClientType)

仅限输出。进行更改的位置。
userEmail

string

仅限输出。进行此项更改的用户的电子邮件地址。
oldResource

object (ChangedResource)

仅限输出。更改前的旧资源。只有已更改的字段才会填充。
newResource

object (ChangedResource)

仅限输出。更改后的新资源。只有已更改的字段才会填充。
resourceChangeOperation

enum (ResourceChangeOperation)

仅限输出。对已更改的资源执行的操作。
changedFields

string (FieldMask format)

仅限输出。返回的资源中发生更改的字段列表。

这是以英文逗号分隔的完全限定字段名称列表。示例："user.displayName,photo"。
campaign

string

仅限输出。受此更改影响的广告系列。
adGroup

string

仅限输出。受此更改影响的广告组。
feed

string

仅限输出。受此更改影响的 Feed。
feedItem

string

仅限输出。受此更改影响的 FeedItem。
asset

string

仅限输出。受此更改影响的资产。

ChangeEventResourceType

列出 ChangeEvent 资源支持的资源类型的枚举。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中未知的未分类资源。
AD 广告素材资源更改。
AD_GROUP 广告组资源更改。
AD_GROUP_CRITERION CocoaPods 资源更改。
CAMPAIGN 广告系列资源更改。
CAMPAIGN_BUDGET CampaignBudget 资源更改。
AD_GROUP_BID_MODIFIER 广告组 BidModifier 资源更改。
CAMPAIGN_CRITERION Campaigncriteria 资源发生变化。
FEED Feed 资源发生变化。
FEED_ITEM FeedItem 资源发生变化。
CAMPAIGN_FEED CampaignFeed 资源发生变化。
AD_GROUP_FEED 广告组 Feed 资源更改。
AD_GROUP_AD 广告组广告资源更改。
ASSET 一项资产资源更改。
CUSTOMER_ASSET CustomerAsset 资源变更。
CAMPAIGN_ASSET CampaignAsset 资源发生更改。
AD_GROUP_ASSET 广告组素材资源资源更改。
ASSET_SET AssetSet 资源更改。
ASSET_SET_ASSET AssetSetAsset 资源更改。
CAMPAIGN_ASSET_SET CampaignAssetSet 资源发生更改。

ChangeClientType

changeEvent 资源的来源。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中未知的未分类客户端类型。
GOOGLE_ADS_WEB_CLIENT 通过“ads.google.com”所做的更改。例如，通过广告系列管理所做的更改。
GOOGLE_ADS_AUTOMATED_RULE 通过 Google Ads 自动规则进行的更改。
GOOGLE_ADS_SCRIPTS 通过 Google Ads 脚本所做的更改。
GOOGLE_ADS_BULK_UPLOAD 通过 Google Ads 批量上传所做的更改。
GOOGLE_ADS_API Google Ads API 所做的更改。
GOOGLE_ADS_EDITOR 由 Google Ads 编辑器所做的更改。此值为占位符。API 不会返回这些更改。
GOOGLE_ADS_MOBILE_APP Google Ads 移动应用所做的更改。
GOOGLE_ADS_RECOMMENDATIONS 通过 Google Ads 建议所做的更改。
SEARCH_ADS_360_SYNC 通过 Search Ads 360 同步所做的更改。
SEARCH_ADS_360_POST 通过 Search Ads 360 发布所做的更改。
INTERNAL_TOOL 通过内部工具进行的更改。例如，如果用户在广告系列等实体上设置网址模板，系统便会使用 SA360 Clickserver 网址自动封装此模板。
OTHER 未分类的更改类型，例如，通过 Google Ads 兑换优惠券所做的更改。

ChangedResource

提供所有受支持资源的封装容器 proto。系统将仅设置 changeResourceType 的资源。

JSON 表示法 
{
  "ad": {
    object (Ad)
  },
  "adGroup": {
    object (AdGroup)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "asset": {
    object (Asset)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  }
}
字段
ad

object (Ad)

仅限输出。当 changeResourceType == AD 时设置。
adGroup

object (AdGroup)

仅限输出。当 changeResourceType == AD_GROUP 时设置。
adGroupCriterion

object (AdGroupCriterion)

仅限输出。当 changeResourceType == AD_GROUP_CRITERION 时设置。
campaign

object (Campaign)

仅限输出。当 changeResourceType == CAMPAIGN 时设置。
campaignBudget

object (CampaignBudget)

仅限输出。当 changeResourceType == CAMPAIGN_BUDGET 时设置。
adGroupBidModifier

object (AdGroupBidModifier)

仅限输出。当 changeResourceType == AD_GROUP_BID_MODIFIER 时设置。
campaignCriterion

object (CampaignCriterion)

仅限输出。当 changeResourceType == CAMPAIGN_CRITERION 时设置。
feed

object (Feed)

仅限输出。当 changeResourceType == FEED 时设置。
feedItem

object (FeedItem)

仅限输出。当 changeResourceType == FEED_ITEM 时设置。
campaignFeed

object (CampaignFeed)

仅限输出。当 changeResourceType == CAMPAIGN_FEED 时设置。
adGroupFeed

object (AdGroupFeed)

仅限输出。当 changeResourceType == AD_GROUP_FEED 时设置。
adGroupAd

object (AdGroupAd)

仅限输出。当 changeResourceType == AD_GROUP_AD 时设置。
asset

object (Asset)

仅限输出。当 changeResourceType == ASSET 时设置。
customerAsset

object (CustomerAsset)

仅限输出。当 changeResourceType == CUSTOMER_ASSET 时设置。
campaignAsset

object (CampaignAsset)

仅限输出。当 changeResourceType == CAMPAIGN_ASSET 时设置。
adGroupAsset

object (AdGroupAsset)

仅限输出。当 changeResourceType == AD_GROUP_ASSET 时设置。
assetSet

object (AssetSet)

仅限输出。当 changeResourceType == ASSET_SET 时设置。
assetSetAsset

object (AssetSetAsset)

仅限输出。当 changeResourceType == ASSET_SET_ASSET 时设置。
campaignAssetSet

object (CampaignAssetSet)

仅限输出。当 changeResourceType == CAMPAIGN_ASSET_SET 时设置。

ResourceChangeOperation

对 changeEvent 资源中已更改的资源执行的操作。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中未知的未分类操作。
CREATE 已创建资源。
UPDATE 资源已修改。
REMOVE 已移除资源。

ChangeStatus

描述返回资源的状态。ChangeStatus 最多可能延迟 3 分钟才能反映新更改。

JSON 表示法 
{
  "resourceName": string,
  "resourceType": enum (ChangeStatusResourceType),
  "resourceStatus": enum (ChangeStatusOperation),
  "sharedSet": string,
  "campaignSharedSet": string,
  "asset": string,
  "customerAsset": string,
  "campaignAsset": string,
  "adGroupAsset": string,
  "combinedAudience": string,
  "lastChangeDateTime": string,
  "campaign": string,
  "adGroup": string,
  "adGroupAd": string,
  "adGroupCriterion": string,
  "campaignCriterion": string,
  "feed": string,
  "feedItem": string,
  "adGroupFeed": string,
  "campaignFeed": string,
  "adGroupBidModifier": string
}
字段
resourceName

string

仅限输出。更改状态的资源名称。更改状态资源名称采用以下格式：

customers/{customerId}/changeStatus/{change_status_id}
resourceType

enum (ChangeStatusResourceType)

仅限输出。表示更改后的资源的类型。它决定了要设置哪些字段。例如，对于 AD_GROUP，将设置 campaign 和 adGroup 字段。
resourceStatus

enum (ChangeStatusOperation)

仅限输出。表示已更改资源的状态。
sharedSet

string

仅限输出。受此更改影响的 SharedSet。
campaignSharedSet

string

仅限输出。受此更改影响的 CampaignSharedSet。
asset

string

仅限输出。受此更改影响的资产。
customerAsset

string

仅限输出。受此更改影响的 CustomerAsset。
campaignAsset

string

仅限输出。受此更改影响的 CampaignAsset。
adGroupAsset

string

仅限输出。受此更改影响的 AdGroupAsset。
combinedAudience

string

仅限输出。受此更改影响的 CombinedAudience。
lastChangeDateTime

string

仅限输出。此资源最近更改发生的时间。
campaign

string

仅限输出。受此更改影响的广告系列。
adGroup

string

仅限输出。受此更改影响的广告组。
adGroupAd

string

仅限输出。受此更改影响的 AdGroupAd。
adGroupCriterion

string

仅限输出。受此更改影响的 CocoaPods。
campaignCriterion

string

仅限输出。受此更改影响的 CampaignCondition。
feed

string

仅限输出。受此更改影响的 Feed。
feedItem

string

仅限输出。受此更改影响的 FeedItem。
adGroupFeed

string

仅限输出。受此更改影响的 AdGroupFeed。
campaignFeed

string

仅限输出。受此更改影响的 CampaignFeed。
adGroupBidModifier

string

仅限输出。受此更改影响的 AdGroupBidModifier。

ChangeStatusResourceType

列出 ChangeStatus 资源支持的资源类型的枚举。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中未知的未分类资源。
AD_GROUP 广告组资源更改。
AD_GROUP_AD 广告组广告资源更改。
AD_GROUP_CRITERION CocoaPods 资源更改。
CAMPAIGN 广告系列资源更改。
CAMPAIGN_CRITERION Campaigncriteria 资源发生变化。
FEED Feed 资源发生变化。
FEED_ITEM FeedItem 资源发生变化。
AD_GROUP_FEED 广告组 Feed 资源更改。
CAMPAIGN_FEED CampaignFeed 资源发生变化。
AD_GROUP_BID_MODIFIER 广告组 BidModifier 资源更改。
SHARED_SET SharedSet 资源变更。
CAMPAIGN_SHARED_SET CampaignSharedSet 资源发生更改。
ASSET 一项资产资源更改。
CUSTOMER_ASSET CustomerAsset 资源变更。
CAMPAIGN_ASSET CampaignAsset 资源发生更改。
AD_GROUP_ASSET 广告组素材资源资源更改。
COMBINED_AUDIENCE 一项 CombinedAudience 资源更改。

ChangeStatusOperation

更改后的资源的状态

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中未知的未分类资源。
ADDED 已创建资源。
CHANGED 资源已修改。
REMOVED 已移除资源。

CombinedAudience

为包含不同受众群体的组合受众群体描述资源。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "status": enum (CombinedAudienceStatus),
  "name": string,
  "description": string
}
字段
resourceName

string

不可变。组合的受众群体的资源名称。组合的受众群体名称采用以下格式：

customers/{customerId}/combinedAudience/{combined_audience_id}
id

string (int64 format)

仅限输出。组合的受众群体的 ID。
status

enum (CombinedAudienceStatus)

仅限输出。此组合受众群体的状态。指明组合的受众群体是已启用还是已移除。
name

string

仅限输出。组合的受众群体的名称。它在所有组合的受众群体中应该是唯一的。
description

string

仅限输出。此组合受众群体的说明。

CombinedAudienceStatus

包含可能的组合受众群体状态类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ENABLED 已启用 - 组合的受众群体已启用，可以定位。
REMOVED “已移除”状态 - 组合的受众群体已被移除，无法用于定位。

ClickView

点击视图，其中包含每个点击级别的汇总指标，包括有效点击和无效点击。对于非搜索广告系列，metrics.clicks 表示有效和无效互动次数。包含 ClickView 的查询必须具有过滤条件，且只能将结果限制为一天，并且可请求过去 90 天内返回的结果。

JSON 表示法 
{
  "resourceName": string,
  "areaOfInterest": {
    object (ClickLocation)
  },
  "locationOfPresence": {
    object (ClickLocation)
  },
  "keyword": string,
  "keywordInfo": {
    object (KeywordInfo)
  },
  "gclid": string,
  "pageNumber": string,
  "adGroupAd": string,
  "campaignLocationTarget": string,
  "userList": string
}
字段
resourceName

string

仅限输出。点击视图的资源名称。点击“查看资源名称”，格式如下：

customers/{customerId}/clickViews/{date (yyyy-MM-dd)}~{gclid}
areaOfInterest

object (ClickLocation)

仅限输出。与展示相关联的感兴趣区域匹配的地理位置条件。
locationOfPresence

object (ClickLocation)

仅限输出。与展示相关联的广告展示地理位置匹配的地理位置条件。
keyword

string

仅限输出。关联的关键字（如果存在），且点击对应于“搜索”渠道。
keywordInfo

object (KeywordInfo)

仅限输出。关联关键字的基本信息（如果存在）。
gclid

string

仅限输出。Google 点击 ID。
pageNumber

string (int64 format)

仅限输出。展示广告的页面在搜索结果中的页码。
adGroupAd

string

仅限输出。关联的广告。
campaignLocationTarget

string

仅限输出。关联的广告系列地理位置定位目标（如果存在）。
userList

string

仅限输出。关联的用户名单（如果存在）。

ClickLocation

与点击相关联的地理位置条件。

JSON 表示法 
{
  "city": string,
  "country": string,
  "metro": string,
  "mostSpecific": string,
  "region": string
}
字段
city

string

与展示相关联的城市地理位置条件。
country

string

与展示相关联的国家/地区地理位置条件。
metro

string

与展示相关联的都市圈地理位置条件。
mostSpecific

string

与展示相关联的最具体的地理位置条件。
region

string

与展示相关联的地区地理位置条件。

CurrencyConstant

货币常数。

JSON 表示法 
{
  "resourceName": string,
  "code": string,
  "name": string,
  "symbol": string,
  "billableUnitMicros": string
}
字段
resourceName

string

仅限输出。货币常量的资源名称。货币常量资源名称的格式如下：

currencyConstants/{code}
code

string

仅限输出。由三个字母组成的 ISO 4217 货币代码，例如“USD”
name

string

仅限输出。货币的英文全称。
symbol

string

仅限输出。用于描述此货币的标准符号，例如，“$”表示美元。
billableUnitMicros

string (int64 format)

仅限输出。此货币的可结算单位。结算金额应为此值的倍数。

AccessibleBiddingStrategy

表示归客户所有并与客户共享的出价策略的视图。

与 BiddingStrategy 相反，该资源还包含该客户拥有的策略以及归该客户的经理所有并已共享给该客户的策略。该资源不提供指标，仅公开了一部分 BiddingStrategy 属性。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
字段
resourceName

string

仅限输出。可访问的出价策略的资源名称。AccessibleBiddingStrategy 资源名称采用以下格式：

customers/{customerId}/accessibleBiddingStrategies/{biddingStrategyId}
id

string (int64 format)

仅限输出。出价策略的 ID。
name

string

仅限输出。出价策略的名称。
type

enum (BiddingStrategyType)

仅限输出。出价策略的类型。
ownerCustomerId

string (int64 format)

仅限输出。拥有出价策略的客户的 ID。
ownerDescriptiveName

string

仅限输出。拥有出价策略的客户的描述性名称。

联合字段 scheme。出价方案。

只能设置一个。scheme 只能是下列其中一项：
maximizeConversionValue

object (MaximizeConversionValue)

仅限输出。一种自动出价策略，可帮助您在不超出预算的前提下，为广告系列争取尽可能高的转化价值。
maximizeConversions

object (MaximizeConversions)

仅限输出。一种自动出价策略，可帮助您在不超出预算的前提下，为广告系列争取尽可能多的转化。
targetCpa

object (TargetCpa)

仅限输出。这种出价策略会设置适当的出价，在将每次转化费用 (CPA) 控制在您设定的目标水平的前提下，帮助您争取尽可能多的转化。
targetImpressionShare

object (TargetImpressionShare)

仅限输出。一种出价策略，可自动针对选定百分比的展示次数进行优化。
targetRoas

object (TargetRoas)

仅限输出。一种出价策略，可帮助您最大限度地提高收入，同时确保平均达到特定目标广告支出回报率 (ROAS)。
targetSpend

object (TargetSpend)

仅限输出。一种出价策略，用于为您设置适当的出价，在不超出预算的前提下为您争取尽可能多的点击。

MaximizeConversionValue

一种自动出价策略，可帮助您在不超出预算的前提下，为广告系列争取尽可能高的转化价值。

JSON 表示法 
{
  "targetRoas": number
}
字段
targetRoas

number

仅限输出。目标广告支出回报率 (ROAS) 选项。如果设置此选项，出价策略会最大限度地增加收入，同时使目标广告支出回报率达到平均值。如果目标广告支出回报率较高，则出价策略可能无法支出所有预算。如果未设置目标广告支出回报率，则出价策略的目标是尽可能为预算实现最高的广告支出回报率。

MaximizeConversions

一种自动出价策略，可帮助您在不超出预算的前提下，为广告系列争取尽可能多的转化。

JSON 表示法 
{
  "targetCpaMicros": string
}
字段
targetCpaMicros

string (int64 format)

仅限输出。目标每次转化费用 (CPA) 选项。这是您愿意为每次转化支付的平均金额。

TargetCpa

一种自动出价策略，可为您设置合适的出价来帮助您争取尽可能多的转化，同时将每次转化费用控制在您设定的目标水平。

JSON 表示法 
{
  "targetCpaMicros": string
}
字段
targetCpaMicros

string (int64 format)

仅限输出。平均每次转化费用目标。此目标应大于或等于基于账号币种的最低计费单元。

TargetImpressionShare

一种自动出价策略，它会设置出价，使特定百分比的搜索广告展示在首页（或其他定位到的地理位置）的顶部。

JSON 表示法 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
字段
location

enum (TargetImpressionShareLocation)

仅限输出。搜索结果页上的定位到的地理位置。
locationFractionMicros

string (int64 format)

选择在定位到的地理位置展示的广告所占的比例（以微单位表示）。例如，1% 等于 10,000。
cpcBidCeilingMicros

string (int64 format)

仅限输出。自动出价系统可以指定的最高每次点击费用出价。这是由广告客户输入的必填字段，该字段用于设置上限值，并以本地微单位指定。

TargetRoas

一种自动出价策略，可帮助您尽可能提高收入，同时确保平均达到特定目标广告支出回报率 (ROAS)。

JSON 表示法 
{
  "targetRoas": number
}
字段
targetRoas

number

仅限输出。所选单位支出的收入（基于转化数据）。

TargetSpend

这是一种自动出价策略，可为您设置适当的出价，助您在不超出预算的前提下为您争取尽可能多的点击。

JSON 表示法 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
字段
targetSpendMicros
(deprecated)

string (int64 format)

仅限输出。尽可能争取更多点击次数的支出目标。TargetSpend 出价工具会尝试支出该值或自然限制支出金额中较低的金额。如果未指定，则预算会被用作支出目标。 此字段已弃用，不应继续使用。如需了解详情，请参阅 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。
cpcBidCeilingMicros

string (int64 format)

仅限输出。可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。

CustomerClient

指定客户与现有客户之间的关联。只有经理客户才能拥有 CustomerClient。包括所有直接和间接客户以及经理本身。

JSON 表示法 
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
字段
resourceName

string

仅限输出。客户客户端的资源名称。CustomerClient 资源名称采用以下格式：customers/{customerId}/customerClients/{client_customer_id}
appliedLabels[]

string

仅限输出。发出请求的客户所拥有的标签（应用于该客户）的资源名称。标签资源名称采用以下形式：

customers/{customerId}/labels/{label_id}
status

enum (CustomerStatus)

仅限输出。该客户的状态。只读。
clientCustomer

string

仅限输出。与指定客户相关联的客户-客户的资源名称。只读。
hidden

boolean

仅限输出。指明此账号是否为隐藏账号。只读。
level

string (int64 format)

仅限输出。给定客户与客户之间的距离。对于自链接，级别值为 0。只读。
timeZone

string

仅限输出。客户端时区的通用语言区域数据存储库 (CLDR) 字符串表示，例如，America/Los_Angeles。只读。
testAccount

boolean

仅限输出。指明该客户是否为测试账号。只读。
manager

boolean

仅限输出。指明客户是否为经理。只读。
descriptiveName

string

仅限输出。客户的描述性名称。只读。
currencyCode

string

仅限输出。客户的货币代码（例如“USD”“EUR”）。只读。
id

string (int64 format)

仅限输出。客户客户的 ID。只读。

CustomerSearchTermInsight

客户搜索字词视图。历史数据从 2023 年 3 月开始提供。

JSON 表示法 
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string
}
字段
resourceName

string

仅限输出。客户级搜索字词数据分析的资源名称。客户级搜索字词数据分析资源名称采用以下格式：

customers/{customerId}/customerSearchTermInsights/{categoryId}
categoryLabel

string

仅限输出。搜索类别的标签。空字符串表示不属于其他类别的搜索字词的无限类别。
id

string (int64 format)

仅限输出。数据分析的 ID。

DetailPlacementView

包含按广告组和网址或 YouTube 视频汇总的指标的视图。

JSON 表示法 
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "groupPlacementTargetUrl": string,
  "targetUrl": string
}
字段
resourceName

string

仅限输出。详情展示位置视图的资源名称。详情展示位置视图资源名称采用以下形式：

customers/{customerId}/detailPlacementViews/{adGroupId}~{base64_placement}
placementType

enum (PlacementType)

仅限输出。展示位置的类型，例如，网站、YouTube 视频和移动应用。
placement

string

仅限输出。详细级别的系统推荐的展示位置字符串，例如网站网址、移动应用 ID 或 YouTube 视频 ID。
displayName

string

仅限输出。显示名包括网站网址名称、YouTube 视频的 YouTube 视频名称以及移动应用的翻译版移动应用名称。
groupPlacementTargetUrl

string

仅限输出。组展示位置的网址，例如域名、应用商店中移动应用的链接或 YouTube 频道网址。
targetUrl

string

仅限输出。展示位置的网址，例如网站、应用商店中移动应用的链接或 YouTube 视频网址。

PlacementType

Feed 映射的可能展示位置类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
WEBSITE 网站（如“www.flowers4sale.com”）。
MOBILE_APP_CATEGORY 移动应用类别（例如“游戏”）。
MOBILE_APPLICATION （例如“mobileapp::2-com.whatsthewordanswers”）。
YOUTUBE_VIDEO YouTube 视频（例如“youtube.com/video/wtLJPvx7-ys”）。
YOUTUBE_CHANNEL YouTube 频道（例如“youtube.com::L8ZULXASCc1I_oaOT0NaOQ”）。
GOOGLE_PRODUCTS Google 拥有并运营的平台（例如“tv.google.com”）。

DetailedDemographic

详细受众特征：根据用户的长期生活情况来定位的特定行业，以覆盖用户。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
字段
resourceName

string

仅限输出。详细受众特征的资源名称。详细受众特征资源名称采用以下形式：

customers/{customerId}/detailedDemographics/{detailed_demographic_id}
id

string (int64 format)

仅限输出。详细受众特征的 ID。
name

string

仅限输出。详细受众特征的名称。例如“Highest Level of Educational Attainment”
parent

string

仅限输出。详细受众特征的父级。
launchedToAll

boolean

仅限输出。如果详细受众特征已面向所有频道和语言区域发布，则为 true。
availabilities[]

object (CriterionCategoryAvailability)

仅限输出。详细受众特征的可用性信息。

CriterionCategoryAvailability

每个广告渠道的类别适用情况信息。

JSON 表示法 
{
  "channel": {
    object (CriterionCategoryChannelAvailability)
  },
  "locale": [
    {
      object (CriterionCategoryLocaleAvailability)
    }
  ]
}
字段
channel

object (CriterionCategoryChannelAvailability)

该类别可用的渠道类型和子类型。
locale[]

object (CriterionCategoryLocaleAvailability)

适用于频道所属类别的语言区域。

CriterionCategoryChannelAvailability

其中包含某个类别的广告渠道类型和子类型的信息。

JSON 表示法 
{
  "availabilityMode": enum (CriterionCategoryChannelAvailabilityMode),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": [
    enum (AdvertisingChannelSubType)
  ],
  "includeDefaultChannelSubType": boolean
}
字段
availabilityMode

enum (CriterionCategoryChannelAvailabilityMode)

渠道可用情况的格式。可以是 ALL_CHANNELS（其余字段将不设置）、CHANNEL_TYPE（仅设置 advertisingChannelType 类型，该类别可用于其下的所有子类型）或 CHANNEL_TYPE_AND_SUBTYPES（advertisingChannelType、advertisingChannelSubType 和 includeDefaultChannelSubType 将全部设置）。
advertisingChannelType

enum (AdvertisingChannelType)

类别可用的频道类型。
advertisingChannelSubType[]

enum (AdvertisingChannelSubType)

类别适用的频道类型下的频道子类型。
includeDefaultChannelSubType

boolean

是否包含默认频道子类型。例如，如果 advertisingChannelType 为 DISPLAY，且 includeDefaultChannelSubType 为 false，则表示未设置渠道子类型的默认展示广告系列将不包含在此可用性配置中。

CriterionCategoryChannelAvailabilityMode

包含可能的 CriteriaCategoryChannelAvailabilityMode 的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ALL_CHANNELS 此类别适用于所有渠道类型和子类型的广告系列。
CHANNEL_TYPE_AND_ALL_SUBTYPES 此类别适用于特定渠道类型（包括其下的所有子类型）的广告系列。
CHANNEL_TYPE_AND_SUBSET_SUBTYPES 此类别适用于具有特定渠道类型和子类型的广告系列。

CriterionCategoryLocaleAvailability

有关提供类别的语言区域的信息。

JSON 表示法 
{
  "availabilityMode": enum (CriterionCategoryLocaleAvailabilityMode),
  "countryCode": string,
  "languageCode": string
}
字段
availabilityMode

enum (CriterionCategoryLocaleAvailabilityMode)

语言区域可用性的格式。可为 LAUNCHED_TO_ALL（国家/地区和语言均为空）、COUNTRY（仅设置国家/地区）、LANGUAGE（仅设置语言）、COUNTRY_AND_LANGUAGE（将设置国家/地区和语言）。
countryCode

string

与类别相关联的 ISO-3166-1 alpha-2 国家/地区代码。
languageCode

string

类别相关联的语言的 ISO 639-1 代码。

CriterionCategoryLocaleAvailabilityMode

包含可能的 CriteriaCategoryLocaleAvailabilityMode 的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ALL_LOCALES 此类别适用于所有语言区域的广告系列。
COUNTRY_AND_ALL_LANGUAGES 类别适用于特定国家/地区列表中的广告系列，无论广告系列使用何种语言。
LANGUAGE_AND_ALL_COUNTRIES 此类别适用于以一组语言投放的广告系列，不受国家/地区限制。
COUNTRY_AND_LANGUAGE 该类别适用于国家/地区和语言对列表中的广告系列。

DisplayKeywordView

展示广告网络关键字视图。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。展示广告网络关键字视图的资源名称。展示广告网络关键字视图资源名称采用以下格式：

customers/{customerId}/displayKeywordViews/{adGroupId}~{criterionId}

DistanceView

距离视图，包含按用户与广告客户附加地址信息的距离汇总的指标。每个 DistanceBucket 均包含在其距离范围内的所有展示，一次展示将计入所有包含用户距离的 DistanceBucket 的指标。

JSON 表示法 
{
  "resourceName": string,
  "distanceBucket": enum (DistanceBucket),
  "metricSystem": boolean
}
字段
resourceName

string

仅限输出。距离视图的资源名称。距离视图资源名称的格式如下：

customers/{customerId}/distanceViews/1~{distanceBucket}
distanceBucket

enum (DistanceBucket)

仅限输出。附加地址信息中的用户距离分组。
metricSystem

boolean

仅限输出。如果 DistanceBucket 使用公制，则为 true，否则为 false。

DistanceBucket

用户到广告客户的附加地址信息距离的距离范围。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
WITHIN_700M 用户在距离营业地点 700 米以内。
WITHIN_1KM 用户与该营业地点相距不到 1 公里。
WITHIN_5KM 用户距离该营业地点不到 5 公里。
WITHIN_10KM 用户距离该营业地点的距离不到 10 公里。
WITHIN_15KM 用户距离该营业地点的距离不到 15 公里。
WITHIN_20KM 用户距离该营业地点的距离不到 20 公里。
WITHIN_25KM 用户距离该营业地点的距离不到 25 公里。
WITHIN_30KM 用户距离该营业地点不到 30 公里。
WITHIN_35KM 用户距离该营业地点不到 35 公里。
WITHIN_40KM 用户距离该营业地点不到 40 公里。
WITHIN_45KM 用户距离该营业地点的距离不到 45 公里。
WITHIN_50KM 用户距离该营业地点的距离不到 50 公里。
WITHIN_55KM 用户距离该营业地点的距离不到 55 公里。
WITHIN_60KM 用户距离该营业地点不到 60 公里。
WITHIN_65KM 用户距离该营业地点的距离不到 65 公里。
BEYOND_65KM 用户超出了相应营业地点的 65 公里范围。
WITHIN_0_7MILES 用户距离营业地点不到 0.7 英里。
WITHIN_1MILE 用户在距离营业地点 1 英里范围内。
WITHIN_5MILES 用户距离营业地点不到 5 英里。
WITHIN_10MILES 用户距离该营业地点不到 10 英里。
WITHIN_15MILES 用户距离营业地点 15 英里。
WITHIN_20MILES 用户在距离营业地点 20 英里内。
WITHIN_25MILES 用户距离营业地点的 25 英里范围以内。
WITHIN_30MILES 用户距离营业地点不到 30 英里。
WITHIN_35MILES 用户距离营业地点的距离在 35 英里内。
WITHIN_40MILES 用户在距离营业地点 40 英里内。
BEYOND_40MILES 用户超出了该营业地点 40 英里以外的位置。

DynamicSearchAdsSearchTermView

动态搜索广告搜索字词视图。

JSON 表示法 
{
  "resourceName": string,
  "searchTerm": string,
  "headline": string,
  "landingPage": string,
  "pageUrl": string,
  "hasNegativeKeyword": boolean,
  "hasMatchingKeyword": boolean,
  "hasNegativeUrl": boolean
}
字段
resourceName

string

仅限输出。动态搜索广告搜索字词视图的资源名称。动态搜索广告搜索字词视图资源名称的格式如下：

customers/{customerId}/dynamicSearchAdsSearchTermViews/{adGroupId}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
searchTerm

string

仅限输出。搜索字词

此字段为只读字段。
headline

string

仅限输出。动态搜索广告动态生成的标题。

此字段为只读字段。
landingPage

string

仅限输出。针对展示动态选择的着陆页网址。

此字段为只读字段。
pageUrl

string

仅限输出。为相应展示投放的页面 Feed 项的网址。

此字段为只读字段。
hasNegativeKeyword

boolean

仅限输出。如果查询与否定关键字匹配，则为 true。

此字段为只读字段。
hasMatchingKeyword

boolean

仅限输出。如果查询是添加到指定关键字中的，则为 true。

此字段为只读字段。
hasNegativeUrl

boolean

仅限输出。如果查询与排除的网址匹配，则为 true。

此字段为只读字段。

ExpandedLandingPageView

一种着陆页浏览，其中包含在扩展后的最终到达网址级别汇总的指标。

JSON 表示法 
{
  "resourceName": string,
  "expandedFinalUrl": string
}
字段
resourceName

string

仅限输出。展开后的着陆页视图的资源名称。扩展后的着陆页视图资源名称采用以下格式：

customers/{customerId}/expandedLandingPageViews/{expanded_final_url_fingerprint}
expandedFinalUrl

string

仅限输出。点击后会到达的最终到达网址。

FeedPlaceholderView

Feed 占位符视图。

JSON 表示法 
{
  "resourceName": string,
  "placeholderType": enum (PlaceholderType)
}
字段
resourceName

string

仅限输出。Feed 占位符视图的资源名称。Feed 占位符视图资源名称的格式如下：

customers/{customerId}/feedPlaceholderViews/{placeholderType}
placeholderType

enum (PlaceholderType)

仅限输出。Feed 占位符视图的占位符类型。

GenderView

性别视图。genderView 资源反映的是有效投放状态，而不是添加的条件。默认情况下，未设置性别条件的广告组会面向所有性别显示，因此所有性别都会显示在 genderView 中以及统计信息中。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。性别视图的资源名称。性别视图资源名称采用以下格式：

customers/{customerId}/genderViews/{adGroupId}~{criterionId}

GeographicView

地理位置视图。

地理位置视图包含国家/地区一级的所有汇总指标，每个国家/地区占一行。它会报告在用户实际所处位置或兴趣区域的指标。如果使用了其他细分字段，每个国家/地区可能会占多行。

JSON 表示法 
{
  "resourceName": string,
  "locationType": enum (GeoTargetingType),
  "countryCriterionId": string
}
字段
resourceName

string

仅限输出。地理位置视图的资源名称。地理位置视图资源名称采用以下形式：

customers/{customerId}/geographicViews/{countryCriterionId}~{locationType}
locationType

enum (GeoTargetingType)

仅限输出。广告系列的地理位置定位类型。
countryCriterionId

string (int64 format)

仅限输出。国家/地区的条件 ID。

GeoTargetingType

可能的地理位置定位类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
AREA_OF_INTEREST 用户在进行查询时感兴趣的位置。
LOCATION_OF_PRESENCE 发出查询的用户所在的位置。

GroupPlacementView

组展示位置视图。

JSON 表示法 
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "targetUrl": string
}
字段
resourceName

string

仅限输出。组展示位置视图的资源名称。组展示位置视图资源名称的格式如下：

customers/{customerId}/groupPlacementViews/{adGroupId}~{base64_placement}
placementType

enum (PlacementType)

仅限输出。展示位置的类型，例如网站、YouTube 频道、移动应用。
placement

string

仅限输出。组级别的系统推荐的展示位置字符串，例如网域、移动应用 ID 或 YouTube 频道 ID。
displayName

string

仅限输出。网站域名和 YouTube 频道的 YouTube 频道名称。
targetUrl

string

仅限输出。组展示位置的网址，例如域名、应用商店中移动应用的链接或 YouTube 频道网址。

HotelGroupView

酒店组视图。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。酒店组视图的资源名称。酒店组视图资源名称采用以下格式：

customers/{customerId}/hotelGroupViews/{adGroupId}~{criterionId}

HotelPerformanceView

酒店效果视图。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。酒店效果视图的资源名称。酒店效果视图资源名称采用以下格式：

customers/{customerId}/hotelPerformanceView

HotelReconciliation

酒店对账。其中包含酒店预订转化信息，以便与广告客户的记录保持一致。在通过批量上传功能进行结算前，您可以更新或取消这些行。

JSON 表示法 
{
  "resourceName": string,
  "commissionId": string,
  "orderId": string,
  "campaign": string,
  "hotelCenterId": string,
  "hotelId": string,
  "checkInDate": string,
  "checkOutDate": string,
  "reconciledValueMicros": string,
  "billed": boolean,
  "status": enum (HotelReconciliationStatus)
}
字段
resourceName

string

不可变。酒店对账的资源名称。酒店对账资源名称采用以下格式：

customers/{customerId}/hotelReconciliations/{commissionId}
commissionId

string

必需。仅限输出。佣金 ID 是指 Google 用于此项预订的 ID。系统会为每个预订事件分配佣金 ID，以便您将其与房客入住对应起来。
orderId

string

仅限输出。订单 ID 是此预订的标识符，在转化跟踪代码的“transaction_id”参数中提供。
campaign

string

仅限输出。与转化相关联的广告系列的资源名称。
hotelCenterId

string (int64 format)

仅限输出。Hotel Center 帐号的标识符，用于为酒店广告系列提供房价。
hotelId

string

仅限输出。所预订房源的唯一标识符，在 Hotel Center Feed 中提供。酒店 ID 来自转化跟踪代码的“ID”参数。
checkInDate

string

仅限输出。入住日期是在预订时记录的。如果您在对账时修改了入住日期，则修改后的日期将取代此列中的原始日期。格式为 YYYY-MM-DD。
checkOutDate

string

仅限输出。预订时记录的退房日期。如果您在对账时修改了入住日期，则修改后的日期将取代此列中的原始日期。格式为 YYYY-MM-DD。
reconciledValueMicros

string (int64 format)

必需。仅限输出。已对账值是指房客支付的最终预订价值。如果原始预订价值因任何原因（例如行程变更或客房追加销售）而发生变化，已对账值应是所收取的最终全额。如果预订被取消，已对账值应包含所有取消费用或已收取且无法退款的住宿晚数的价值。值以基础单位货币的百万分之一为单位。例如，12.35 美元将表示为 12350000。货币单位采用默认客户币种。
billed

boolean

仅限输出。是否已结算指定预订。结算后，便无法再修改预订。
status

enum (HotelReconciliationStatus)

必需。仅限输出。与对账和结算有关的预订的当前状态。应在退房日期后 45 天内对预订进行对账。任何未在 45 天内对账的预订都将按其原始价值结算。

HotelReconciliationStatus

酒店预订对账的状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
RESERVATION_ENABLED 预订针对的是未来的日期，或者已经入住但还未过退房日期的情形。处于有效状态的预订无法进行对账。
RECONCILIATION_NEEDED 已经退房，或者预订日期已过且未取消。未在退房日期后 45 天内对账的预订会按照原来的预订价格结算费用。
RECONCILED 这些预订已经对账。已对账的预订将在退房日期后 45 天结算费用。
CANCELED 此预订已标记为取消。如果已取消预订的入住天数大于零（因设有最低入住天数规则或取消费用），系统会在退房日期后 45 天结算费用。

IncomeRangeView

收入范围视图。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。收入范围视图的资源名称。收入范围视图资源名称的格式如下：

customers/{customerId}/incomeRangeViews/{adGroupId}~{criterionId}

KeywordView

关键字视图。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。关键字视图的资源名称。关键字视图资源名称采用以下格式：

customers/{customerId}/keywordViews/{adGroupId}~{criterionId}

LandingPageView

一种着陆页浏览，其中包含在未展开的最终到达网址一级汇总的指标。

JSON 表示法 
{
  "resourceName": string,
  "unexpandedFinalUrl": string
}
字段
resourceName

string

仅限输出。着陆页视图的资源名称。着陆页视图资源名称采用以下格式：

customers/{customerId}/landingPageViews/{unexpanded_final_url_fingerprint}
unexpandedFinalUrl

string

仅限输出。广告主指定的最终到达网址。

LanguageConstant

语言。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
字段
resourceName

string

仅限输出。语言常量的资源名称。语言常量资源名称的格式如下：

languageConstants/{criterionId}
id

string (int64 format)

仅限输出。语言常量的 ID。
code

string

仅限输出。语言代码，例如“en_US”“en_AU”“es”“fr”等。
name

string

仅限输出。语言的英文全称，例如“English (US)”“Spanish”等。
targetable

boolean

仅限输出。语言是否可定位。

LocationView

地理位置视图按地理位置条件总结广告系列的效果。如果未设置“地理位置”条件，系统将不会返回任何结果；而是会改用 geoView 或 userLocationView 获取访问者的位置数据。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。营业地点视图的资源名称。营业地点视图资源名称采用以下格式：

customers/{customerId}/locationViews/{campaignId}~{criterionId}

ManagedPlacementView

自选展示位置视图。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。自选展示位置视图的资源名称。自选展示位置视图资源名称采用以下格式：

customers/{customerId}/managedPlacementViews/{adGroupId}~{criterionId}

MobileAppCategoryConstant

移动应用类别常量。

JSON 表示法 
{
  "resourceName": string,
  "id": integer,
  "name": string
}
字段
resourceName

string

仅限输出。移动应用类别常量的资源名称。移动应用类别常量资源名称的格式如下：

mobileAppCategoryConstants/{mobile_app_category_id}
id

integer

仅限输出。移动应用类别常量的 ID。
name

string

仅限输出。移动应用类别名称。

MobileDeviceConstant

移动设备常量。

JSON 表示法 
{
  "resourceName": string,
  "type": enum (MobileDeviceType),
  "id": string,
  "name": string,
  "manufacturerName": string,
  "operatingSystemName": string
}
字段
resourceName

string

仅限输出。移动设备常量的资源名称。移动设备常量资源名称的格式如下：

mobileDeviceConstants/{criterionId}
type

enum (MobileDeviceType)

仅限输出。移动设备的类型。
id

string (int64 format)

仅限输出。移动设备常量的 ID。
name

string

仅限输出。移动设备的名称。
manufacturerName

string

仅限输出。移动设备的制造商。
operatingSystemName

string

仅限输出。移动设备的操作系统。

MobileDeviceType

移动设备的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
MOBILE 手机。
TABLET 平板电脑。

OperatingSystemVersionConstant

移动操作系统版本或一系列版本，具体取决于 operatorType。可用的移动平台列表：https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms

JSON 表示法 
{
  "resourceName": string,
  "operatorType": enum (OperatingSystemVersionOperatorType),
  "id": string,
  "name": string,
  "osMajorVersion": integer,
  "osMinorVersion": integer
}
字段
resourceName

string

仅限输出。操作系统版本常量的资源名称。操作系统版本常量资源名称采用以下形式：

operatingSystemVersionConstants/{criterionId}
operatorType

enum (OperatingSystemVersionOperatorType)

仅限输出。确定此常量代表的是单个版本还是多个版本范围。
id

string (int64 format)

仅限输出。操作系统版本的 ID。
name

string

仅限输出。操作系统的名称。
osMajorVersion

integer

仅限输出。操作系统主要版本号。
osMinorVersion

integer

仅限输出。操作系统次要版本号。

OperatingSystemVersionOperatorType

操作系统版本的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
EQUALS_TO 等于指定的版本。
GREATER_THAN_EQUALS_TO 大于或等于指定版本。

PaidOrganicSearchTermView

付费自然搜索字词视图会显示广告和自然搜索结果的搜索统计信息，按搜索字词在广告组一级进行汇总。

JSON 表示法 
{
  "resourceName": string,
  "searchTerm": string
}
字段
resourceName

string

仅限输出。搜索字词视图的资源名称。搜索字词视图资源名称采用以下格式：

customers/{customerId}/paidOrganicSearchTermViews/{campaignId}~ {adGroupId}~{URL-base64 search term}
searchTerm

string

仅限输出。搜索字词。

QualifyingQuestion

用于判断潜在客户表单是否符合条件的问题。

JSON 表示法 
{
  "resourceName": string,
  "qualifyingQuestionId": string,
  "locale": string,
  "text": string
}
字段
resourceName

string

仅限输出。甄别问题的资源名称。

“qualificationQuestions/{qualifiedQuestionId}”
qualifyingQuestionId

string (int64 format)

仅限输出。甄别问题的 ID。
locale

string

仅限输出。甄别问题的语言区域。
text

string

仅限输出。甄别问题。

ParentalStatusView

生育情况视图。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。生育情况视图的资源名称。“育儿状况”视图资源名称的格式如下：

customers/{customerId}/parentalStatusViews/{adGroupId}~{criterionId}

PerStoreView

按商店划分的一次浏览。此视图提供了广告客户的实体店每次展示覆盖面和本地操作转化统计信息。

JSON 表示法 
{
  "resourceName": string,
  "placeId": string
}
字段
resourceName

string

仅限输出。按商店视图的资源名称。按商店视图资源名称采用以下格式：

customers/{customerId}/perStoreViews/{placeId}
placeId

string

仅限输出。按商店视图的地点 ID。

ProductBiddingCategoryConstant

产品出价类别。

JSON 表示法 
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
字段
resourceName

string

仅限输出。产品出价类别的资源名称。产品出价类别资源名称采用以下格式：

productBiddingCategoryConstants/{countryCode}~{level}~{id}
level

enum (ProductBiddingCategoryLevel)

仅限输出。产品出价类别的级别。
status

enum (ProductBiddingCategoryStatus)

仅限输出。产品出价类别的状态。
id

string (int64 format)

仅限输出。产品出价类别的 ID。

此 ID 相当于 google_product_category [Google 商品类别] ID，如 https://support.google.com/merchants/answer/6324436 一文中所述。
countryCode

string

仅限输出。产品出价类别的双字母国家/地区代码。
productBiddingCategoryConstantParent

string

仅限输出。父级产品出价类别的资源名称。
languageCode

string

仅限输出。产品出价类别的语言代码。
localizedName

string

仅限输出。根据 languageCode 进行本地化的产品出价类别的显示值。

ProductBiddingCategoryStatus

描述产品出价类别状态的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ACTIVE 该类别处于有效状态，可以用于出价。
OBSOLETE 该类别已过时。仅用于报告目的。

ProductGroupView

产品组视图。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。产品组视图的资源名称。产品组视图资源名称采用以下格式：

customers/{customerId}/productGroupViews/{adGroupId}~{criterionId}

建议

一条建议。

JSON 表示法 
{
  "resourceName": string,
  "type": enum (RecommendationType),
  "impact": {
    object (RecommendationImpact)
  },
  "campaigns": [
    string
  ],
  "campaignBudget": string,
  "campaign": string,
  "adGroup": string,
  "dismissed": boolean,

  // Union field recommendation can be only one of the following:
  "campaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "forecastingCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "keywordRecommendation": {
    object (KeywordRecommendation)
  },
  "textAdRecommendation": {
    object (TextAdRecommendation)
  },
  "targetCpaOptInRecommendation": {
    object (TargetCpaOptInRecommendation)
  },
  "maximizeConversionsOptInRecommendation": {
    object (MaximizeConversionsOptInRecommendation)
  },
  "enhancedCpcOptInRecommendation": {
    object (EnhancedCpcOptInRecommendation)
  },
  "searchPartnersOptInRecommendation": {
    object (SearchPartnersOptInRecommendation)
  },
  "maximizeClicksOptInRecommendation": {
    object (MaximizeClicksOptInRecommendation)
  },
  "optimizeAdRotationRecommendation": {
    object (OptimizeAdRotationRecommendation)
  },
  "keywordMatchTypeRecommendation": {
    object (KeywordMatchTypeRecommendation)
  },
  "moveUnusedBudgetRecommendation": {
    object (MoveUnusedBudgetRecommendation)
  },
  "targetRoasOptInRecommendation": {
    object (TargetRoasOptInRecommendation)
  },
  "responsiveSearchAdRecommendation": {
    object (ResponsiveSearchAdRecommendation)
  },
  "marginalRoiCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "useBroadMatchKeywordRecommendation": {
    object (UseBroadMatchKeywordRecommendation)
  },
  "responsiveSearchAdAssetRecommendation": {
    object (ResponsiveSearchAdAssetRecommendation)
  },
  "upgradeSmartShoppingCampaignToPerformanceMaxRecommendation": {
    object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)
  },
  "responsiveSearchAdImproveAdStrengthRecommendation": {
    object (ResponsiveSearchAdImproveAdStrengthRecommendation)
  },
  "displayExpansionOptInRecommendation": {
    object (DisplayExpansionOptInRecommendation)
  },
  "upgradeLocalCampaignToPerformanceMaxRecommendation": {
    object (UpgradeLocalCampaignToPerformanceMaxRecommendation)
  },
  "raiseTargetCpaBidTooLowRecommendation": {
    object (RaiseTargetCpaBidTooLowRecommendation)
  },
  "forecastingSetTargetRoasRecommendation": {
    object (ForecastingSetTargetRoasRecommendation)
  },
  "calloutAssetRecommendation": {
    object (CalloutAssetRecommendation)
  },
  "sitelinkAssetRecommendation": {
    object (SitelinkAssetRecommendation)
  },
  "callAssetRecommendation": {
    object (CallAssetRecommendation)
  },
  "shoppingAddAgeGroupRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddColorRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGenderRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGtinRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddMoreIdentifiersRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddSizeRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddProductsToCampaignRecommendation": {
    object (ShoppingAddProductsToCampaignRecommendation)
  },
  "shoppingFixDisapprovedProductsRecommendation": {
    object (ShoppingFixDisapprovedProductsRecommendation)
  },
  "shoppingTargetAllOffersRecommendation": {
    object (ShoppingTargetAllOffersRecommendation)
  },
  "shoppingFixSuspendedMerchantCenterAccountRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingFixMerchantCenterAccountSuspensionWarningRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation": {
    object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)
  },
  "dynamicImageExtensionOptInRecommendation": {
    object (DynamicImageExtensionOptInRecommendation)
  },
  "raiseTargetCpaRecommendation": {
    object (RaiseTargetCpaRecommendation)
  },
  "lowerTargetRoasRecommendation": {
    object (LowerTargetRoasRecommendation)
  },
  "performanceMaxOptInRecommendation": {
    object (PerformanceMaxOptInRecommendation)
  },
  "improvePerformanceMaxAdStrengthRecommendation": {
    object (ImprovePerformanceMaxAdStrengthRecommendation)
  },
  "migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation": {
    object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)
  }
  // End of list of possible types for union field recommendation.
}
字段
resourceName

string

不可变。建议的资源名称。

customers/{customerId}/recommendations/{recommendation_id}
type

enum (RecommendationType)

仅限输出。建议的类型。
impact

object (RecommendationImpact)

仅限输出。采纳建议对帐号效果的影响。
campaigns[]

string

仅限输出。此建议针对的广告系列。

将为以下建议类型设置此字段：CAMPAIGN_BUDGET、FORECASTING_CAMPAIGN_BUDGET、MARGINAL_ROI_CAMPAIGN_BUDGET 和 MOVE_UNUSED_BUDGET
campaignBudget

string

仅限输出。此建议目标的预算。仅当建议影响到单个广告系列预算时，系统才会设置此属性。

将为以下建议类型设置此字段：CAMPAIGN_BUDGET、FORECASTING_CAMPAIGN_BUDGET、MARGINAL_ROI_CAMPAIGN_BUDGET、MOVE_UNUSED_BUDGET
campaign

string

仅限输出。此建议针对的广告系列。

This field will be set for the following recommendation types: CALL_EXTENSION, CALLOUT_EXTENSION, ENHANCED_CPC_OPT_IN, USE_BROAD_MATCH_KEYWORD, KEYWORD, KEYWORD_MATCH_TYPE, UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, SEARCH_PARTNERS_OPT_IN, DISPLAY_EXPANSION_OPT_IN, SITELINK_EXTENSION, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD, UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX, RAISE_TARGET_CPA_BID_TOO_LOW, FORECASTING_SET_TARGET_ROAS, SHOPPING_ADD_AGE_GROUP, SHOPPING_ADD_COLOR, SHOPPING_ADD_GENDER, SHOPPING_ADD_SIZE, SHOPPING_ADD_GTIN, SHOPPING_ADD_MORE_IDENTIFIERS, SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN, SHOPPING_FIX_DISAPPROVED_PRODUCTS, SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX, DYNAMIC_IMAGE_EXTENSION_OPT_IN, RAISE_TARGET_CPA, LOWER_TARGET_ROAS,
adGroup

string

仅限输出。此建议定位的广告组。仅当建议影响单个广告组时，系统才会设置此项。

将为以下建议类型设置此字段：KEYWORD、OPTIMIZE_AD_ROTATION、RESPONSIVE_SEARCH_AD、RESPONSIVE_SEARCH_AD_ASSET、TEXT_AD
dismissed

boolean

仅限输出。建议是否被拒绝。
联合字段 recommendation。建议的详细信息。recommendation 只能是下列其中一项：
campaignBudgetRecommendation

object (CampaignBudgetRecommendation)

仅限输出。广告系列预算建议。
forecastingCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

仅限输出。预测广告系列预算建议。
keywordRecommendation

object (KeywordRecommendation)

仅限输出。关键字建议。
textAdRecommendation

object (TextAdRecommendation)

仅限输出。关于添加加大型文字广告的建议。
targetCpaOptInRecommendation

object (TargetCpaOptInRecommendation)

仅限输出。“启用目标每次转化费用”建议。
maximizeConversionsOptInRecommendation

object (MaximizeConversionsOptInRecommendation)

仅限输出。“启用尽可能提高转化次数”建议。
enhancedCpcOptInRecommendation

object (EnhancedCpcOptInRecommendation)

仅限输出。“选择采用智能点击付费”出价策略建议。
searchPartnersOptInRecommendation

object (SearchPartnersOptInRecommendation)

仅限输出。搜索网络合作伙伴“选择启用”建议。
maximizeClicksOptInRecommendation

object (MaximizeClicksOptInRecommendation)

仅限输出。“启用尽可能争取更多点击次数”建议。
optimizeAdRotationRecommendation

object (OptimizeAdRotationRecommendation)

仅限输出。“优化广告轮播”建议。
keywordMatchTypeRecommendation

object (KeywordMatchTypeRecommendation)

仅限输出。关键字匹配类型建议。
moveUnusedBudgetRecommendation

object (MoveUnusedBudgetRecommendation)

仅限输出。“转移未使用的预算”建议。
targetRoasOptInRecommendation

object (TargetRoasOptInRecommendation)

仅限输出。“目标广告支出回报率”出价策略启用建议。
responsiveSearchAdRecommendation

object (ResponsiveSearchAdRecommendation)

仅限输出。关于添加自适应搜索广告的建议。
marginalRoiCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

仅限输出。边际 ROI 广告系列预算建议。
useBroadMatchKeywordRecommendation

object (UseBroadMatchKeywordRecommendation)

仅限输出。“使用广泛匹配关键字”建议。
responsiveSearchAdAssetRecommendation

object (ResponsiveSearchAdAssetRecommendation)

仅限输出。自适应搜索广告素材资源建议。
upgradeSmartShoppingCampaignToPerformanceMaxRecommendation

object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)

仅限输出。将智能购物广告系列升级为效果最大化广告系列建议。
responsiveSearchAdImproveAdStrengthRecommendation

object (ResponsiveSearchAdImproveAdStrengthRecommendation)

仅限输出。自适应搜索广告的广告效力提升建议。
displayExpansionOptInRecommendation

object (DisplayExpansionOptInRecommendation)

仅限输出。“启用将展示广告网络也纳入投放范围”建议。
upgradeLocalCampaignToPerformanceMaxRecommendation

object (UpgradeLocalCampaignToPerformanceMaxRecommendation)

仅限输出。将本地广告系列升级为效果最大化广告系列的建议。
raiseTargetCpaBidTooLowRecommendation

object (RaiseTargetCpaBidTooLowRecommendation)

仅限输出。“目标每次转化费用出价过低”建议。
forecastingSetTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

仅限输出。预测功能设置了目标广告支出回报率建议。
calloutAssetRecommendation

object (CalloutAssetRecommendation)

仅限输出。宣传信息素材资源建议。
callAssetRecommendation

object (CallAssetRecommendation)

仅限输出。电话素材资源建议。
shoppingAddAgeGroupRecommendation

object (ShoppingOfferAttributeRecommendation)

仅限输出。购物添加年龄段建议。
shoppingAddColorRecommendation

object (ShoppingOfferAttributeRecommendation)

仅限输出。购物广告系列添加颜色建议。
shoppingAddGenderRecommendation

object (ShoppingOfferAttributeRecommendation)

仅限输出。购物广告系列添加性别建议。
shoppingAddGtinRecommendation

object (ShoppingOfferAttributeRecommendation)

仅限输出。购物添加 GTIN 建议。
shoppingAddMoreIdentifiersRecommendation

object (ShoppingOfferAttributeRecommendation)

仅限输出。关于购物广告系列“添加更多标识码”的建议。
shoppingAddSizeRecommendation

object (ShoppingOfferAttributeRecommendation)

仅限输出。购物广告系列添加尺寸建议。
shoppingAddProductsToCampaignRecommendation

object (ShoppingAddProductsToCampaignRecommendation)

仅限输出。购物广告系列会将产品添加到广告系列建议中。
shoppingFixDisapprovedProductsRecommendation

object (ShoppingFixDisapprovedProductsRecommendation)

仅限输出。关于购物广告系列修正被拒登产品的建议。
shoppingTargetAllOffersRecommendation

object (ShoppingTargetAllOffersRecommendation)

仅限输出。购物定位条件所有优惠建议。
shoppingFixSuspendedMerchantCenterAccountRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

仅限输出。购物修正功能暂停了 Merchant Center 账号建议。
shoppingFixMerchantCenterAccountSuspensionWarningRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

仅限输出。购物修正 Merchant Center 账号中止警告建议。
shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)

仅限输出。购物广告系列将常规购物广告系列中的商品迁移到效果最大化广告系列建议。
dynamicImageExtensionOptInRecommendation

object (DynamicImageExtensionOptInRecommendation)

仅限输出。建议在账号中启用动态图片附加信息，以便 Google 从广告着陆页中找到最合适的图片，并对文字广告进行补充。
raiseTargetCpaRecommendation

object (RaiseTargetCpaRecommendation)

仅限输出。建议提高目标每次转化费用。
lowerTargetRoasRecommendation

object (LowerTargetRoasRecommendation)

仅限输出。建议降低目标广告支出回报率。
performanceMaxOptInRecommendation

object (PerformanceMaxOptInRecommendation)

仅限输出。“选择启用效果最大化广告系列”建议。
improvePerformanceMaxAdStrengthRecommendation

object (ImprovePerformanceMaxAdStrengthRecommendation)

仅限输出。效果最大化广告系列的广告效力建议。
migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)

仅限输出。从动态搜索广告迁移到效果最大化广告系列的建议。

RecommendationType

建议的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
CAMPAIGN_BUDGET 为当前预算受限的广告系列提供的预算建议（与 FORECASTING_CAMPAIGN_BUDGET 建议相反，该建议适用于预计未来会受预算限制的广告系列）。
KEYWORD 关键字建议。
TEXT_AD 建议添加新的文字广告。
TARGET_CPA_OPT_IN 建议将广告系列更新为采用“目标每次转化费用”出价策略。
MAXIMIZE_CONVERSIONS_OPT_IN 建议将广告系列更新为采用“尽可能提高转化次数”出价策略。
ENHANCED_CPC_OPT_IN 为广告系列启用智能点击付费的建议。
SEARCH_PARTNERS_OPT_IN 建议开始在 Google 搜索网络合作伙伴网站上展示广告系列中的广告。
MAXIMIZE_CLICKS_OPT_IN 建议将广告系列更新为采用“尽可能争取更多点击次数”出价策略。
OPTIMIZE_AD_ROTATION 建议先为指定广告组使用“优化”广告轮播设置。
KEYWORD_MATCH_TYPE 建议将现有关键字从一种匹配类型更改为更宽泛的匹配类型。
MOVE_UNUSED_BUDGET 建议将一项预算中未使用的预算转给受限预算。
FORECASTING_CAMPAIGN_BUDGET 针对预计将来会受预算限制的广告系列的预算建议（与 CAMPAIGN_BUDGET 建议相反，该建议适用于当前预算受限的广告系列）。
TARGET_ROAS_OPT_IN 建议将广告系列更新为采用“目标广告支出回报率”出价策略。
RESPONSIVE_SEARCH_AD 建议添加新的自适应搜索广告。
MARGINAL_ROI_CAMPAIGN_BUDGET 针对 ROI 预计通过调整预算而有所提高的广告系列的预算建议。
USE_BROAD_MATCH_KEYWORD 建议为完全自动化且基于转化的出价广告系列添加关键字的广泛匹配形式。
RESPONSIVE_SEARCH_AD_ASSET 建议添加新的自适应搜索广告素材资源。
UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX 建议将智能购物广告系列升级为效果最大化广告系列。
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH 有关提升自适应搜索广告效力的建议。
DISPLAY_EXPANSION_OPT_IN 建议将广告系列更新为使用“将展示广告网络也纳入投放范围”。
UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX 建议将本地广告系列升级为效果最大化广告系列。
RAISE_TARGET_CPA_BID_TOO_LOW 建议在目标每次转化费用过低且转化次数很少或完全没有转化时提高目标每次转化费用。该操作是异步应用的，可能需要几分钟的时间，具体取决于相关广告系列中的广告组数量。
FORECASTING_SET_TARGET_ROAS 建议在季节性活动之前提高预算，因为预计节日活动会增加流量，并将出价策略从“尽可能提高转化价值”更改为“目标广告支出回报率”。
CALLOUT_ASSET 建议在广告系列一级或客户一级添加宣传信息素材资源。
CALL_ASSET 建议在广告系列层级或客户层级添加电话素材资源。
SHOPPING_ADD_AGE_GROUP 建议为因缺少年龄段而被降位的商品添加年龄段属性。
SHOPPING_ADD_COLOR 建议为因缺少颜色而被降位的商品添加颜色。
SHOPPING_ADD_GENDER 建议为因缺少适用性别而被降位的商品添加适用性别。
SHOPPING_ADD_GTIN 建议为因缺少 GTIN 而被降位的商品添加 GTIN（全球贸易项目代码）。
SHOPPING_ADD_MORE_IDENTIFIERS 建议为因缺少标识码而被降位的商品添加更多标识码。
SHOPPING_ADD_SIZE 建议为因缺少尺寸而被降位的商品添加该尺寸。
SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN 告知客户由于没有定位到任何产品而导致广告系列无法投放的建议。
SHOPPING_FIX_DISAPPROVED_PRODUCTS 购物建议，旨在告知客户：被拒登的产品占比较高的广告系列。
SHOPPING_TARGET_ALL_OFFERS 建议制作定位到所有优惠的全包型广告系列。
SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT 有关解决 Merchant Center 账号中止问题的建议。
SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING 有关解决 Merchant Center 账号中止警告问题的建议。
SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX 建议将常规购物广告系列宣传的商品迁移到现有的效果最大化广告系列。
DYNAMIC_IMAGE_EXTENSION_OPT_IN 建议在账号中启用动态图片附加信息，以便 Google 从广告着陆页中找到最合适的图片，并对文字广告进行补充。
RAISE_TARGET_CPA 根据 Google 根据以往转化数据建模得出的预测，提高目标每次转化费用 (CPA)。该操作是异步应用的，可能需要几分钟的时间，具体取决于相关广告系列中的广告组数量。
LOWER_TARGET_ROAS 建议降低目标广告支出回报率。
PERFORMANCE_MAX_OPT_IN 关于选择启用效果最大化广告系列的建议。
IMPROVE_PERFORMANCE_MAX_AD_STRENGTH 建议将效果最大化广告系列的素材资源组效力提升为“极佳”评分。
MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX 建议将动态搜索广告迁移到效果最大化广告系列。

RecommendationImpact

如建议中所述进行更改的影响。某些类型的建议可能不会影响信息。

JSON 表示法 
{
  "baseMetrics": {
    object (RecommendationMetrics)
  },
  "potentialMetrics": {
    object (RecommendationMetrics)
  }
}
字段
baseMetrics

object (RecommendationMetrics)

仅限输出。生成建议时的基本指标。
potentialMetrics

object (RecommendationMetrics)

仅限输出。采纳建议后的估算指标。

RecommendationMetrics

每周帐号效果指标。对于某些建议类型，由于这些建议是过去 90 天时间段的平均值，因此可能不太理想。

JSON 表示法 
{
  "impressions": number,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "videoViews": number
}
字段
impressions

number

仅限输出。广告展示次数。
clicks

number

仅限输出。广告点击次数。
costMicros

string (int64 format)

仅限输出。广告费用（以微单位表示），以帐号的本地货币为单位。
conversions

number

仅限输出。转化数。
videoViews

number

仅限输出。视频广告系列的视频观看次数。

CampaignBudgetRecommendation

针对受预算限制的广告系列提供的预算建议。

JSON 表示法 
{
  "budgetOptions": [
    {
      object (CampaignBudgetRecommendationOption)
    }
  ],
  "currentBudgetAmountMicros": string,
  "recommendedBudgetAmountMicros": string
}
字段
budgetOptions[]

object (CampaignBudgetRecommendationOption)

仅限输出。针对某些可能的预算金额值估算的预算金额及相关影响。
currentBudgetAmountMicros

string (int64 format)

仅限输出。当前预算金额（以微单位表示）。
recommendedBudgetAmountMicros

string (int64 format)

仅限输出。建议的预算金额（以微单位表示）。

CampaignBudgetRecommendationOption

对指定预算金额的影响估算值。

JSON 表示法 
{
  "impact": {
    object (RecommendationImpact)
  },
  "budgetAmountMicros": string
}
字段
impact

object (RecommendationImpact)

仅限输出。将预算更改为此选项中指定的金额时的影响估算值。
budgetAmountMicros

string (int64 format)

仅限输出。此选项的预算金额。

KeywordRecommendation

关键字建议。

JSON 表示法 
{
  "keyword": {
    object (KeywordInfo)
  },
  "searchTerms": [
    {
      object (SearchTerm)
    }
  ],
  "recommendedCpcBidMicros": string
}
字段
keyword

object (KeywordInfo)

仅限输出。建议的关键字。
searchTerms[]

object (SearchTerm)

仅限输出。与此关键字匹配的搜索字词列表。同一搜索字词可能会用于多个关键字。
recommendedCpcBidMicros

string (int64 format)

仅限输出。建议的每次点击费用 (CPC) 出价。

SearchTerm

与关键字建议相关的搜索字词信息。

JSON 表示法 
{
  "text": string,
  "estimatedWeeklySearchCount": string
}
字段
text

string

仅限输出。搜索字词的文字。
estimatedWeeklySearchCount

string (int64 format)

仅限输出。此搜索字词的估算历史每周搜索次数。

TextAdRecommendation

文字广告建议。

JSON 表示法 
{
  "ad": {
    object (Ad)
  },
  "creationDate": string,
  "autoApplyDate": string
}
字段
ad

object (Ad)

仅限输出。推荐的广告。
creationDate

string

仅限输出。推荐广告的创建日期。YYYY-MM-DD 格式，例如 2018-04-17。
autoApplyDate

string

仅限输出。如果有，即为自动采纳建议的最早日期。YYYY-MM-DD 格式，例如 2018-04-17。

TargetCpaOptInRecommendation

启用“目标每次转化费用”出价策略的建议。

JSON 表示法 
{
  "options": [
    {
      object (TargetCpaOptInRecommendationOption)
    }
  ],
  "recommendedTargetCpaMicros": string
}
字段
options[]

object (TargetCpaOptInRecommendationOption)

仅限输出。“目标每次转化费用”策略的可用目标和相应选项。
recommendedTargetCpaMicros

string (int64 format)

仅限输出。建议的平均每次转化费用目标。在选项列表中查看所需的预算金额以及采用此建议的影响。

TargetCpaOptInRecommendationOption

启用“目标每次转化费用”出价策略的选项以及估算的影响。

JSON 表示法 
{
  "goal": enum (TargetCpaOptInRecommendationGoal),
  "impact": {
    object (RecommendationImpact)
  },
  "targetCpaMicros": string,
  "requiredCampaignBudgetAmountMicros": string
}
字段
goal

enum (TargetCpaOptInRecommendationGoal)

仅限输出。此选项实现的目标。
impact

object (RecommendationImpact)

仅限输出。选择此选项后预计的影响估算值。
targetCpaMicros

string (int64 format)

仅限输出。平均每次转化费用目标。
requiredCampaignBudgetAmountMicros

string (int64 format)

仅限输出。为达到目标每次转化费用所需的最低广告系列预算（以本地货币表示）。金额以微单位指定，即一百万等同于一个货币单位。

TargetCpaOptInRecommendationGoal

TargetCpaOptIn 建议的目标。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
SAME_COST 建议设置目标每次转化费用，以保持费用不变。
SAME_CONVERSIONS 建议设置目标每次转化费用，以保持转化次数不变。
SAME_CPA 建议设置目标每次转化费用，以保持每次转化费用不变。
CLOSEST_CPA 建议将目标每次转化费用设置为尽可能接近但低于实际每次转化费用（针对过去 28 天计算得出的值）的值。

MaximizeConversionsOptInRecommendation

“尽可能提高转化次数”建议。

JSON 表示法 
{
  "recommendedBudgetAmountMicros": string
}
字段
recommendedBudgetAmountMicros

string (int64 format)

仅限输出。建议的新预算金额。

EnhancedCpcOptInRecommendation

此类型没有任何字段。

“选择采用智能点击付费”出价策略建议。

SearchPartnersOptInRecommendation

此类型没有任何字段。

搜索网络合作伙伴“选择启用”建议。

MaximizeClicksOptInRecommendation

启用“尽可能争取更多点击次数”出价策略的建议。

JSON 表示法 
{
  "recommendedBudgetAmountMicros": string
}
字段
recommendedBudgetAmountMicros

string (int64 format)

仅限输出。建议的新预算金额。仅在当前预算过高时设置。

OptimizeAdRotationRecommendation

此类型没有任何字段。

“优化广告轮播”建议。

KeywordMatchTypeRecommendation

关键字匹配类型建议。

JSON 表示法 
{
  "keyword": {
    object (KeywordInfo)
  },
  "recommendedMatchType": enum (KeywordMatchType)
}
字段
keyword

object (KeywordInfo)

仅限输出。匹配类型应更宽泛的现有关键字。
recommendedMatchType

enum (KeywordMatchType)

仅限输出。建议的新匹配类型。

MoveUnusedBudgetRecommendation

“转移未使用的预算”建议。

JSON 表示法 
{
  "budgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "excessCampaignBudget": string
}
字段
budgetRecommendation

object (CampaignBudgetRecommendation)

仅限输出。针对受限制的预算增加的建议。
excessCampaignBudget

string

仅限输出。超额预算的 resourceName。

TargetRoasOptInRecommendation

“目标广告支出回报率”出价策略启用建议。

JSON 表示法 
{
  "recommendedTargetRoas": number,
  "requiredCampaignBudgetAmountMicros": string
}
字段
recommendedTargetRoas

number

仅限输出。建议的目标广告支出回报率（每支出单位的收入）。该值介于 0.01 和 1000.0 之间（含 0.01 和 1000.0）。
requiredCampaignBudgetAmountMicros

string (int64 format)

仅限输出。为实现目标广告支出回报率所需的最低广告系列预算（以本地货币表示）。金额以微单位指定，即一百万等同于一个货币单位。

ResponsiveSearchAdRecommendation

关于添加自适应搜索广告的建议。

JSON 表示法 
{
  "ad": {
    object (Ad)
  }
}
字段
ad

object (Ad)

仅限输出。推荐的广告。

UseBroadMatchKeywordRecommendation

“使用广泛匹配关键字”建议。

JSON 表示法 
{
  "keyword": [
    {
      object (KeywordInfo)
    }
  ],
  "suggestedKeywordsCount": string,
  "campaignKeywordsCount": string,
  "campaignUsesSharedBudget": boolean,
  "requiredCampaignBudgetAmountMicros": string
}
字段
keyword[]

object (KeywordInfo)

仅限输出。将扩展为广泛匹配的关键字示例。
suggestedKeywordsCount

string (int64 format)

仅限输出。广告系列中要扩展为广泛匹配的关键字的总数。
campaignKeywordsCount

string (int64 format)

仅限输出。广告系列中的关键字总数。
campaignUsesSharedBudget

boolean

仅限输出。关联的广告系列是否使用共享预算。
requiredCampaignBudgetAmountMicros

string (int64 format)

仅限输出。建议的预算，以免在采纳建议后受预算限制。

ResponsiveSearchAdAssetRecommendation

关于添加自适应搜索广告素材资源的建议。

JSON 表示法 
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAssets": {
    object (Ad)
  }
}
字段
currentAd

object (Ad)

仅限输出。要更新的当前广告。
recommendedAssets

object (Ad)

仅限输出。推荐的素材资源。此字段仅填充新标题和/或广告内容描述，否则为空。

UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation

将智能购物广告系列升级为效果最大化广告系列建议。

JSON 表示法 
{
  "merchantId": string,
  "salesCountryCode": string
}
字段
merchantId

string (int64 format)

仅限输出。Merchant Center 帐号的 ID。
salesCountryCode

string

仅限输出。应添加商家商品目录中的商品的国家/地区。

ResponsiveSearchAdImproveAdStrengthRecommendation

自适应搜索广告的广告效力提升建议。

JSON 表示法 
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAd": {
    object (Ad)
  }
}
字段
currentAd

object (Ad)

仅限输出。要更新的当前广告。
recommendedAd

object (Ad)

仅限输出。已更新的广告。

DisplayExpansionOptInRecommendation

此类型没有任何字段。

“启用将展示广告网络也纳入投放范围”建议。

UpgradeLocalCampaignToPerformanceMaxRecommendation

此类型没有任何字段。

“将本地广告系列升级为效果最大化广告系列”建议。

RaiseTargetCpaBidTooLowRecommendation

“目标每次转化费用出价过低”建议。

JSON 表示法 
{
  "recommendedTargetMultiplier": number,
  "averageTargetCpaMicros": string
}
字段
recommendedTargetMultiplier

number

仅限输出。大于 1.0 的数字，表示我们建议将目标每次转化费用提高的系数。
averageTargetCpaMicros

string (int64 format)

仅限输出。广告系列当前的平均目标每次转化费用，以客户本地货币的微单位表示。

ForecastingSetTargetRoasRecommendation

预测功能设置了目标广告支出回报率建议。

JSON 表示法 
{
  "recommendedTargetRoas": number,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
字段
recommendedTargetRoas

number

仅限输出。建议的目标广告支出回报率（每支出单位的收入）。该值介于 0.01 和 1000.0 之间（含 0.01 和 1000.0）。
campaignBudget

object (CampaignBudget)

仅限输出。广告系列预算。

CampaignBudget

各种预算建议类型共用的广告系列预算。

JSON 表示法 
{
  "currentAmountMicros": string,
  "recommendedNewAmountMicros": string,
  "newStartDate": string
}
字段
currentAmountMicros

string (int64 format)

仅限输出。当前预算金额。
recommendedNewAmountMicros

string (int64 format)

仅限输出。建议的预算金额。
newStartDate

string

仅限输出。开始使用新预算的日期。您需要为以下建议类型设置此字段：FORECASTING_SET_TARGET_ROAS YYYY-MM-DD 格式，例如 2018-04-17。

CalloutAssetRecommendation

宣传信息素材资源建议。

JSON 表示法 
{
  "recommendedCampaignCalloutAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerCalloutAssets": [
    {
      object (Asset)
    }
  ]
}
字段
recommendedCampaignCalloutAssets[]

object (Asset)

仅限输出。建议在广告系列一级添加新的附加宣传信息素材资源。
recommendedCustomerCalloutAssets[]

object (Asset)

仅限输出。建议在客户一级添加新的附加宣传信息素材资源。

SitelinkAssetRecommendation

站内链接素材资源建议。

JSON 表示法 
{
  "recommendedCampaignSitelinkAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerSitelinkAssets": [
    {
      object (Asset)
    }
  ]
}
字段

CallAssetRecommendation

此类型没有任何字段。

电话素材资源建议。

ShoppingOfferAttributeRecommendation

购物建议：为因缺少某个属性而被降位的商品添加此属性。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "offersCount": string,
  "demotedOffersCount": string
}
字段
merchant

object (MerchantInfo)

仅限输出。Merchant Center 帐号的详细信息。
feedLabel

string

仅限输出。广告系列 Feed 标签。
offersCount

string (int64 format)

仅限输出。可投放的线上商品的数量。
demotedOffersCount

string (int64 format)

仅限输出。因缺少属性而被降位的可投放在线商品的数量。如需了解详情，请访问 Merchant Center。

MerchantInfo

Merchant Center 帐号详情。

JSON 表示法 
{
  "id": string,
  "name": string,
  "multiClient": boolean
}
字段
id

string (int64 format)

仅限输出。Merchant Center 帐号 ID。
name

string

仅限输出。Merchant Center 帐号的名称。
multiClient

boolean

仅限输出。Merchant Center 账号是否为多客户账号 (MCA)。

ShoppingAddProductsToCampaignRecommendation

关于向购物广告系列产品目录中添加产品的购物建议。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "reason": enum (Reason)
}
字段
merchant

object (MerchantInfo)

仅限输出。Merchant Center 帐号的详细信息。
feedLabel

string

仅限输出。广告系列的 Feed 标签。
reason

enum (Reason)

仅限输出。广告系列未附加任何产品的原因。

原因

导致购物广告系列未定位任何产品的问题。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS Merchant Center 账号中没有任何已提交的产品。
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS_IN_FEED 该 Merchant Center 账号的 Feed 中没有任何已提交的产品。
ADS_ACCOUNT_EXCLUDES_OFFERS_FROM_CAMPAIGN Google Ads 帐号设置了有效的广告系列过滤条件，导致产品无法添加到广告系列中。
ALL_PRODUCTS_ARE_EXCLUDED_FROM_CAMPAIGN 所有可售商品均已明确排除在广告系列的定位范围之外。

ShoppingFixDisapprovedProductsRecommendation

一条购物建议，用于解决购物广告系列产品目录中已被拒登的产品存在的问题。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "productsCount": string,
  "disapprovedProductsCount": string
}
字段
merchant

object (MerchantInfo)

仅限输出。Merchant Center 帐号的详细信息。
feedLabel

string

仅限输出。广告系列的 Feed 标签。
productsCount

string (int64 format)

仅限输出。广告系列的产品数量。
disapprovedProductsCount

string (int64 format)

仅限输出。广告系列中被拒登的产品数量。

ShoppingTargetAllOffersRecommendation

购物建议：制作定位到所有优惠的全包型广告系列。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "untargetedOffersCount": string,
  "feedLabel": string
}
字段
merchant

object (MerchantInfo)

仅限输出。Merchant Center 帐号的详细信息。
untargetedOffersCount

string (int64 format)

仅限输出。未定位的商品的数量。
feedLabel

string

仅限输出。优惠 Feed 标签。

ShoppingMerchantCenterAccountSuspensionRecommendation

用于解决 Merchant Center 账号中止问题的购物建议。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
字段
merchant

object (MerchantInfo)

仅限输出。Merchant Center 帐号的详细信息。
feedLabel

string

仅限输出。被暂停的广告系列的 Feed 标签。

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

购物建议：将常规购物广告系列定位的商品迁移到效果最大化广告系列。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
字段
merchant

object (MerchantInfo)

仅限输出。Merchant Center 帐号的详细信息。
feedLabel

string

仅限输出。共享此建议的广告系列所定位到的商品的 Feed 标签。

DynamicImageExtensionOptInRecommendation

此类型没有任何字段。

建议在账号中启用动态图片附加信息，以便 Google 从广告着陆页中找到最合适的图片，并对文字广告进行补充。

RaiseTargetCpaRecommendation

建议提高目标每次转化费用。

JSON 表示法 
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  },
  "appBiddingGoal": enum (AppBiddingGoal)
}
字段
targetAdjustment

object (TargetAdjustmentInfo)

仅限输出。描述建议的目标值调整的相关信息。
appBiddingGoal

enum (AppBiddingGoal)

仅限输出。表示出价策略应针对其进行优化的目标。系统只会针对应用广告系列填充此字段。

TargetAdjustmentInfo

目标值调整建议的相关信息。

JSON 表示法 
{
  "recommendedTargetMultiplier": number,
  "currentAverageTargetMicros": string,
  "sharedSet": string
}
字段
recommendedTargetMultiplier

number

仅限输出。我们建议调整目标的系数。
currentAverageTargetMicros

string (int64 format)

仅限输出。此建议所定位的广告系列或组合的当前平均目标值。
sharedSet

string

仅限输出。定义了目标的组合出价策略的共享集资源名称。仅当建议是组合级建议时，系统才会填充。

AppBiddingGoal

表示应用广告系列的出价策略应针对的目标进行优化。

枚举
UNSPECIFIED 未指定。
UNKNOWN 表示此版本 API 中未知的值。
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME 应用广告系列的出价策略应以尽可能提高应用安装量为目标。
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME 应用广告系列的出价策略应以尽可能提高所选应用内转化量为目标。
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE 应用广告系列的出价策略应以尽可能提高所有转化价值（即安装和选定的应用内转化）为目标。
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION 应用广告系列的出价策略应以仅最大限度提高所选应用内转化量为目标，同时达到或超过目标每次应用内转化费用。
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND 应用广告系列的出价策略应以尽可能提高所有转化价值（即安装和选定的应用内转化）为目标，同时达到或超出目标广告支出回报率。
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI 应用广告系列的这一出价策略应力求在没有广告客户提供的目标每次安装费用的情况下，尽可能提高应用安装量。
OPTIMIZE_FOR_PRE_REGISTRATION_CONVERSION_VOLUME 应用广告系列的这一出价策略应以尽可能提高应用的预注册量为目标。

LowerTargetRoasRecommendation

建议降低目标广告支出回报率。

JSON 表示法 
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  }
}
字段
targetAdjustment

object (TargetAdjustmentInfo)

仅限输出。描述建议的目标值调整的相关信息。

PerformanceMaxOptInRecommendation

此类型没有任何字段。

“选择启用效果最大化广告系列”建议。

ImprovePerformanceMaxAdStrengthRecommendation

建议将效果最大化广告系列的素材资源组效力提升为“极佳”评分。

JSON 表示法 
{
  "assetGroup": string
}
字段
assetGroup

string

仅限输出。素材资源组资源名称。

MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

从动态搜索广告迁移到效果最大化广告系列的建议。

JSON 表示法 
{
  "applyLink": string
}
字段

SearchTermView

搜索字词视图，其中包含按搜索字词在广告组一级汇总的指标。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (SearchTermTargetingStatus),
  "searchTerm": string,
  "adGroup": string
}
字段
resourceName

string

仅限输出。搜索字词视图的资源名称。搜索字词视图资源名称采用以下格式：

customers/{customerId}/searchTermViews/{campaignId}~{adGroupId}~{URL-base64_search_term}
status

enum (SearchTermTargetingStatus)

仅限输出。表明搜索字词当前是否属于您定位或排除的关键字。
searchTerm

string

仅限输出。搜索字词。
adGroup

string

仅限输出。在其中投放搜索字词的广告组。

SearchTermTargetingStatus

表明搜索字词是您定位的关键字还是已排除的关键字之一。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ADDED 搜索字词会添加到指定关键字中。
EXCLUDED 搜索字词与否定关键字匹配。
ADDED_EXCLUDED 搜索字词已添加和已排除。
NONE 系统既未定位也不排除搜索字词。

ShoppingPerformanceView

购物效果视图。提供在多个产品维度级别汇总的购物广告系列统计信息。Merchant Center 中的产品维度值（例如品牌、类别、自定义属性、产品使用情况和产品类型）反映的是每个维度在系统记录相应事件的日期和时间的状态。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。购物效果视图的资源名称。购物效果视图资源名称采用以下格式：customers/{customerId}/shoppingPerformanceView

SmartCampaignSearchTermView

智能广告系列搜索字词视图。

JSON 表示法 
{
  "resourceName": string,
  "searchTerm": string,
  "campaign": string
}
字段
resourceName

string

仅限输出。智能广告系列搜索字词视图的资源名称。智能广告系列搜索字词视图资源名称采用以下格式：

customers/{customerId}/smartCampaignSearchTermViews/{campaignId}~{URL-base64_search_term}
searchTerm

string

仅限输出。搜索字词。
campaign

string

仅限输出。在其中投放搜索字词的智能广告系列。

TopicView

主题视图。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。主题视图的资源名称。主题视图资源名称采用以下形式：

customers/{customerId}/topicViews/{adGroupId}~{criterionId}

TravelActivityGroupView

旅游活动组视图。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。旅行活动组视图的资源名称。旅游活动组视图资源名称采用以下格式：

customers/{customerId}/travelActivityGroupViews/{adGroupId}~{criterionId}

TravelActivityPerformanceView

旅行活动效果视图。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。旅行活动效果视图的资源名称。旅游活动效果视图资源名称采用以下格式：

customers/{customerId}/travelActivityPerformanceView

UserInterest

用户兴趣：要定位的基于兴趣的特定行业。

JSON 表示法 
{
  "resourceName": string,
  "taxonomyType": enum (UserInterestTaxonomyType),
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ],
  "userInterestId": string,
  "name": string,
  "userInterestParent": string,
  "launchedToAll": boolean
}
字段
resourceName

string

仅限输出。用户兴趣的资源名称。用户兴趣资源名称采用以下格式：

customers/{customerId}/userInterests/{userInterestId}
taxonomyType

enum (UserInterestTaxonomyType)

仅限输出。用户兴趣的类目类型。
availabilities[]

object (CriterionCategoryAvailability)

仅限输出。用户兴趣的可用性信息。
userInterestId

string (int64 format)

仅限输出。用户兴趣的 ID。
name

string

仅限输出。用户兴趣的名称。
userInterestParent

string

仅限输出。用户兴趣的父级。
launchedToAll

boolean

仅限输出。如果用户兴趣已发布到所有渠道和语言区域，则为 true。

UserInterestTaxonomyType

包含可能的 UserInterestTaxonomyType 的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
AFFINITY 此用户兴趣的相似性。
IN_MARKET 此用户兴趣的市场。
MOBILE_APP_INSTALL_USER 已知安装了指定类别的应用的用户。
VERTICAL_GEO 用户兴趣行业所在的地理位置。
NEW_SMART_PHONE_USER 智能手机新用户的用户兴趣条件。

LifeEvent

人生大事：一种基于兴趣的特定行业，旨在覆盖面临人生重大事件的用户。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
字段
resourceName

string

仅限输出。人生大事的资源名称。人生大事资源名称采用以下格式：

customers/{customerId}/lifeEvents/{lifeEventId}
id

string (int64 format)

仅限输出。人生大事的 ID。
name

string

仅限输出。人生大事的名称，例如“最近搬家”
parent

string

仅限输出。LifeEvent 的父级。
launchedToAll

boolean

仅限输出。如果人生大事已面向所有渠道和语言区域发布，则为 true。
availabilities[]

object (CriterionCategoryAvailability)

仅限输出。人生大事的可用性信息。

UserLocationView

用户地理位置视图。

用户地理位置视图包含国家/地区一级的所有汇总指标，每个国家/地区占一行。它会按已定位或未定位的地理位置报告用户实际地理位置的指标。如果使用了其他细分字段，每个国家/地区可能会占多行。

JSON 表示法 
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
字段
resourceName

string

仅限输出。用户位置视图的资源名称。UserLocation 视图资源名称采用以下格式：

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}
countryCriterionId

string (int64 format)

仅限输出。国家/地区的条件 ID。
targetingLocation

boolean

仅限输出。指明是否已定位地理位置。

TopicConstant

使用主题，根据展示位置所属的类别（例如“宠物与动物/宠物/狗”）定位或排除 Google 展示广告网络中的展示位置。

JSON 表示法 
{
  "resourceName": string,
  "path": [
    string
  ],
  "id": string,
  "topicConstantParent": string
}
字段
resourceName

string

仅限输出。主题常量的资源名称。主题常量资源名称的格式如下：

topicConstants/{topic_id}
path[]

string

仅限输出。要定位或排除的类别。数组中的每个后续元素描述的是更具体的子类别。例如，{"Pets & Animals", "Pets", "Dogs"} 表示“宠物与动物/宠物/狗”类别。您可以访问 https://developers.google.com/google-ads/api/reference/data/verticals，查看可用的主题类别列表。
id

string (int64 format)

仅限输出。主题的 ID。
topicConstantParent

string

仅限输出。主题常量的父级资源名称。

视频

视频。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "channelId": string,
  "durationMillis": string,
  "title": string
}
字段
resourceName

string

仅限输出。视频的资源名称。视频资源名称采用以下形式：

customers/{customerId}/videos/{videoId}
id

string

仅限输出。视频的 ID。
channelId

string

仅限输出。视频的所有者频道 ID。
durationMillis

string (int64 format)

仅限输出。视频的时长（以毫秒为单位）。
title

string

仅限输出。视频的标题。

WebpageView

一次网页浏览。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。网页视图的资源名称。网页视图资源名称的格式如下：

customers/{customerId}/webpageViews/{adGroupId}~{criterionId}

LeadFormSubmissionData

来自潜在客户表单提交的数据。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "asset": string,
  "campaign": string,
  "leadFormSubmissionFields": [
    {
      object (LeadFormSubmissionField)
    }
  ],
  "customLeadFormSubmissionFields": [
    {
      object (CustomLeadFormSubmissionField)
    }
  ],
  "adGroup": string,
  "adGroupAd": string,
  "gclid": string,
  "submissionDateTime": string
}
字段
resourceName

string

仅限输出。潜在客户表单提交数据的资源名称。潜在客户表单提交数据资源名称采用以下形式：

customers/{customerId}/leadFormSubmissionData/{lead_form_submission_data_id}
id

string

仅限输出。此潜在客户表单提交的 ID。
asset

string

仅限输出。与所提交的潜在客户表单相关联的素材资源。
campaign

string

仅限输出。与所提交的潜在客户表单相关联的广告系列。
leadFormSubmissionFields[]

object (LeadFormSubmissionField)

仅限输出。与潜在客户表单相关联的提交数据。
customLeadFormSubmissionFields[]

object (CustomLeadFormSubmissionField)

仅限输出。与自定义潜在客户表单相关联的提交数据。
adGroup

string

仅限输出。与所提交的潜在客户表单相关联的广告组。
adGroupAd

string

仅限输出。与所提交的潜在客户表单相关联的 AdGroupAd。
gclid

string

仅限输出。与提交的潜在客户表单相关联的 Google 点击 ID。
submissionDateTime

string

仅限输出。提交潜在客户表单的日期和时间。格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”，例如“2019-01-01 12:32:45-08:00”。

LeadFormSubmissionField

已提交的潜在客户表单中的字段。

JSON 表示法 
{
  "fieldType": enum (LeadFormFieldUserInputType),
  "fieldValue": string
}
字段
fieldType

enum (LeadFormFieldUserInputType)

仅限输出。潜在客户表单字段的字段类型。
fieldValue

string

仅限输出。潜在客户表单字段的字段值。

CustomLeadFormSubmissionField

提交的自定义问题中的字段

JSON 表示法 
{
  "questionText": string,
  "fieldValue": string
}
字段
questionText

string

仅限输出。自定义问题的问题文本，最多字符数为 300。
fieldValue

string

仅限输出。自定义问题回复的字段值，最大字符数为 70。

指标

指标数据。

JSON 表示法 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "skAdNetworkConversions": string,
  "publisherPurchasedClicks": string,
  "publisherOrganicClicks": string,
  "publisherUnknownClicks": string,
  "absoluteTopImpressionPercentage": number,
  "activeViewCpm": number,
  "activeViewCtr": number,
  "activeViewImpressions": string,
  "activeViewMeasurability": number,
  "activeViewMeasurableCostMicros": string,
  "activeViewMeasurableImpressions": string,
  "activeViewViewability": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allNewCustomerLifetimeValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "allConversionsFromStoreWebsite": number,
  "auctionInsightSearchAbsoluteTopImpressionPercentage": number,
  "auctionInsightSearchImpressionShare": number,
  "auctionInsightSearchOutrankingShare": number,
  "auctionInsightSearchOverlapRate": number,
  "auctionInsightSearchPositionAboveRate": number,
  "auctionInsightSearchTopImpressionPercentage": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpe": number,
  "averageCpm": number,
  "averageCpv": number,
  "averagePageViews": number,
  "averageTimeOnSite": number,
  "benchmarkAverageMaxCpc": number,
  "biddableAppInstallConversions": number,
  "biddableAppPostInstallConversions": number,
  "benchmarkCtr": number,
  "bounceRate": number,
  "clicks": string,
  "combinedClicks": string,
  "combinedClicksPerQuery": number,
  "combinedQueries": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "conversionLastReceivedRequestDateTime": string,
  "conversionLastConversionDate": string,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "conversionsValue": number,
  "newCustomerLifetimeValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "conversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "ctr": number,
  "currentModelAttributedConversions": number,
  "currentModelAttributedConversionsFromInteractionsRate": number,
  "currentModelAttributedConversionsFromInteractionsValuePerInteraction": number,
  "currentModelAttributedConversionsValue": number,
  "currentModelAttributedConversionsValuePerCost": number,
  "engagementRate": number,
  "engagements": string,
  "hotelAverageLeadValueMicros": number,
  "hotelCommissionRateMicros": string,
  "hotelExpectedCommissionCost": number,
  "hotelPriceDifferencePercentage": number,
  "hotelEligibleImpressions": string,
  "historicalQualityScore": string,
  "gmailForwards": string,
  "gmailSaves": string,
  "gmailSecondaryClicks": string,
  "impressionsFromStoreReach": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "messageChats": string,
  "messageImpressions": string,
  "messageChatRate": number,
  "mobileFriendlyClicksPercentage": number,
  "optimizationScoreUplift": number,
  "optimizationScoreUrl": string,
  "organicClicks": string,
  "organicClicksPerQuery": number,
  "organicImpressions": string,
  "organicImpressionsPerQuery": number,
  "organicQueries": string,
  "percentNewVisitors": number,
  "phoneCalls": string,
  "phoneImpressions": string,
  "phoneThroughRate": number,
  "relativeCtr": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "searchVolume": {
    object (SearchVolumeRange)
  },
  "speedScore": string,
  "averageTargetCpaMicros": string,
  "averageTargetRoas": number,
  "topImpressionPercentage": number,
  "validAcceleratedMobilePagesClicksPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "valuePerCurrentModelAttributedConversion": number,
  "videoQuartileP100Rate": number,
  "videoQuartileP25Rate": number,
  "videoQuartileP50Rate": number,
  "videoQuartileP75Rate": number,
  "videoViewRate": number,
  "videoViews": string,
  "viewThroughConversions": string,
  "allConversionsFromLocationAssetClickToCall": number,
  "allConversionsFromLocationAssetDirections": number,
  "allConversionsFromLocationAssetMenu": number,
  "allConversionsFromLocationAssetOrder": number,
  "allConversionsFromLocationAssetOtherEngagement": number,
  "allConversionsFromLocationAssetStoreVisits": number,
  "allConversionsFromLocationAssetWebsite": number,
  "eligibleImpressionsFromLocationAssetStoreReach": string,
  "viewThroughConversionsFromLocationAssetClickToCall": number,
  "viewThroughConversionsFromLocationAssetDirections": number,
  "viewThroughConversionsFromLocationAssetMenu": number,
  "viewThroughConversionsFromLocationAssetOrder": number,
  "viewThroughConversionsFromLocationAssetOtherEngagement": number,
  "viewThroughConversionsFromLocationAssetStoreVisits": number,
  "viewThroughConversionsFromLocationAssetWebsite": number
}
字段
allConversionsValueByConversionDate

number

所有转化的价值。如果选择了此列和日期，日期列中的值表示转化日期。有关 by_conversion_date 列的详细信息，请访问 https://support.google.com/google-ads/answer/9549009。
allConversionsByConversionDate

number

转化总次数。此指标会纳入所有转化次数，而不考虑 includeInConversionMetric 的值。如果选择了此列和日期，日期列中的值表示转化日期。有关 by_conversion_date 列的详细信息，请访问 https://support.google.com/google-ads/answer/9549009。
conversionsValueByConversionDate

number

转化价值。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价策略，您的出价策略将以促成这些转化为目标进行优化。如果选择了此列和日期，日期列中的值表示转化日期。有关 by_conversion_date 列的详细信息，请访问 https://support.google.com/google-ads/answer/9549009。
conversionsByConversionDate

number

转化次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价策略，您的出价策略将以促成这些转化为目标进行优化。如果选择了此列和日期，日期列中的值表示转化日期。有关 by_conversion_date 列的详细信息，请访问 https://support.google.com/google-ads/answer/9549009。
historicalCreativeQualityScore

enum (QualityScoreBucket)

广告素材的历史质量得分。
historicalLandingPageQualityScore

enum (QualityScoreBucket)

历史着陆页体验的质量。
historicalSearchPredictedCtr

enum (QualityScoreBucket)

历史搜索网络预测点击率 (CTR)。
interactionEventTypes[]

enum (InteractionEventType)

付费和免费互动的类型。
skAdNetworkConversions

string (int64 format)

iOS Store Kit 广告网络转化次数。
publisherPurchasedClicks

string (int64 format)

来自并非由发布商所拥有的媒体资源的点击，其流量是由发布商付费或通过奖励活动获得的
publisherOrganicClicks

string (int64 format)

发布商未因激励活动付费或通过激励活动获得的流量的媒体资源带来的点击
publisherUnknownClicks

string (int64 format)

来自未被标识为“发布商购买”或“发布商自然”的流量的点击次数
absoluteTopImpressionPercentage

number

“搜索网络绝对页首展示次数份额”是指搜索广告在最显眼的搜索广告位置获得的展示次数所占的百分比。
activeViewCpm

number

可见展示的平均费用 (activeViewImpressions)。
activeViewCtr

number

Active View 可衡量点击次数除以 Active View 可见展示次数。

系统仅针对展示广告网络报告此指标。
activeViewImpressions

string (int64 format)

衡量广告在展示广告网络网站上的可见频率。
activeViewMeasurability

number

Active View 可衡量的展示次数与投放展示次数之比。
activeViewMeasurableCostMicros

string (int64 format)

Active View 可衡量的您获得的展示费用。
activeViewMeasurableImpressions

string (int64 format)

广告出现在可见位置中的展示位置的次数。
activeViewViewability

number

广告出现在启用了 Active View 的网站上（可衡量的展示次数）且可见（可见的展示次数）的时间百分比。
allConversionsFromInteractionsRate

number

互动带来的所有转化（与浏览型转化不同）次数除以广告互动次数。
allConversionsValue

number

所有转化的值。
allNewCustomerLifetimeValue

number

所有新客户的生命周期价值。如果您已在账号一级或广告系列一级设置客户获取目标，则对于可出价和不可出价转化，新客户获取的额外转化价值都会包括在内。如果您的广告系列已采用客户获取目标，并选择“针对新客户提高出价”，这些值将包含在“allConversionValue”。请参阅 https://support.google.com/google-ads/answer/12080169 了解详情。
allConversions

number

转化总次数。此指标会纳入所有转化次数，而不考虑 includeInConversionMetric 的值。
allConversionsValuePerCost

number

所有转化的价值除以广告互动（例如文字广告获得的点击或视频广告获得的观看）的总费用。
allConversionsFromClickToCall

number

用户在点击广告后，或是在点击广告后，点击“致电”按钮向商店致电的次数。此数值不考虑通话是否接通或通话时长。

此指标仅适用于 Feed 项。
allConversionsFromDirections

number

用户在点击广告后，点击“查询路线”按钮导航到相应商店的次数。

此指标仅适用于 Feed 项。
allConversionsFromInteractionsValuePerInteraction

number

互动带来的所有转化的价值除以总互动次数。
allConversionsFromMenu

number

用户在点击广告后，点击链接查看商店菜单的次数。

此指标仅适用于 Feed 项。
allConversionsFromOrder

number

用户在点击广告后在商店下单的次数。

此指标仅适用于 Feed 项。
allConversionsFromOtherEngagement

number

用户点击广告后发生的其他转化（例如，发布对商店的评价或保存该商店的营业地点）的次数。

此指标仅适用于 Feed 项。
allConversionsFromStoreVisit

number

用户在点击广告后光顾相应实体店的次数的估算值。

此指标仅适用于 Feed 项。
allConversionsFromStoreWebsite

number

用户在点击广告后转到相应商店网址的次数。

此指标仅适用于 Feed 项。
auctionInsightSearchAbsoluteTopImpressionPercentage

number

该指标是“竞价分析”报告的一部分，展示了其他参与者的广告在搜索结果页上最显眼位置展示的频率。此百分比仅根据您在该网页上显示的竞价计算得出。

此指标尚未公开发布。
auctionInsightSearchImpressionShare

number

该指标是“竞价分析”报告的一部分，显示其他参与者获得的展示次数在您的广告有资格获得的总展示次数中所占的百分比。任何低于 0.1 的值都会报告为 0.0999。

此指标尚未公开发布。
auctionInsightSearchOutrankingShare

number

该指标是“竞价分析”报告的一部分，会显示在竞价中击败其他参与者（高于其他参与者）的展示次数在您的广告有资格获得的总展示次数中所占的百分比。任何低于 0.1 的值都会报告为 0.0999。

此指标尚未公开发布。
auctionInsightSearchOverlapRate

number

该指标是“竞价分析”报告的一部分，展示了您的广告获得展示机会的同时，其他参与者的广告也获得展示机会的频率。

此指标尚未公开发布。
auctionInsightSearchPositionAboveRate

number

该指标是“竞价分析”报告的一部分，可以显示当您的广告与另一参与者的广告在同一页面上展示时，其他参与者的广告在排名上高过您的频率。

此指标尚未公开发布。
auctionInsightSearchTopImpressionPercentage

number

该指标是“竞价分析”报告的一部分，展示了其他参与者的广告在热门自然搜索结果旁边展示的频率。此百分比仅根据您在该网页上显示的竞价计算得出。

此指标尚未公开发布。
averageCost

number

您为每次互动支付的平均金额。此金额是广告的总费用除以互动总次数。
averageCpc

number

所有点击总费用除以获得的总点击次数。
averageCpe

number

您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。
averageCpm

number

平均每千次展示费用 (CPM)。
averageCpv

number

每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。
averagePageViews

number

每个会话浏览网页的平均次数。
averageTimeOnSite

number

所有会话的总时长（以秒为单位）/会话数。自 Google Analytics（分析）导入。
benchmarkAverageMaxCpc

number

反映其他广告客户对类似产品的出价情况。
biddableAppInstallConversions

number

应用安装次数。
biddableAppPostInstallConversions

number

应用内操作的数量。
benchmarkCtr

number

根据用户看到其广告的频率，显示其他广告主针对类似产品的购物广告的效果。
bounceRate

number

用户只访问了网站上的单个网页时使用的点击次数所占百分比。自 Google Analytics（分析）导入。
clicks

string (int64 format)

点击次数。
combinedClicks

string (int64 format)

您的广告或网站的商品详情在未付费结果中的点击次数。如需了解详情，请参阅帮助页面：https://support.google.com/google-ads/answer/3097241。
combinedClicksPerQuery

number

您的广告或网站在非付费搜索结果中获得点击的次数 (combinedClicks) 除以 mergeQuery 次数。如需了解详情，请参阅帮助页面：https://support.google.com/google-ads/answer/3097241。
combinedQueries

string (int64 format)

在未付费结果中返回您的网站的网页或展示一个文字广告的搜索次数。如需了解详情，请参阅帮助页面：https://support.google.com/google-ads/answer/3097241。
contentBudgetLostImpressionShare

number

您的广告有资格在展示广告网络中展示但由于预算过低而未展示的次数的估算百分比。注意：内容预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
contentImpressionShare

number

您在展示广告网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意：内容展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
conversionLastReceivedRequestDateTime

string

此转化操作的转化跟踪代码上次成功触发并被 Google Ads 看到的日期/时间。此触发事件可能不是由可归因的转化导致的（例如，由于代码是从浏览器触发的，而浏览器之前未点击过相应广告客户的广告）。日期/时间采用客户所在的时区。
conversionLastConversionDate

string

此转化操作的最近一次转化的日期。该日期采用客户所在的时区。
contentRankLostImpressionShare

number

您的广告由于广告评级差而未在展示广告网络中获得的展示次数的估算百分比。注意：内容排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
conversionsFromInteractionsRate

number

互动带来的转化次数除以广告互动次数（例如文字广告点击次数或视频广告观看次数）。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
conversionsValue

number

转化价值。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
newCustomerLifetimeValue

number

新客户的生命周期价值。如果您已在账号一级或广告系列一级设置客户获取目标，则对于可出价转化，新客户获取的额外转化价值也会包含在内。如果您的广告系列已采用客户获取目标，并选择“针对新客户提高出价”，这些值将会纳入到“conversionsValue”以进行优化。请参阅 https://support.google.com/google-ads/answer/12080169 了解详情。
conversionsValuePerCost

number

转化价值除以广告互动费用。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
conversionsFromInteractionsValuePerInteraction

number

互动带来的转化价值除以广告互动次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
conversions

number

转化次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
costMicros

string (int64 format)

在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。
costPerAllConversions

number

广告互动费用除以所有转化次数。
costPerConversion

number

广告互动费用除以转化次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
costPerCurrentModelAttributedConversion

number

广告互动费用除以当前模型归因转化次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
crossDeviceConversions

number

客户在一台设备上点击 Google Ads 广告，然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 allConversion 中。
ctr

number

广告获得的点击次数（点击次数）除以广告展示次数（展示次数）。
currentModelAttributedConversions

number

显示历史转化数据在您目前选择的归因模型下的情况。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
currentModelAttributedConversionsFromInteractionsRate

number

当前模型根据互动带来的转化次数除以广告互动的次数（例如，对文字广告来说是点击次数，对视频广告来说就是观看）。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
currentModelAttributedConversionsFromInteractionsValuePerInteraction

number

当前模型归因转化的价值除以广告互动次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
currentModelAttributedConversionsValue

number

当前模型归因转化的价值。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
currentModelAttributedConversionsValuePerCost

number

当前模型归因转化的价值除以广告互动的费用。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
engagementRate

number

在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。
engagements

string (int64 format)

深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外，将来其他广告类型可能也会支持互动指标。
hotelAverageLeadValueMicros

number

根据点击次数得出的平均潜在客户价值。
hotelCommissionRateMicros

string (int64 format)

佣金出价率（以微单位表示）。20% 的佣金表示为 200,000。
hotelExpectedCommissionCost

number

预期的佣金费用。将佣金值乘以 Hotel_commission_rate（广告客户币种）所得的结果。
hotelPriceDifferencePercentage

number

报告酒店广告客户提供的价格与竞争对手提供的最低价格之间的平均价格差。
hotelEligibleImpressions

string (int64 format)

酒店合作伙伴为其 Feed 效果可获得的展示次数。
historicalQualityScore

string (int64 format)

历史质量得分。
gmailForwards

string (int64 format)

广告以邮件形式转发给其他人的次数。
gmailSaves

string (int64 format)

某人将 Gmail 广告以邮件形式保存到收件箱的次数。
gmailSecondaryClicks

string (int64 format)

Gmail 广告展开状态下的着陆页点击次数。
impressionsFromStoreReach

string (int64 format)

商店特定营业点的广告所展示的次数。

此指标仅适用于 Feed 项。
impressions

string (int64 format)

广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。
interactionRate

number

在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。
interactions

string (int64 format)

互动次数。互动是指与某种广告格式关联的主用户操作：对于文字广告和购物广告而言是点击，对于视频广告而言是观看，诸如此类。
invalidClickRate

number

报告期内从总点击次数（过滤后 + 未过滤的点击次数）过滤出的点击次数所占的百分比。
invalidClicks

string (int64 format)

Google 认为不合规定且不向您收费的点击次数。
messageChats

string (int64 format)

为符合消息跟踪条件的“点击发短信”展示发起的消息聊天数。
messageImpressions

string (int64 format)

符合消息跟踪条件的“点击发短信”信息的展示次数。
messageChatRate

number

发起的消息聊天次数 (messageChat) 除以消息展示次数 (messageImpressions)。在启用了消息选项和消息跟踪的情况下，用户在广告展示中发起消息聊天的时间间隔。请注意，对于指定的消息展示，此比率可能会大于 1.0。
mobileFriendlyClicksPercentage

number

适合移动设备的页面的移动点击次数所占的百分比。
optimizationScoreUplift

number

所有建议带来的优化得分总提升幅度。
optimizationScoreUrl

string

Google Ads 网页界面中“优化得分”页面的网址。您可以从customer或campaign中选择此指标，并可按segments.recommendation_type细分。例如，对于每个唯一的 (customer, goalType) 组合，SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer 将返回一个网址。
organicClicks

string (int64 format)

某人针对特定查询点击未付费结果中您的网站的商品详情的次数。如需了解详情，请参阅帮助页面：https://support.google.com/google-ads/answer/3097241。
organicClicksPerQuery

number

用户在非付费搜索结果中点击您网站的商家信息的次数 (organicClicks) 除以返回了您网站网页的搜索总次数 (organicQuery)。如需了解详情，请参阅帮助页面：https://support.google.com/google-ads/answer/3097241。
organicImpressions

string (int64 format)

未付费搜索结果中您的网站的商品详情数。如需了解详情，请参阅帮助页面：https://support.google.com/google-ads/answer/3097241。
organicImpressionsPerQuery

number

您网站中的网页在非付费搜索结果中列出的次数 (organicImpression) 除以在非付费搜索结果中返回网站列表的搜索次数 (organicQuery)。如需了解详情，请参阅帮助页面：https://support.google.com/google-ads/answer/3097241。
organicQueries

string (int64 format)

在未付费结果中返回您的网站的商品详情的总搜索次数。如需了解详情，请参阅帮助页面：https://support.google.com/google-ads/answer/3097241。
percentNewVisitors

number

首次会话数（来自之前从未访问过您的网站的用户）所占的百分比。自 Google Analytics（分析）导入。
phoneCalls

string (int64 format)

离线通话次数。
phoneImpressions

string (int64 format)

离线电话号码展示次数。
phoneThroughRate

number

接到的来电次数（通话次数）除以电话号码的展示次数 (phoneImpressions)。
relativeCtr

number

您的点击率 (Ctr) 除以展示您的广告的网站上所有广告主的平均点击率。衡量您的广告与同一网站上的其他广告相比在展示广告网络中的效果。
searchAbsoluteTopImpressionShare

number

在最显眼购物位置展示的客户的购物或搜索广告展示次数所占百分比。如需了解详情，请访问 https://support.google.com/google-ads/answer/7501826。任何低于 0.1 的值都会报告为 0.0999。
searchBudgetLostAbsoluteTopImpressionShare

number

此指标表示您的广告因预算不足而不是搜索结果中排名靠前的广告中作为首条广告的频率。注意：搜索网络预算错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchBudgetLostImpressionShare

number

您的广告有资格在搜索网络中展示但由于预算过低而未展示的次数的估算百分比。注意：搜索网络预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchBudgetLostTopImpressionShare

number

此指标表示您的广告因预算不足而未能在热门自然搜索结果旁边展示的频率。注意：搜索网络预算错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchClickShare

number

您在搜索网络中获得的点击次数除以您有资格获得的估算点击次数。注意：搜索网络点击次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
searchExactMatchImpressionShare

number

对于与关键字完全匹配（或是关键字的紧密变体形式）的搜索字词，此字段是您获得的展示次数除以您有资格在搜索网络上获得的估算展示次数。注意：搜索网络完全匹配展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
searchImpressionShare

number

您在搜索网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意：在搜索网络中获得的展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
searchRankLostAbsoluteTopImpressionShare

number

该指标用于估算您的广告因广告评级较低而并非搜索结果中效果最好的广告中的首条广告的频率。注意：搜索网络排名错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchRankLostImpressionShare

number

您的广告由于广告评级差而未在搜索网络中获得的展示次数的估算百分比。注意：搜索网络排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchRankLostTopImpressionShare

number

此指标表示您的广告因广告评级较低而未能在热门自然搜索结果旁边展示的频率。注意：搜索网络排名错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchTopImpressionShare

number

您在热门广告中实际获得的展示次数与您有资格获得的估算展示次数之比。注意：搜索网络页首展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。

页首广告通常展示在顶部自然搜索结果上方，但在某些查询中，页首广告可能会展示在顶部自然搜索结果下方。
searchVolume

object (SearchVolumeRange)

搜索字词数据分析类别的搜索量范围。
speedScore

string (int64 format)

衡量点击移动广告后网页加载的速度。得分范围介于 1 到 10 之间，10 是最快的。
averageTargetCpaMicros

string (int64 format)

平均目标每次转化费用，如果未提供，则为未设置（例如，广告系列获得的流量来自组合出价策略或未启用目标每次转化费用）。
averageTargetRoas

number

平均目标广告支出回报率；如果未提供，则为未设置（例如，广告系列获得的流量来自组合出价策略或非目标广告支出回报率）。
topImpressionPercentage

number

在顶部自然搜索结果旁边展示的广告展示次数所占的百分比。
validAcceleratedMobilePagesClicksPercentage

number

到达有效 AMP 网页的 Accelerated Mobile Pages (AMP) 着陆页的广告点击次数所占百分比。
valuePerAllConversions

number

所有转化的价值除以所有转化的次数。
valuePerAllConversionsByConversionDate

number

所有转化的价值除以所有转化次数。如果选择了此列和日期，日期列中的值表示转化日期。有关 by_conversion_date 列的详细信息，请访问 https://support.google.com/google-ads/answer/9549009。
valuePerConversion

number

转化价值除以转化次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
valuePerConversionsByConversionDate

number

转化价值除以转化次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价策略，您的出价策略将以促成这些转化为目标进行优化。如果选择了此列和日期，日期列中的值表示转化日期。有关 by_conversion_date 列的详细信息，请访问 https://support.google.com/google-ads/answer/9549009。
valuePerCurrentModelAttributedConversion

number

当前模型归因转化的价值除以转化次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
videoQuartileP100Rate

number

观看者观看了您的所有视频时使用的展示次数所占百分比。
videoQuartileP25Rate

number

观看者观看了 25% 的视频时使用的展示次数所占百分比。
videoQuartileP50Rate

number

观看者观看了 50% 的视频时使用的展示次数所占百分比。
videoQuartileP75Rate

number

观看者观看了 75% 的视频时使用的展示次数所占百分比。
videoViewRate

number

TrueView 视频广告获得的观看次数除以其展示次数，包括 TrueView 展示广告的缩略图展示次数。
videoViews

string (int64 format)

视频广告的观看次数。
viewThroughConversions

string (int64 format)

浏览型转化的总次数。当客户看到图片或富媒体广告，之后在您的网站上完成转化而不与另一个广告互动（例如，点击）时，就会发生这种情况。
allConversionsFromLocationAssetClickToCall

number

付费广告事件（点击或展示）发生后，营业地点表面的“致电”按钮获得的点击次数。此衡量依据的是基于素材资源的地理位置。
allConversionsFromLocationAssetDirections

number

发生收费广告事件（点击或展示）后，任意位置表面上的行车路线点击次数。此衡量依据的是基于素材资源的地理位置。
allConversionsFromLocationAssetMenu

number

付费广告事件（点击或展示）发生后，营业地点表面上获得的菜单链接点击次数。此衡量依据的是基于素材资源的地理位置。
allConversionsFromLocationAssetOrder

number

发生付费广告事件（点击或展示）后，任意位置表面上的订单点击次数。此衡量依据的是基于素材资源的地理位置。
allConversionsFromLocationAssetOtherEngagement

number

付费广告事件（点击或展示）发生后，任意营业地点平台上其他类型的本地操作获得的点击次数。此衡量依据的是基于素材资源的地理位置。
allConversionsFromLocationAssetStoreVisits

number

付费广告事件（点击或展示）发生后的实体店光顾次数估算值。此衡量依据的是基于素材资源的地理位置。
allConversionsFromLocationAssetWebsite

number

发生收费广告事件（点击或展示）后，任意位置呈现的网站网址点击次数。此衡量依据的是基于素材资源的地理位置。
eligibleImpressionsFromLocationAssetStoreReach

string (int64 format)

展示实体店营业地点或使用该地理位置进行定位的展示次数。此衡量依据的是基于素材资源的地理位置。
viewThroughConversionsFromLocationAssetClickToCall

number

广告展示后，营业地点平台上的“致电”按钮获得的点击次数。此衡量依据的是基于素材资源的地理位置。
viewThroughConversionsFromLocationAssetDirections

number

广告展示后，任意位置表面上的行车路线获得的点击次数。此衡量依据的是基于素材资源的地理位置。
viewThroughConversionsFromLocationAssetMenu

number

广告展示后，营业地点平台上的菜单链接获得的点击次数。此衡量依据的是基于素材资源的地理位置。
viewThroughConversionsFromLocationAssetOrder

number

广告展示后，任意位置平台上的订单点击次数。此衡量依据的是基于素材资源的地理位置。
viewThroughConversionsFromLocationAssetOtherEngagement

number

广告展示后，任意营业地点平台上其他类型的本地操作获得的点击次数。此衡量依据的是基于素材资源的地理位置。
viewThroughConversionsFromLocationAssetStoreVisits

number

广告展示后获得的估算实体店客流量。此衡量依据的是基于素材资源的地理位置。
viewThroughConversionsFromLocationAssetWebsite

number

广告展示后，任意位置表面上的网站网址获得的点击次数。此衡量依据的是基于素材资源的地理位置。

InteractionEventType

描述可能的应付和免费互动类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
CLICK 点击访问网站。在大多数情况下，这种互动会导航至外部位置，通常是广告客户的着陆页。这也是点击事件的默认 InteractionEventType。
ENGAGEMENT 用户表达的意向就地与广告互动。
VIDEO_VIEW 用户观看了一则视频广告。
NONE 广告转化事件的默认 InteractionEventType。如果广告转化行没有指明免费互动（例如广告转化）应“推广”并作为核心指标的一部分进行报告，则使用此方法。这些只是其他（广告）转化。

SearchVolumeRange

搜索量范围。实际搜索量在此范围内。

JSON 表示法 
{
  "min": string,
  "max": string
}
字段
min

string (int64 format)

搜索量的下限。
max

string (int64 format)

搜索量上限。

路段

仅限细分的字段。

JSON 表示法 
{
  "adDestinationType": enum (AdDestinationType),
  "adNetworkType": enum (AdNetworkType),
  "budgetCampaignAssociationStatus": {
    object (BudgetCampaignAssociationStatus)
  },
  "clickType": enum (ClickType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionAttributionEventType": enum (ConversionAttributionEventType),
  "conversionLagBucket": enum (ConversionLagBucket),
  "conversionOrAdjustmentLagBucket": enum (ConversionOrAdjustmentLagBucket),
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "externalConversionSource": enum (ExternalConversionSource),
  "hotelCheckInDayOfWeek": enum (DayOfWeek),
  "hotelDateSelectionType": enum (HotelDateSelectionType),
  "hotelRateType": enum (HotelRateType),
  "hotelPriceBucket": enum (HotelPriceBucket),
  "keyword": {
    object (Keyword)
  },
  "monthOfYear": enum (MonthOfYear),
  "placeholderType": enum (PlaceholderType),
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "recommendationType": enum (RecommendationType),
  "searchEngineResultsPageType": enum (SearchEngineResultsPageType),
  "searchTermMatchType": enum (SearchTermMatchType),
  "slot": enum (Slot),
  "conversionValueRulePrimaryDimension": enum (ConversionValueRulePrimaryDimension),
  "skAdNetworkUserType": enum (SkAdNetworkUserType),
  "skAdNetworkAdEventType": enum (SkAdNetworkAdEventType),
  "skAdNetworkAttributionCredit": enum (SkAdNetworkAttributionCredit),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "activityAccountId": string,
  "activityRating": string,
  "externalActivityId": string,
  "adGroup": string,
  "assetGroup": string,
  "auctionInsightDomain": string,
  "campaign": string,
  "conversionAction": string,
  "conversionActionName": string,
  "conversionAdjustment": boolean,
  "date": string,
  "geoTargetAirport": string,
  "geoTargetCanton": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetCounty": string,
  "geoTargetDistrict": string,
  "geoTargetMetro": string,
  "geoTargetMostSpecificLocation": string,
  "geoTargetPostalCode": string,
  "geoTargetProvince": string,
  "geoTargetRegion": string,
  "geoTargetState": string,
  "hotelBookingWindowDays": string,
  "hotelCenterId": string,
  "hotelCheckInDate": string,
  "hotelCity": string,
  "hotelClass": integer,
  "hotelCountry": string,
  "hotelLengthOfStay": integer,
  "hotelRateRuleId": string,
  "hotelState": string,
  "hour": integer,
  "interactionOnThisExtension": boolean,
  "month": string,
  "partnerHotelId": string,
  "productAggregatorId": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productFeedLabel": string,
  "productItemId": string,
  "productLanguage": string,
  "productMerchantId": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "searchSubcategory": string,
  "searchTerm": string,
  "webpage": string,
  "week": string,
  "year": integer,
  "skAdNetworkConversionValue": string,
  "skAdNetworkSourceApp": {
    object (SkAdNetworkSourceApp)
  },
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
字段
adDestinationType

enum (AdDestinationType)

广告目标页面类型。
adNetworkType

enum (AdNetworkType)

广告网络类型。
budgetCampaignAssociationStatus

object (BudgetCampaignAssociationStatus)

预算广告系列的关联状态。
clickType

enum (ClickType)

点击类型。
conversionActionCategory

enum (ConversionActionCategory)

转化操作类别。
conversionAttributionEventType

enum (ConversionAttributionEventType)

转化归因事件类型。
conversionLagBucket

enum (ConversionLagBucket)

表示展示和转化之间相差的天数的枚举值。
conversionOrAdjustmentLagBucket

enum (ConversionOrAdjustmentLagBucket)

一个枚举值，用于表示从展示和转化之间相隔的天数，或展示与转化调整之间相隔的天数。
dayOfWeek

enum (DayOfWeek)

星期几，例如 MONDAY。
device

enum (Device)

应用指标的设备。
externalConversionSource

enum (ExternalConversionSource)

外部转化来源。
hotelCheckInDayOfWeek

enum (DayOfWeek)

酒店入住日（星期几）。
hotelDateSelectionType

enum (HotelDateSelectionType)

酒店日期选择类型。
hotelRateType

enum (HotelRateType)

酒店房价类型。
hotelPriceBucket

enum (HotelPriceBucket)

酒店价格范围。
keyword

object (Keyword)

关键字条件。
monthOfYear

enum (MonthOfYear)

一年中的月份，例如 1 月。
placeholderType

enum (PlaceholderType)

占位符类型。此字段仅用于 Feed 项指标。
productChannel

enum (ProductChannel)

商品的渠道。
productChannelExclusivity

enum (ProductChannelExclusivity)

商品的渠道独占性。
productCondition

enum (ProductCondition)

商品的使用情况。
recommendationType

enum (RecommendationType)

建议类型。
searchEngineResultsPageType

enum (SearchEngineResultsPageType)

搜索引擎结果页 (SERP) 的类型。
searchTermMatchType

enum (SearchTermMatchType)

触发广告的关键字的匹配类型，包括变体。
slot

enum (Slot)

广告的位置。
conversionValueRulePrimaryDimension

enum (ConversionValueRulePrimaryDimension)

已应用的转化价值规则的主要维度。NO_RULE_APPLIED 显示未应用价值规则的转化总价值。ORIGINAL 显示的是已应用价值规则的转化的原始价值。GEO_LOCATION、DEVICE、AUDIENCE 显示的是应用价值规则后的净调整值。
skAdNetworkUserType

enum (SkAdNetworkUserType)

iOS Store Kit 广告网络用户类型。
skAdNetworkAdEventType

enum (SkAdNetworkAdEventType)

iOS Store Kit 广告网络广告事件类型。
skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

iOS Store Kit 广告网络归因功劳
newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

适用于按用户是新客户还是回头客来细分转化。这种细分通常用于衡量客户获取目标的影响。
activityAccountId

string (int64 format)

活动帐号 ID。
activityRating

string (int64 format)

活动评分。
externalActivityId

string

广告客户提供的活动 ID。
adGroup

string

广告组的资源名称。
assetGroup

string

素材资源组的资源名称。
auctionInsightDomain

string

竞价分析报告中参与者的域名（可见网址）。
campaign

string

广告系列的资源名称。
conversionAction

string

转化操作的资源名称。
conversionActionName

string

转化操作名称。
conversionAdjustment

boolean

这会按原始转化次数和转化价值与增量（如果转化经过调整）对转化列进行细分。False 行包含最初陈述的数据；而 true 行包含当前数据与最初所述数据之间的增量。将两者相加的结果调整后数据。
date

string

指标适用的日期。yyyy-MM-dd 格式，例如 2018-04-17。
geoTargetAirport

string

表示机场的地理位置定位常量的资源名称。
geoTargetCanton

string

表示行政区划的地理位置定位常量的资源名称。
geoTargetCity

string

表示城市的地理位置定位目标常量的资源名称。
geoTargetCountry

string

表示国家/地区的地理位置定位常量的资源名称。
geoTargetCounty

string

表示国家/地区的地理位置定位常量的资源名称。
geoTargetDistrict

string

表示地区的地理位置定位常量的资源名称。
geoTargetMetro

string

代表都市圈的地理位置定位目标常量的资源名称。
geoTargetMostSpecificLocation

string

代表最具体位置的地理位置定位目标常量的资源名称。
geoTargetPostalCode

string

表示邮政编码的地理位置定位常量的资源名称。
geoTargetProvince

string

表示省/自治区/直辖市的地理位置定位常量的资源名称。
geoTargetRegion

string

代表区域的地理位置定位目标常量的资源名称。
geoTargetState

string

表示州/省/自治区/直辖市的地理位置定位常量的资源名称。
hotelBookingWindowDays

string (int64 format)

酒店预订期限（天）。
hotelCenterId

string (int64 format)

Hotel Center ID。
hotelCheckInDate

string

酒店入住日期。格式为 yyyy-MM-dd。
hotelCity

string

酒店所在的城市。
hotelClass

integer

酒店星级。
hotelCountry

string

酒店所在的国家/地区。
hotelLengthOfStay

integer

酒店住宿时长。
hotelRateRuleId

string

酒店房价规则 ID。
hotelState

string

酒店所在的省级行政区。
hour

integer

以介于 0 到 23 之间（包括 0 和 23）的数字表示的时段。
interactionOnThisExtension

boolean

仅用于 Feed 项指标。指明互动指标是发生在 Feed 项本身上，还是发生在其他附加信息或广告单元上。
month

string

由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。
partnerHotelId

string

合作伙伴酒店 ID。
productAggregatorId

string (int64 format)

商品的集合商家 ID。
productBiddingCategoryLevel1

string

商品的出价类别（第 1 级）。
productBiddingCategoryLevel2

string

商品的出价类别（第 2 级）。
productBiddingCategoryLevel3

string

商品的出价类别（第 3 级）。
productBiddingCategoryLevel4

string

商品的出价类别（第 4 级）。
productBiddingCategoryLevel5

string

商品的出价类别（第 5 级）。
productBrand

string

商品的品牌。
productCountry

string

商品目标销售国家/地区的地理位置定位目标常量的资源名称。
productCustomAttribute0

string

商品的自定义属性 0。
productCustomAttribute1

string

商品的自定义属性 1。
productCustomAttribute2

string

商品的自定义属性 2。
productCustomAttribute3

string

商品的自定义属性 3。
productCustomAttribute4

string

商品的自定义属性 4。
productFeedLabel

string

商品的 Feed 标签。
productItemId

string

商品的项目 ID。
productLanguage

string

商品语言的语言常量的资源名称。
productMerchantId

string (int64 format)

商品的商家 ID。
productStoreId

string

商品的商店 ID。
productTitle

string

商品的名称。
productTypeL1

string

商品的类型（第 1 级）。
productTypeL2

string

商品的类型（第 2 级）。
productTypeL3

string

商品的类型（第 3 级）。
productTypeL4

string

商品的类型（第 4 级）。
productTypeL5

string

商品的类型（第 5 级）。
quarter

string

由一个季度第一天的日期表示的季度。使用日历年表示季度，例如，2018 年第二季度从 2018-04-01 开始。格式为 yyyy-MM-dd。
searchSubcategory

string

搜索字词子类别。空字符串表示不能归入其他子类别的搜索字词的无限别名子类别。
searchTerm

string

搜索字词。
webpage

string

表示网页条件的广告组条件的资源名称。
week

string

定义为星期一到星期日的一周，由星期一的日期表示。格式为 yyyy-MM-dd。
year

integer

年份，格式为 yyyy。
skAdNetworkConversionValue

string (int64 format)

iOS Store Kit 广告网络转化价值。null 值表示此细分不适用，例如，非 iOS 广告系列。
skAdNetworkSourceApp

object (SkAdNetworkSourceApp)

促成 iOS Store Kit Ad Network 安装的广告所在的应用。null 值表示此细分不适用（例如非 iOS 广告系列），或不存在于 Apple 发送的任何回传中。
assetInteractionTarget

object (AssetInteractionTarget)

仅用于 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标。指明互动指标是发生在素材资源本身上，还是发生在其他素材资源或广告单元上。当系统一起投放广告时，系统会从投放的广告的所有部分（例如广告本身以及站内链接等其他组件）统计互动（例如点击）。如果 interactionOnThisAsset 为 true，则表示互动是在这一特定素材资源上进行的；如果 interactionOnThisAsset 为 false，则表示互动并非发生在这一特定素材资源上，而是发生在与此素材资源一起投放的已投放的广告的其他部分。

AdDestinationType

枚举 Google Ads 目标页面类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
NOT_APPLICABLE 无意致使用户离开其他目标页面的广告
WEBSITE 网站
APP_STORE iOS App Store 或 Play 商店
PHONE_CALL 呼叫拨号器
MAP_DIRECTIONS 地图应用
LOCATION_LISTING 位置专用页面
MESSAGE 短信
LEAD_FORM 潜在客户发掘表单
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS 键未知的转化的广告目标页面

AdNetworkType

枚举 Google Ads 广告网络类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
SEARCH Google 搜索。
SEARCH_PARTNERS 搜索网络合作伙伴。
CONTENT 展示广告网络。
YOUTUBE_WATCH YouTube 视频
MIXED 跨广告网络。

BudgetCampaignAssociationStatus

PriceCampaignAssociationStatus 细分。

JSON 表示法 
{
  "status": enum (BudgetCampaignAssociationStatus),
  "campaign": string
}
字段
status

enum (BudgetCampaignAssociationStatus)

预算广告系列的关联状态。
campaign

string

广告系列资源名称。

BudgetCampaignAssociationStatus

预算与广告系列之间可能的关联状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ENABLED 广告系列目前正在使用预算。
REMOVED 广告系列不再使用该预算。

ClickType

枚举 Google Ads 点击类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
BREADCRUMBS 面包屑导航。
BROADBAND_PLAN 宽带套餐。
CALL_TRACKING 手动拨打电话。
CALLS 来电。
CLICK_ON_ENGAGEMENT_AD 点击互动广告。
GET_DIRECTIONS 行车路线。
LOCATION_EXPANSION 获取详细位置信息。
LOCATION_FORMAT_CALL 致电。
LOCATION_FORMAT_DIRECTIONS 路线。
LOCATION_FORMAT_IMAGE 图片。
LOCATION_FORMAT_LANDING_PAGE 前往着陆页。
LOCATION_FORMAT_MAP 地图。
LOCATION_FORMAT_STORE_INFO 前往商店信息页面。
LOCATION_FORMAT_TEXT 文本。
MOBILE_CALL_TRACKING 手机通话。
OFFER_PRINTS 打印优惠。
OTHER 其他。
PRODUCT_EXTENSION_CLICKS 产品加号方块优惠。
PRODUCT_LISTING_AD_CLICKS 购物 - 商品 - 在线。
STORE_LOCATOR 显示附近店面。
URL_CLICKS 标题。
VIDEO_APP_STORE_CLICKS 应用商店。
VIDEO_CALL_TO_ACTION_CLICKS 号召性用语重叠式广告。
VIDEO_CARD_ACTION_HEADLINE_CLICKS 卡片。
VIDEO_END_CAP_CLICKS 结尾画面。
VIDEO_WEBSITE_CLICKS 网站。
WIRELESS_PLAN 无线套餐。
PRODUCT_LISTING_AD_LOCAL 购物 - 产品 - 本地。
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL 购物 - 商品 - 多渠道本地。
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE 购物 - 商品 - 多渠道在线。
PRODUCT_LISTING_ADS_COUPON 购物 - 商品 - 优惠券。
PRODUCT_LISTING_AD_TRANSACTABLE 购物 - 商品 - 在 Google 上销售。
PROMOTION_EXTENSION 附加促销信息。
HOTEL_PRICE 酒店价格。
PRICE_EXTENSION 附加价格信息。
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION “Google 上的酒店预订”房间选择。
SHOPPING_COMPARISON_LISTING 购物 - 比价购物广告。
CROSS_NETWORK 跨广告网络。来自效果最大化广告系列和发现广告系列。

ConversionAttributionEventType

归因到的转化类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 表示此版本中的未知值。
IMPRESSION 转化归因于某次展示。
INTERACTION 转化归因于某次互动。

ConversionLagBucket

表示从展示到转化所经过的天数的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
LESS_THAN_ONE_DAY 转化延迟时间范围为 0 到 1 天。包含 0 天，不包含 1 天。
ONE_TO_TWO_DAYS 转化延迟时间范围为 1 天到 2 天。包含 1 天，不包括 2 天。
TWO_TO_THREE_DAYS 转化延迟时间范围为 2 天到 3 天。包含 2 天，不包含 3 天。
THREE_TO_FOUR_DAYS 转化延迟时间范围为 3 天到 4 天。包括 3 天，不包括 4 天。
FOUR_TO_FIVE_DAYS 转化延迟时间范围为 4 天到 5 天。包含 4 天，不包含 5 天。
FIVE_TO_SIX_DAYS 转化延迟时间范围为 5 天到 6 天。包括 5 天，不包括 6 天。
SIX_TO_SEVEN_DAYS 转化延迟时间范围为 6 天到 7 天。包括 6 天，不包括 7 天。
SEVEN_TO_EIGHT_DAYS 转化延迟时间范围为 7 天至 8 天。包括 7 天，不包括 8 天。
EIGHT_TO_NINE_DAYS 转化延迟时间范围为 8 天到 9 天。包含 8 天，不包含 9 天。
NINE_TO_TEN_DAYS 转化延迟时间范围为 9 天到 10 天。包括 9 天，不包括 10 天。
TEN_TO_ELEVEN_DAYS 转化延迟时间范围从 10 天到 11 天。包括 10 天，不包括 11 天。
ELEVEN_TO_TWELVE_DAYS 转化延迟时间范围从 11 天到 12 天。包括 11 天，不包括 12 天。
TWELVE_TO_THIRTEEN_DAYS 转化延迟时间范围从 12 天到 13 天。包括 12 天，不包括 13 天。
THIRTEEN_TO_FOURTEEN_DAYS 转化延迟时间范围为 13 天至 14 天。包括 13 天，不包括 14 天。
FOURTEEN_TO_TWENTY_ONE_DAYS 转化延迟时间范围从 14 天到 21 天。包括 14 天，不包括 21 天。
TWENTY_ONE_TO_THIRTY_DAYS 转化延迟时间范围为 21 天到 30 天。包括 21 天，不包括 30 天。
THIRTY_TO_FORTY_FIVE_DAYS 转化延迟时间范围为 30 天至 45 天。包括 30 天，不包括 45 天。
FORTY_FIVE_TO_SIXTY_DAYS 转化延迟时间范围为 45 天至 60 天。包括 45 天，不包括 60 天。
SIXTY_TO_NINETY_DAYS 转化延迟时间范围为 60 天到 90 天。包括 60 天，不包括 90 天。

ConversionOrAdjustmentLagBucket

表示展示和转化之间或者展示和转化调整之间相隔的天数。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
CONVERSION_LESS_THAN_ONE_DAY 转化延迟时间范围为 0 到 1 天。包含 0 天，不包含 1 天。
CONVERSION_ONE_TO_TWO_DAYS 转化延迟时间范围为 1 天到 2 天。包含 1 天，不包括 2 天。
CONVERSION_TWO_TO_THREE_DAYS 转化延迟时间范围为 2 天到 3 天。包含 2 天，不包含 3 天。
CONVERSION_THREE_TO_FOUR_DAYS 转化延迟时间范围为 3 天到 4 天。包括 3 天，不包括 4 天。
CONVERSION_FOUR_TO_FIVE_DAYS 转化延迟时间范围为 4 天到 5 天。包含 4 天，不包含 5 天。
CONVERSION_FIVE_TO_SIX_DAYS 转化延迟时间范围为 5 天到 6 天。包括 5 天，不包括 6 天。
CONVERSION_SIX_TO_SEVEN_DAYS 转化延迟时间范围为 6 天到 7 天。包括 6 天，不包括 7 天。
CONVERSION_SEVEN_TO_EIGHT_DAYS 转化延迟时间范围为 7 天至 8 天。包括 7 天，不包括 8 天。
CONVERSION_EIGHT_TO_NINE_DAYS 转化延迟时间范围为 8 天到 9 天。包含 8 天，不包含 9 天。
CONVERSION_NINE_TO_TEN_DAYS 转化延迟时间范围为 9 天到 10 天。包括 9 天，不包括 10 天。
CONVERSION_TEN_TO_ELEVEN_DAYS 转化延迟时间范围从 10 天到 11 天。包括 10 天，不包括 11 天。
CONVERSION_ELEVEN_TO_TWELVE_DAYS 转化延迟时间范围从 11 天到 12 天。包括 11 天，不包括 12 天。
CONVERSION_TWELVE_TO_THIRTEEN_DAYS 转化延迟时间范围从 12 天到 13 天。包括 12 天，不包括 13 天。
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS 转化延迟时间范围为 13 天至 14 天。包括 13 天，不包括 14 天。
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS 转化延迟时间范围从 14 天到 21 天。包括 14 天，不包括 21 天。
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS 转化延迟时间范围为 21 天到 30 天。包括 21 天，不包括 30 天。
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS 转化延迟时间范围为 30 天至 45 天。包括 30 天，不包括 45 天。
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS 转化延迟时间范围为 45 天至 60 天。包括 45 天，不包括 60 天。
CONVERSION_SIXTY_TO_NINETY_DAYS 转化延迟时间范围为 60 天到 90 天。包括 60 天，不包括 90 天。
ADJUSTMENT_LESS_THAN_ONE_DAY 转化调整延迟时间范围为 0 到 1 天。包含 0 天，不包含 1 天。
ADJUSTMENT_ONE_TO_TWO_DAYS 转化调整延迟时间范围为 1 天到 2 天。包含 1 天，不包括 2 天。
ADJUSTMENT_TWO_TO_THREE_DAYS 转化调整延迟时间范围为 2 天到 3 天。包含 2 天，不包含 3 天。
ADJUSTMENT_THREE_TO_FOUR_DAYS 转化调整延迟时间范围为 3 天到 4 天。包括 3 天，不包括 4 天。
ADJUSTMENT_FOUR_TO_FIVE_DAYS 转化调整延迟时间范围为 4 天到 5 天。包含 4 天，不包含 5 天。
ADJUSTMENT_FIVE_TO_SIX_DAYS 转化调整延迟时间范围为 5 天到 6 天。包括 5 天，不包括 6 天。
ADJUSTMENT_SIX_TO_SEVEN_DAYS 转化调整延迟时间范围为 6 天到 7 天。包括 6 天，不包括 7 天。
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS 转化调整延迟时间范围为 7 天到 8 天。包括 7 天，不包括 8 天。
ADJUSTMENT_EIGHT_TO_NINE_DAYS 转化调整延迟时间范围为 8 天到 9 天。包含 8 天，不包含 9 天。
ADJUSTMENT_NINE_TO_TEN_DAYS 转化调整延迟时间范围为 9 天到 10 天。包括 9 天，不包括 10 天。
ADJUSTMENT_TEN_TO_ELEVEN_DAYS 转化调整延迟时间范围为 10 天到 11 天。包括 10 天，不包括 11 天。
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS 转化调整延迟时间范围为 11 天到 12 天。包括 11 天，不包括 12 天。
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS 转化调整延迟时间范围为 12 天到 13 天。包括 12 天，不包括 13 天。
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS 转化调整延迟时间范围为 13 天到 14 天。包括 13 天，不包括 14 天。
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS 转化调整延迟时间范围为 14 天到 21 天。包括 14 天，不包括 21 天。
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS 转化调整延迟时间范围为 21 天到 30 天。包括 21 天，不包括 30 天。
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS 转化调整延迟时间范围为 30 天到 45 天。包括 30 天，不包括 45 天。
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS 转化调整延迟时间范围为 45 天到 60 天。包括 45 天，不包括 60 天。
ADJUSTMENT_SIXTY_TO_NINETY_DAYS 转化调整延迟时间范围为 60 天到 90 天。包括 60 天，不包括 90 天。
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS 转化调整延迟时间范围为 90 天到 145 天。包括 90 天，不包括 145 天。
CONVERSION_UNKNOWN 转化延迟时间范围未知。这是指 Google Ads 提供转化延迟时间范围之前的日期。
ADJUSTMENT_UNKNOWN 转化调整延迟时间范围未知。这是指 Google Ads 提供转化调整延迟时间范围之前的日期。

ExternalConversionSource

与 ConversionAction 相关联的外部转化来源。

枚举
UNSPECIFIED 未指定。
UNKNOWN 表示此版本中的未知值。
WEBPAGE 用户在观看广告后转到特定网页时发生的转化；在 Google Ads 界面中显示为“网站”。
ANALYTICS 来自关联的 Google Analytics（分析）目标或交易的转化；在 Google Ads 界面中显示为“Google Analytics（分析”）。
UPLOAD 通过 ConversionUploadService 上传的网站转化；在 Google Ads 界面中显示为“导入点击后发生的转化”。
AD_CALL_METRICS 用户直接点击广告中的附加电话信息发生的转化；在 Google Ads 界面中显示为“直接从广告中拨打的来电”。
WEBSITE_CALL_METRICS 用户在点击广告后从广告客户的网站上拨打动态生成的电话号码（通过安装的 JavaScript）即发生的转化；在 Google Ads 界面中显示为“从网站致电”。
STORE_VISITS 用户点击 Google 广告后造访广告客户的零售店，即视为转化；在 Google Ads 界面中显示为“实体店光顾”。
ANDROID_IN_APP 当用户执行应用内操作（如在 Android 应用中购买）时发生的转化；在 Google Ads 界面中显示为“Android 应用内操作”。
IOS_IN_APP 当用户执行应用内操作（例如在 iOS 应用中购买）时发生的转化；在 Google Ads 界面中显示为“iOS 应用内操作”。
IOS_FIRST_OPEN 用户首次打开 iOS 应用时发生的转化；在 Google Ads 界面中显示为“iOS 应用安装（首次打开）”。
APP_UNSPECIFIED 未提供 AppPlatform 的旧版应用转化；在 Google Ads 界面中显示为“移动应用”。
ANDROID_FIRST_OPEN 用户首次打开 Android 应用时发生的转化；在 Google Ads 界面中显示为“Android 应用安装（首次打开）”。
UPLOAD_CALLS 通过 ConversionUploadService 上传的致电转化；在 Google Ads 界面中显示为“导入致电后发生的转化”。
FIREBASE 由关联的 Firebase 事件促成的转化；在 Google Ads 界面中显示为“Firebase”。
CLICK_TO_CALL 用户点击手机号码时发生的转化；在 Google Ads 界面中显示为“电话号码点击”事件。
SALESFORCE 来自 Salesforce 的转化；在 Google Ads 界面中显示为“Salesforce.com”。
STORE_SALES_CRM 由 CRM 记录的实体店购买带来的转化；在 Google Ads 界面中显示为“实体店销售（数据合作伙伴）”。
STORE_SALES_PAYMENT_NETWORK 源自付款网络的实体店内购买的转化；在 Google Ads 界面中显示为“实体店销售（付款网络）”。
GOOGLE_PLAY 无代码 Google Play 转化；在 Google Ads 界面中显示为“Google Play”。
THIRD_PARTY_APP_ANALYTICS 由关联的第三方应用分析事件促成的转化；在 Google Ads 界面中显示为“第三方应用分析工具”。
GOOGLE_ATTRIBUTION 由 Google 归因工具控制的转化。
STORE_SALES_DIRECT_UPLOAD 基于第一方或第三方商家数据上传的实体店销售转化。在 Google Ads 界面中显示为“实体店销售（直接上传）”。
STORE_SALES 基于第一方或第三方商家数据上传的实体店销售转化以及/或者使用付款网络的卡片进行的实体店购买。在 Google Ads 界面中显示为“实体店销售”。
SEARCH_ADS_360 从 Search Ads 360 Floodlight 数据导入的转化数据。
GOOGLE_HOSTED 用于跟踪用户与广告互动后用户在 Google 产品和服务中完成本地操作的转化。
FLOODLIGHT Floodlight 代码报告的转化。
ANALYTICS_SEARCH_ADS_360 由 Google Analytics（分析）专门针对 Search Ads 360 带来的转化。在 Google Ads 界面中显示为 Google Analytics（分析）(SA360)。
FIREBASE_SEARCH_ADS_360 来自 Search Ads 360 的关联 Firebase 事件的转化。
DISPLAY_AND_VIDEO_360_FLOODLIGHT Floodlight 针对 DV360 报告的转化。

HotelRateType

描述可能的酒店房价类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
UNAVAILABLE 没有房价类型信息。
PUBLIC_RATE 费率面向所有人提供。
QUALIFIED_RATE 我们提供了会员计划费率，并且满足一些基本要求，例如提供公开费率。界面处理方式将给公开费率添加删除线，并表明用户可以享受折扣。如需详细了解“符合条件的房价”，请访问 https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates
PRIVATE_RATE 符合某些资格条件的用户适用的费率，例如所有已登录用户、20% 的移动用户、加拿大的所有移动用户等。

HotelPriceBucket

描述可能的酒店价格范围的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
LOWEST_UNIQUE 唯一最低价格。合作伙伴的价格最低，且没有其他合作伙伴的价格与此价格相差不大。
LOWEST_TIED 并列最低价格。合作伙伴与最低价格相差较小。
NOT_LOWEST 不是最低价。合作伙伴与最低价格的差距微乎其微。
ONLY_PARTNER_SHOWN 结果中仅有合作伙伴。

Keyword

关键字标准细分。

JSON 表示法 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
字段
info

object (KeywordInfo)

关键字信息。
adGroupCriterion

string

AdGroupCriterion 资源名称。

SearchEngineResultsPageType

搜索引擎结果页的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ADS_ONLY 搜索引擎结果页仅包含广告。
ORGANIC_ONLY 搜索引擎结果页仅包含自然搜索结果。
ADS_AND_ORGANIC 搜索引擎结果页同时包含广告和自然搜索结果。

SearchTermMatchType

触发广告的关键字可能使用的匹配类型，包括变体。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
BROAD 广泛匹配。
EXACT 完全匹配。
PHRASE 词组匹配。
NEAR_EXACT 完全匹配（紧密变体）。
NEAR_PHRASE 词组匹配（紧密变体）。

槽位

枚举广告的可能位置。

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
SEARCH_SIDE Google 搜索：侧边。
SEARCH_TOP Google 搜索：顶部。
SEARCH_OTHER Google 搜索：其他。
CONTENT 。
SEARCH_PARTNER_TOP 搜索网络合作伙伴：顶部。
SEARCH_PARTNER_OTHER 搜索网络合作伙伴：其他。
MIXED 跨广告网络。

ConversionValueRulePrimaryDimension

确定转化价值规则统计信息的主要维度。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
NO_RULE_APPLIED 对于启用价值规则后未应用价值规则的转化。
ORIGINAL 以下是已应用价值规则的转化：原始统计信息。
NEW_VS_RETURNING_USER 当新客户或回头客条件满足时。
GEO_LOCATION 当满足查询时地理位置条件时。
DEVICE 当满足查询时浏览设备条件时。
AUDIENCE 当满足查询时受众群体条件时。
MULTIPLE 应用了多条规则。

SkAdNetworkUserType

枚举 SkAdNetwork 用户类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
UNAVAILABLE 回传中不存在该值，或由于其他原因我们没有此数据。
NEW_INSTALLER 用户首次安装应用。
REINSTALLER 用户之前已安装该应用。

SkAdNetworkAdEventType

枚举 SkAdNetwork 广告事件类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
UNAVAILABLE 回传中不存在该值，或由于其他原因我们没有此数据。
INTERACTION 用户与广告互动。
VIEW 用户观看了广告。

SkAdNetworkSourceApp

SkAdNetworkSourceApp 细分。

JSON 表示法 
{
  "skAdNetworkSourceAppId": string
}
字段
skAdNetworkSourceAppId

string

促成 iOS Store Kit Ad Network 安装的广告所在的应用 ID。

SkAdNetworkAttributionCredit

枚举 SkAdNetwork 归因功劳。

枚举
UNSPECIFIED 默认值。此值等同于 null。
UNKNOWN 该值在此 API 版本中未知。此 API 版本中无法返回 true 枚举值，或者系统尚不支持该值。
UNAVAILABLE 回传中不存在该值，或由于其他原因我们没有此数据。
WON Google 是赢得广告归因的广告联盟。
CONTRIBUTED Google 符合归因条件，但未胜出。

AssetInteractionTarget

AssetInteractionTarget 细分。

JSON 表示法 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
字段
asset

string

资产资源名称。
interactionOnThisAsset

boolean

仅用于 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标。指明互动指标是发生在素材资源本身上，还是发生在其他素材资源或广告单元上。

ConvertingUserPriorEngagementTypeAndLtvBucket

枚举完成转化的用户之前的互动类型和生命周期价值范围

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
NEW 正在转化的用户是广告客户的新用户。
RETURNING 正在转化的用户再次返回广告客户。“回访”的定义因转化类型而异，例如第二次实体店光顾与第二次网购。
NEW_AND_HIGH_LTV 完成转化的用户是广告客户的新客户，具有很高的生命周期价值。