GoogleAdsRow

查询返回的行。

JSON 表示法 
{
  "accountBudget": {
    object (AccountBudget)
  },
  "accountBudgetProposal": {
    object (AccountBudgetProposal)
  },
  "accountLink": {
    object (AccountLink)
  },
  "ad": {
    object (Ad)
  },
  "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)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "adGroupSimulation": {
    object (AdGroupSimulation)
  },
  "adParameter": {
    object (AdParameter)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "adScheduleView": {
    object (AdScheduleView)
  },
  "domainCategory": {
    object (DomainCategory)
  },
  "asset": {
    object (Asset)
  },
  "assetFieldTypeView": {
    object (AssetFieldTypeView)
  },
  "channelAggregateAssetView": {
    object (ChannelAggregateAssetView)
  },
  "campaignAggregateAssetView": {
    object (CampaignAggregateAssetView)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupProductGroupView": {
    object (AssetGroupProductGroupView)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "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)
  },
  "campaignGroup": {
    object (CampaignGroup)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "campaignLifecycleGoal": {
    object (CampaignLifecycleGoal)
  },
  "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)
  },
  "customerLabel": {
    object (CustomerLabel)
  },
  "customerLifecycleGoal": {
    object (CustomerLifecycleGoal)
  },
  "customerNegativeCriterion": {
    object (CustomerNegativeCriterion)
  },
  "customerSearchTermInsight": {
    object (CustomerSearchTermInsight)
  },
  "customerUserAccess": {
    object (CustomerUserAccess)
  },
  "customerUserAccessInvitation": {
    object (CustomerUserAccessInvitation)
  },
  "customizerAttribute": {
    object (CustomizerAttribute)
  },
  "dataLink": {
    object (DataLink)
  },
  "detailPlacementView": {
    object (DetailPlacementView)
  },
  "detailedDemographic": {
    object (DetailedDemographic)
  },
  "displayKeywordView": {
    object (DisplayKeywordView)
  },
  "distanceView": {
    object (DistanceView)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "expandedLandingPageView": {
    object (ExpandedLandingPageView)
  },
  "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)
  },
  "contentCriterionView": {
    object (ContentCriterionView)
  },
  "mediaFile": {
    object (MediaFile)
  },
  "localServicesEmployee": {
    object (LocalServicesEmployee)
  },
  "localServicesVerificationArtifact": {
    object (LocalServicesVerificationArtifact)
  },
  "mobileAppCategoryConstant": {
    object (MobileAppCategoryConstant)
  },
  "mobileDeviceConstant": {
    object (MobileDeviceConstant)
  },
  "offlineConversionUploadClientSummary": {
    object (OfflineConversionUploadClientSummary)
  },
  "offlineConversionUploadConversionActionSummary": {
    object (OfflineConversionUploadConversionActionSummary)
  },
  "offlineUserDataJob": {
    object (OfflineUserDataJob)
  },
  "operatingSystemVersionConstant": {
    object (OperatingSystemVersionConstant)
  },
  "paidOrganicSearchTermView": {
    object (PaidOrganicSearchTermView)
  },
  "qualifyingQuestion": {
    object (QualifyingQuestion)
  },
  "parentalStatusView": {
    object (ParentalStatusView)
  },
  "perStoreView": {
    object (PerStoreView)
  },
  "performanceMaxPlacementView": {
    object (PerformanceMaxPlacementView)
  },
  "productCategoryConstant": {
    object (ProductCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "productLink": {
    object (ProductLink)
  },
  "productLinkInvitation": {
    object (ProductLinkInvitation)
  },
  "recommendation": {
    object (Recommendation)
  },
  "recommendationSubscription": {
    object (RecommendationSubscription)
  },
  "searchTermView": {
    object (SearchTermView)
  },
  "sharedCriterion": {
    object (SharedCriterion)
  },
  "sharedSet": {
    object (SharedSet)
  },
  "smartCampaignSetting": {
    object (SmartCampaignSetting)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "shoppingProduct": {
    object (ShoppingProduct)
  },
  "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)
  },
  "userListCustomerType": {
    object (UserListCustomerType)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "remarketingAction": {
    object (RemarketingAction)
  },
  "topicConstant": {
    object (TopicConstant)
  },
  "video": {
    object (Video)
  },
  "webpageView": {
    object (WebpageView)
  },
  "leadFormSubmissionData": {
    object (LeadFormSubmissionData)
  },
  "localServicesLead": {
    object (LocalServicesLead)
  },
  "localServicesLeadConversation": {
    object (LocalServicesLeadConversation)
  },
  "androidPrivacySharedKeyGoogleAdGroup": {
    object (AndroidPrivacySharedKeyGoogleAdGroup)
  },
  "androidPrivacySharedKeyGoogleCampaign": {
    object (AndroidPrivacySharedKeyGoogleCampaign)
  },
  "androidPrivacySharedKeyGoogleNetworkType": {
    object (AndroidPrivacySharedKeyGoogleNetworkType)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  }
}
字段
accountBudget

object (AccountBudget)

查询中的账号预算。
accountBudgetProposal

object (AccountBudgetProposal)

查询中引用的账号预算建议。
ad

object (Ad)

查询中引用的广告。
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)

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

object (AdGroupLabel)

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

object (AdGroupSimulation)

查询中引用的广告组模拟。
adParameter

object (AdParameter)

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

object (AgeRangeView)

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

object (AdScheduleView)

查询中引用的广告排期视图。
domainCategory

object (DomainCategory)

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

object (Asset)

查询中引用的资产。
assetFieldTypeView

object (AssetFieldTypeView)

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

object (ChannelAggregateAssetView)

查询中引用的渠道汇总素材资源视图。
campaignAggregateAssetView

object (CampaignAggregateAssetView)

查询中引用的广告系列汇总素材资源视图。
assetGroupAsset

object (AssetGroupAsset)

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

object (AssetGroupSignal)

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

object (AssetGroupListingGroupFilter)

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

object (AssetGroupProductGroupView)

查询中引用的素材资源组商品组视图。
assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

查询中引用的素材资源组效果最佳的组合视图。
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)

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

object (CampaignGroup)

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

object (CampaignLabel)

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

object (CampaignLifecycleGoal)

查询中引用的广告系列生命周期目标。
campaignSearchTermInsight

object (CampaignSearchTermInsight)

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

object (CampaignSharedSet)

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

object (CampaignSimulation)

查询中引用的广告系列模拟。
carrierConstant

object (CarrierConstant)

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

object (ChangeEvent)

查询中引用的 ChangeEvent。
changeStatus

object (ChangeStatus)

查询中引用的 ChangeStatus。
combinedAudience

object (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。
customerLabel

object (CustomerLabel)

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

object (CustomerLifecycleGoal)

查询中引用的客户生命周期目标。
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)

查询中引用的扩展着陆页视图。
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)

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

object (ContentCriterionView)

查询中引用的内容条件视图。
mediaFile

object (MediaFile)

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

object (LocalServicesEmployee)

查询中引用的本地生活服务员工。
localServicesVerificationArtifact

object (LocalServicesVerificationArtifact)

查询中引用的本地服务验证制品。
mobileAppCategoryConstant

object (MobileAppCategoryConstant)

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

object (MobileDeviceConstant)

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

object (OfflineConversionUploadClientSummary)

客户级线下转化数据上传摘要。
offlineConversionUploadConversionActionSummary

object (OfflineConversionUploadConversionActionSummary)

转化类型级别的线下转化数据上传摘要。
offlineUserDataJob

object (OfflineUserDataJob)

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

object (OperatingSystemVersionConstant)

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

object (PaidOrganicSearchTermView)

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

object (QualifyingQuestion)

查询中引用的甄别问题。
parentalStatusView

object (ParentalStatusView)

查询中引用的育儿状况视图。
perStoreView

object (PerStoreView)

查询中引用的按商店划分的视图。
performanceMaxPlacementView

object (PerformanceMaxPlacementView)

查询中引用的效果最大化广告系列展示位置视图。
productCategoryConstant

object (ProductCategoryConstant)

查询中引用的商品类别。
productGroupView

object (ProductGroupView)

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

object (Recommendation)

查询中引用的推荐。
recommendationSubscription

object (RecommendationSubscription)

查询中引用的推荐订阅。
searchTermView

object (SearchTermView)

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

object (SharedCriterion)

查询中引用的共享集。
sharedSet

object (SharedSet)

查询中引用的共享集。
smartCampaignSetting

object (SmartCampaignSetting)

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

object (ShoppingPerformanceView)

查询中引用的购物广告效果视图。
shoppingProduct

object (ShoppingProduct)

查询中引用的购物商品。
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)

查询中引用的用户列表。
userListCustomerType

object (UserListCustomerType)

查询中的用户名单客户类型。
userLocationView

object (UserLocationView)

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

object (RemarketingAction)

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

object (TopicConstant)

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

object (Video)

查询中引用的视频。
webpageView

object (WebpageView)

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

object (LeadFormSubmissionData)

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

object (LocalServicesLead)

查询中引用的本地生活服务潜在客户。
localServicesLeadConversation

object (LocalServicesLeadConversation)

查询中引用的本地生活服务潜在客户对话。
androidPrivacySharedKeyGoogleAdGroup

object (AndroidPrivacySharedKeyGoogleAdGroup)

查询中引用的 Android 隐私权共享密钥 Google 广告组。
androidPrivacySharedKeyGoogleCampaign

object (AndroidPrivacySharedKeyGoogleCampaign)

查询中引用的 Android 隐私权共享密钥 Google 广告系列。
androidPrivacySharedKeyGoogleNetworkType

object (AndroidPrivacySharedKeyGoogleNetworkType)

查询中引用的 Android 隐私权共享密钥 Google 网络类型。
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。只有在获批的支出限额为无限时，系统才会填充此字段。

联合字段 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）。只有在调整后的支出上限为无限时，系统才会填充此字段，如果获批的支出上限为无限，则可以保证调整后的支出上限为无限。

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 中。AdGroupAdAssetCombination 视图资源名称采用以下格式：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

AdGroupAd 与 Asset 之间的关联。AdGroupAdAssetView 支持应用广告、需求开发广告系列和自适应搜索广告。

JSON 表示法 
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType),
  "policySummary": {
    object (AdGroupAdAssetPolicySummary)
  },
  "performanceLabel": enum (AssetPerformanceLabel),
  "pinnedField": enum (ServedAssetFieldType),
  "source": enum (AssetSource),
  "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)

仅限输出。固定字段。
source

enum (AssetSource)

仅限输出。广告组广告素材资源的来源。
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 起，酒店广告组条件模拟操作。

  1. DISPLAY - KEYWORD - CPC_BID - UNIFORM
  2. 搜索 - 关键字 - CPC_BID - UNIFORM
  3. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM
  4. HOTEL - 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)

仅限输出。模拟的 AdGroup 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

特定百分比 CPC 金额的预测指标。只有酒店广告渠道类型支持此字段。

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

string (int64 format)

用于计算预测指标的模拟每次点击费用百分比。以部分商品或服务的广告价格的分数形式表示的百分比 CPC。此处存储的值为 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. SEARCH - CPC_BID - DEFAULT
  2. 搜索 - CPC_BID - UNIFORM
  3. 搜索 - TARGET_CPA - UNIFORM
  4. 搜索 - TARGET_ROAS - UNIFORM
  5. DISPLAY - CPC_BID - DEFAULT
  6. DISPLAY - CPC_BID - UNIFORM
  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,
  "interactions": 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)

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

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

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

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 查找的网页的语言，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)

仅限输出。相应素材资源字段类型视图的素材资源字段类型。

ChannelAggregateAssetView

渠道级汇总素材资源视图，显示素材资源的关联位置、效果和统计数据。

JSON 表示法 
{
  "resourceName": string,
  "advertisingChannelType": enum (AdvertisingChannelType),
  "asset": string,
  "assetSource": enum (AssetSource),
  "fieldType": enum (AssetFieldType)
}
字段
resourceName

string

仅限输出。渠道汇总资源效果视图的资源名称。渠道汇总素材资源视图资源名称采用以下格式：

customers/{customerId}/channelAggregateAssetViews/{ChannelAssetV2.advertising_channel_type}~{ChannelAssetV2.asset_id}~{ChannelAssetV2.asset_source}~{ChannelAssetV2.field_type}"
advertisingChannelType

enum (AdvertisingChannelType)

仅限输出。投放素材资源的渠道。
asset

string

仅限输出。资产的 ID。
assetSource

enum (AssetSource)

仅限输出。素材资源链接的来源。
fieldType

enum (AssetFieldType)

仅限输出。素材资源的 FieldType。

CampaignAggregateAssetView

一种广告系列级汇总素材资源视图，可显示素材资源的关联位置、效果和统计数据。

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

string

仅限输出。广告系列汇总资源视图的资源名称。广告系列汇总素材资源视图资源名称采用以下格式：

customers/{customerId}/campaignAggregateAssetViews/{Campaign.campaign_id}~{Asset.asset_id}~{AssetLinkSource.asset_link_source}~{AssetFieldType.field_type}
campaign

string

仅限输出。展示相应素材资源的广告系列。
asset

string

仅限输出。资产的 ID。
assetSource

enum (AssetSource)

仅限输出。素材资源链接的来源。
fieldType

enum (AssetFieldType)

仅限输出。素材资源的 FieldType。

AssetGroupProductGroupView

素材资源组产品组视图。

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

string

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

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

string

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

string

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

AssetGroupTopCombinationView

素材资源组素材资源效果最佳组合的使用情况视图。

JSON 表示法 
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
字段
resourceName

string

仅限输出。素材资源组热门组合视图的资源名称。AssetGroupTopCombinationView 资源名称采用以下格式：“customers/{customerId}/assetGroupTopCombinationViews/{assetGroupId}~{asset_combination_category}”
assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

仅限输出。一起投放的素材资源组合中效果最佳的组合。

AssetGroupAssetCombinationData

素材资源组素材资源组合数据

JSON 表示法 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
字段
assetCombinationServedAssets[]

object (AssetUsage)

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

AssetSetTypeView

素材资源组类型视图。此视图会针对每种素材资源集类型报告未过度统计的指标。此报告中不包含子素材资源集类型。其统计信息会汇总到父级素材资源集类型下。

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

string

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

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

enum (AssetSetType)

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

BiddingStrategySimulation

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

  1. TARGET_CPA - UNIFORM
  2. TARGET_ROAS - UNIFORM
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 Voice 通话的可能状态。

枚举
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

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

  • 搜索 - CPC_BID - UNIFORM
  • 搜索 - CPC_BID - SCALING
  • 搜索 - TARGET_CPA - UNIFORM
  • 搜索 - TARGET_CPA - SCALING
  • 搜索 - TARGET_ROAS - UNIFORM
  • 搜索 - TARGET_IMPRESSION_SHARE - UNIFORM
  • 搜索 - 预算 - 统一
  • 购物 - 预算 - 统一
  • 购物 - TARGET_ROAS - UNIFORM
  • MULTI_CHANNEL - TARGET_CPA - UNIFORM
  • MULTI_CHANNEL - TARGET_ROAS - UNIFORM
  • 需求开发广告系列 - 目标每次转化费用 - 默认
  • 展示广告 - 目标每次转化费用 - 统一
  • PERFORMANCE_MAX - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - TARGET_ROAS - UNIFORM
  • PERFORMANCE_MAX - BUDGET - UNIFORM
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)

仅限输出。如果模拟类型为“预算”，则为模拟点数。

TargetImpressionShareSimulationPointList

一种容器，用于存放目标展示份额模拟的模拟点。

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

一种容器，用于存储预算类模拟的模拟点。

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,
  "interactions": 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)

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

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,
  "asset": string
}
字段
resourceName

string

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

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

string

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

enum (ChangeEventResourceType)

仅限输出。已更改的资源的类型。这决定了将在 oldResource 和 newResource 中设置哪些资源。
changeResourceName

string

仅限输出。发生相应更改的 Simply 资源。
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

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

string

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

ChangeEventResourceType

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

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中未知的未分类资源。
AD 广告资源更改。
AD_GROUP AdGroup 资源更改。
AD_GROUP_CRITERION AdGroupCriterion 资源更改。
CAMPAIGN 广告系列资源更改。
CAMPAIGN_BUDGET CampaignBudget 资源更改。
AD_GROUP_BID_MODIFIER AdGroupBidModifier 资源更改。
CAMPAIGN_CRITERION CampaignCriterion 资源更改。
FEED Feed 资源更改。
FEED_ITEM FeedItem 资源更改。
CAMPAIGN_FEED CampaignFeed 资源更改。
AD_GROUP_FEED AdGroupFeed 资源更改。
AD_GROUP_AD AdGroupAd 资源更改。
ASSET 素材资源更改。
CUSTOMER_ASSET CustomerAsset 资源更改。
CAMPAIGN_ASSET CampaignAsset 资源更改。
AD_GROUP_ASSET AdGroupAsset 资源变更。
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 Post 所做的更改。
INTERNAL_TOOL 通过内部工具进行的更改。例如，当用户在广告系列等实体上设置网址模板时，系统会自动使用 SA360 Clickserver 网址封装该网址模板。
OTHER 未归类的更改类型，例如通过 Google Ads 兑换优惠券所做的更改。
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION 订阅 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)
  },
  "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，则进行设置。
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,
  "assetGroup": string,
  "campaignBudget": string,
  "lastChangeDateTime": string,
  "campaign": string,
  "adGroup": string,
  "adGroupAd": string,
  "adGroupCriterion": string,
  "campaignCriterion": string,
  "adGroupBidModifier": string
}
字段
resourceName

string

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

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

enum (ChangeStatusResourceType)

仅限输出。表示已更改的资源类型。这决定了将设置哪些字段。例如，对于 AD_GROUP，系统会设置广告系列和广告组字段。
resourceStatus

enum (ChangeStatusOperation)

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

string

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

string

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

string

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

string

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

string

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

string

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

string

仅限输出。受此变更影响的 CombinedAudience。
assetGroup

string

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

string

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

string

仅限输出。相应资源最近一次发生更改的时间。
campaign

string

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

string

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

string

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

string

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

string

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

string

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

ChangeStatusResourceType

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

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中未知的未分类资源。
AD_GROUP AdGroup 资源更改。
AD_GROUP_AD AdGroupAd 资源更改。
AD_GROUP_CRITERION AdGroupCriterion 资源更改。
CAMPAIGN 广告系列资源更改。
CAMPAIGN_CRITERION CampaignCriterion 资源更改。
CAMPAIGN_BUDGET CampaignBudget 资源更改。
FEED Feed 资源更改。
FEED_ITEM FeedItem 资源更改。
AD_GROUP_FEED AdGroupFeed 资源更改。
CAMPAIGN_FEED CampaignFeed 资源更改。
AD_GROUP_BID_MODIFIER AdGroupBidModifier 资源更改。
SHARED_SET SharedSet 资源更改。
CAMPAIGN_SHARED_SET CampaignSharedSet 资源更改。
ASSET 素材资源更改。
CUSTOMER_ASSET CustomerAsset 资源更改。
CAMPAIGN_ASSET CampaignAsset 资源更改。
AD_GROUP_ASSET AdGroupAsset 资源变更。
COMBINED_AUDIENCE CombinedAudience 资源发生更改。
ASSET_GROUP AssetGroup 资源变更。
ASSET_SET AssetSet 资源更改。
CAMPAIGN_ASSET_SET CampaignAssetSet 资源更改。

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

表示客户拥有和共享的 BiddingStrategies 的视图。

与 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

仅限输出。拥有相应出价策略的客户的 descriptiveName。

联合字段 scheme。出价方案。

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

object (MaximizeConversionValue)

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

object (MaximizeConversions)

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

object (TargetCpa)

仅限输出。一种出价策略，可设置出价，在将每次转化费用控制在您设定的目标水平的前提下，帮助您争取尽可能多的转化。
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 视频的名称，以及移动应用的翻译名称。
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

仅限输出。详细受众特征的名称。例如，“最高教育程度”
parent

string

仅限输出。detailedDemographic 的父级。
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

包含可能的 CriterionCategoryChannelAvailabilityMode 的枚举。

枚举
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

包含可能的 CriterionCategoryLocaleAvailabilityMode 的枚举。

枚举
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

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

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

地理位置视图会按地理位置条件汇总广告系列的效果。如果未设置任何地理位置条件，则不会返回任何结果；请改用 geographicView 或 userLocationView 获取访问者的地理位置数据。

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

string

仅限输出。位置视图的资源名称。位置信息视图资源名称采用以下格式：

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

ManagedPlacementView

自选展示位置视图。

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

string

仅限输出。“受管理的展示位置”视图的资源名称。受管理的展示位置视图资源名称采用以下格式：

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

ContentCriterionView

内容条件视图。

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

string

仅限输出。内容条件视图的资源名称。内容条件视图资源名称采用以下格式：

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

MediaFile

媒体文件。

JSON 表示法 
{
  "resourceName": string,
  "type": enum (MediaType),
  "mimeType": enum (MimeType),
  "id": string,
  "sourceUrl": string,
  "name": string,
  "fileSize": string,

  // Union field mediatype can be only one of the following:
  "image": {
    object (MediaImage)
  },
  "mediaBundle": {
    object (MediaBundle)
  },
  "audio": {
    object (MediaAudio)
  },
  "video": {
    object (MediaVideo)
  }
  // End of list of possible types for union field mediatype.
}
字段
resourceName

string

不可变。媒体文件的资源名称。媒体文件资源名称的格式为：

customers/{customerId}/mediaFiles/{media_file_id}
type

enum (MediaType)

不可变。媒体文件的类型。
mimeType

enum (MimeType)

仅限输出。媒体文件的 MIME 类型。
id

string (int64 format)

仅限输出。媒体文件的 ID。
sourceUrl

string

不可变。原始媒体文件的下载来源网址（或文件名）。仅用于类型为 AUDIO 和 IMAGE 的媒体。
name

string

不可变。媒体文件的名称。客户端可以使用该名称来帮助识别之前上传的媒体。
fileSize

string (int64 format)

仅限输出。媒体文件的大小（以字节为单位）。
联合字段 mediatype。媒体文件的具体类型。mediatype 只能是下列其中一项：
image

object (MediaImage)

不可变。封装图片。
mediaBundle

object (MediaBundle)

不可变。一种 ZIP 归档媒体，其内容包含 HTML5 素材资源。
audio

object (MediaAudio)

仅限输出。封装音频。
video

object (MediaVideo)

不可变。封装视频。

MediaType

媒体的类型。

枚举
UNSPECIFIED 未指定媒体类型。
UNKNOWN

此版本中未知收到的值。

此值为仅限响应的值。
IMAGE 用于图片广告的静态图片。
ICON 小尺寸图片，用于地图广告。
MEDIA_BUNDLE ZIP 文件，用于模板广告的字段中。
AUDIO 音频文件。
VIDEO 视频文件。
DYNAMIC_IMAGE 动画图片，例如 GIF 动画。

MediaImage

封装图片。

JSON 表示法 
{
  "data": string,
  "fullSizeImageUrl": string,
  "previewSizeImageUrl": string
}
字段
data

string (bytes format)

不可变。原始图片数据。

使用 base64 编码的字符串。
fullSizeImageUrl

string

仅限输出。全尺寸图片的网址。
previewSizeImageUrl

string

仅限输出。预览尺寸版本的图片网址。

MediaBundle

表示一种 ZIP 归档媒体，其内容包含 HTML5 素材资源。

JSON 表示法 
{
  "data": string,
  "url": string
}
字段
data

string (bytes format)

不可变。原始压缩数据。

使用 base64 编码的字符串。
url

string

仅限输出。用于访问已上传的压缩数据的网址。例如，https://tpc.googlesyndication.com/simgad/123。此字段为只读字段。

MediaAudio

封装音频。

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

string (int64 format)

仅限输出。音频的时长（以毫秒为单位）。

MediaVideo

封装视频。

JSON 表示法 
{
  "adDurationMillis": string,
  "youtubeVideoId": string,
  "advertisingIdCode": string,
  "isciCode": string
}
字段
adDurationMillis

string (int64 format)

仅限输出。视频的时长（以毫秒为单位）。
youtubeVideoId

string

不可变。YouTube 视频 ID（如 YouTube 网址中所示）。在此 ID 前添加前缀“https://www.youtube.com/watch?v=”即可获得相应视频的 YouTube 流式传输网址。
advertisingIdCode

string

仅限输出。此视频的广告数字识别代码，由美国广告代理商协会定义，主要用于电视广告。
isciCode

string

仅限输出。相应视频的行业标准商业标识符代码，主要用于电视广告。

LocalServicesEmployee

一种本地生活服务员工资源。

JSON 表示法 
{
  "resourceName": string,
  "creationDateTime": string,
  "status": enum (LocalServicesEmployeeStatus),
  "type": enum (LocalServicesEmployeeType),
  "universityDegrees": [
    {
      object (UniversityDegree)
    }
  ],
  "residencies": [
    {
      object (Residency)
    }
  ],
  "fellowships": [
    {
      object (Fellowship)
    }
  ],
  "languagesSpoken": [
    string
  ],
  "categoryIds": [
    string
  ],
  "id": string,
  "jobTitle": string,
  "yearStartedPracticing": integer,
  "nationalProviderIdNumber": string,
  "emailAddress": string,
  "firstName": string,
  "middleName": string,
  "lastName": string
}
字段
resourceName

string

不可变。本地服务验证的资源名称。本地服务验证资源名称采用以下格式：

customers/{customerId}/localServicesEmployees/{gls_employee_id}
creationDateTime

string

仅限输出。员工创建时间戳。格式为“YYYY-MM-DD HH:MM:SS”，采用 Google Ads 账号的时区。示例：“2018-03-05 09:15:00”或“2018-02-01 14:34:30”
status

enum (LocalServicesEmployeeStatus)

仅限输出。员工状态，例如 DELETED 或 ENABLED。
type

enum (LocalServicesEmployeeType)

仅限输出。员工类型。
universityDegrees[]

object (UniversityDegree)

仅限输出。相应员工已获得并希望展示的学位列表。
residencies[]

object (Residency)

仅限输出。员工完成住院实习的机构。
fellowships[]

object (Fellowship)

仅限输出。员工完成研究员工作的机构。
languagesSpoken[]

string

仅限输出。员工所用语言，以语言代码表示，如需了解详情，请访问 https://developers.google.com/admin-sdk/directory/v1/languages
categoryIds[]

string

仅限输出。员工类别。本地生活服务类别 ID 的列表可在 https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids 中找到。
id

string (int64 format)

仅限输出。员工的 ID。
jobTitle

string

仅限输出。相应员工的职位，例如法律垂直领域的“高级合伙人”。
yearStartedPracticing

integer

仅限输出。相应员工开始从事该领域的年份。
nationalProviderIdNumber

string

仅限输出。与员工关联的 NPI ID。
emailAddress

string

仅限输出。员工的电子邮件地址。
firstName

string

仅限输出。员工的名字。
middleName

string

仅限输出。员工的中间名。
lastName

string

仅限输出。员工的姓氏。

LocalServicesEmployeeStatus

枚举，用于描述本地生活服务员工的状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ENABLED 员工未被移除，且员工状态为有效。
REMOVED 相应员工会被移除。用于从商家中删除员工。

LocalServicesEmployeeType

描述本地生活服务员工类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
BUSINESS_OWNER 表示企业的所有者。
EMPLOYEE 表示商家的员工。

UniversityDegree

相应员工已获得并希望展示的学位列表。

JSON 表示法 
{
  "institutionName": string,
  "degree": string,
  "graduationYear": integer
}
字段
institutionName

string

仅限输出。获得学位的大学的名称。
degree

string

仅限输出。所获学位的名称。
graduationYear

integer

仅限输出。毕业年份。

住所

有关员工医学实习的详细信息。住院实习期是研究生医学教育的一个阶段，在此阶段，合格的医疗专业人员会在资深临床医生的监督下进行实践。

JSON 表示法 
{
  "institutionName": string,
  "completionYear": integer
}
字段
institutionName

string

仅限输出。完成住院实习的机构的名称。
completionYear

integer

仅限输出。完成年份。

奖学金

员工的医学研究员职位详细信息。专科培训是专业人士在完成住院实习后接受的一段医学培训。

JSON 表示法 
{
  "institutionName": string,
  "completionYear": integer
}
字段
institutionName

string

仅限输出。完成研究员计划的机构的名称。
completionYear

integer

仅限输出。完成年份。

LocalServicesVerificationArtifact

本地服务验证资源。

JSON 表示法 
{
  "resourceName": string,
  "creationDateTime": string,
  "status": enum (LocalServicesVerificationArtifactStatus),
  "artifactType": enum (LocalServicesVerificationArtifactType),
  "id": string,

  // Union field artifact_data can be only one of the following:
  "backgroundCheckVerificationArtifact": {
    object (BackgroundCheckVerificationArtifact)
  },
  "insuranceVerificationArtifact": {
    object (InsuranceVerificationArtifact)
  },
  "licenseVerificationArtifact": {
    object (LicenseVerificationArtifact)
  },
  "businessRegistrationCheckVerificationArtifact": {
    object (BusinessRegistrationCheckVerificationArtifact)
  }
  // End of list of possible types for union field artifact_data.
}
字段
resourceName

string

不可变。本地服务验证的资源名称。本地服务验证资源名称采用以下格式：

customers/{customerId}/localServicesVerificationArtifacts/{verification_artifact_id}
creationDateTime

string

仅限输出。创建相应验证制品时的时间戳。格式为“YYYY-MM-DD HH:MM:SS”，采用 Google Ads 账号的时区。示例：“2018-03-05 09:15:00”或“2018-02-01 14:34:30”
status

enum (LocalServicesVerificationArtifactStatus)

仅限输出。验证制品的验证状态。
artifactType

enum (LocalServicesVerificationArtifactType)

仅限输出。验证制品的类型。
id

string (int64 format)

仅限输出。验证工件的 ID。
联合字段 artifact_data。验证信息的类型。artifact_data 只能是下列其中一项：
backgroundCheckVerificationArtifact

object (BackgroundCheckVerificationArtifact)

仅限输出。背景调查验证制品。
insuranceVerificationArtifact

object (InsuranceVerificationArtifact)

仅限输出。保险验证制品。
licenseVerificationArtifact

object (LicenseVerificationArtifact)

仅限输出。许可验证制品。
businessRegistrationCheckVerificationArtifact

object (BusinessRegistrationCheckVerificationArtifact)

仅限输出。工商登记核查验证制品。

LocalServicesVerificationArtifactStatus

用于描述本地服务验证制品的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
PASSED 制品已通过验证。
FAILED 制品验证失败。
PENDING 制品正在验证中。
NO_SUBMISSION 工件需要用户上传信息，然后才能进行验证。
CANCELLED 用户已取消相应制品。

LocalServicesVerificationArtifactType

枚举，用于描述本地服务验证制品的可能类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
BACKGROUND_CHECK 背景调查验证制品。
INSURANCE 保险验证制品。
LICENSE 许可验证制品。
BUSINESS_REGISTRATION_CHECK 工商登记核查验证制品。

BackgroundCheckVerificationArtifact

一种用于保存本地生活服务背景调查专属信息的 proto。

JSON 表示法 
{
  "caseUrl": string,
  "finalAdjudicationDateTime": string
}
字段
caseUrl

string

仅限输出。用于访问后台工单的网址。
finalAdjudicationDateTime

string

仅限输出。此背景调查案件结果的裁定时间戳。格式为“YYYY-MM-DD HH:MM:SS”，采用 Google Ads 账号的时区。示例：“2018-03-05 09:15:00”或“2018-02-01 14:34:30”

InsuranceVerificationArtifact

一种用于保存本地服务保险专属信息的 proto。

JSON 表示法 
{
  "amountMicros": string,
  "rejectionReason": enum (LocalServicesInsuranceRejectionReason),
  "insuranceDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  },
  "expirationDateTime": string
}
字段
amountMicros

string (int64 format)

仅限输出。保险金额。以保险单中提及的币种的“微”为单位。
rejectionReason

enum (LocalServicesInsuranceRejectionReason)

仅限输出。保险单据的拒绝原因。
insuranceDocumentReadonly

object (LocalServicesDocumentReadOnly)

仅限输出。包含已上传保险凭证信息的只读字段。
expirationDateTime

string

仅限输出。相应保险的到期时间戳。格式为“YYYY-MM-DD HH:MM:SS”，采用 Google Ads 账号的时区。示例：“2018-03-05 09:15:00”或“2018-02-01 14:34:30”

LocalServicesInsuranceRejectionReason

枚举，用于描述本地服务保险验证制品可能遭拒的原因。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
BUSINESS_NAME_MISMATCH 商家名称与本地生活服务广告的商家名称不一致。
INSURANCE_AMOUNT_INSUFFICIENT 保险金额不符合相应地理位置 + 类别 ID 组合的法律摘要文档中列出的要求。
EXPIRED 保险单据已过期。
NO_SIGNATURE 保险单据缺少签名。
NO_POLICY_NUMBER 保险单据缺少保单号。
NO_COMMERCIAL_GENERAL_LIABILITY 保险文件中未勾选“商业综合责任保险(CGL)”框。
EDITABLE_FORMAT 保险单据采用可修改的格式。
CATEGORY_MISMATCH 保险单据未涵盖特定类别的保险。
MISSING_EXPIRATION_DATE 保险文件缺少到期日期。
POOR_QUALITY 保险凭证质量不佳 - 图片模糊不清、难以辨认等…
POTENTIALLY_EDITED 保险单据疑似经过修改。
WRONG_DOCUMENT_TYPE 保险单据未获接受。例如，保险提案文件，但缺少保险范围的文件不予接受。
NON_FINAL 保险文件不是最终版本。
OTHER 保险凭证存在未明确列出的其他缺陷。

LocalServicesDocumentReadOnly

具有只读可访问数据的本地服务文档。

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

string

用于访问已上传的本地生活服务文档的网址。

LicenseVerificationArtifact

一种用于保存本地服务许可专属信息的 proto。

JSON 表示法 
{
  "licenseType": string,
  "licenseNumber": string,
  "licenseeFirstName": string,
  "licenseeLastName": string,
  "rejectionReason": enum (LocalServicesLicenseRejectionReason),
  "licenseDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  },
  "expirationDateTime": string
}
字段
licenseType

string

仅限输出。许可类型 / 名称。
licenseNumber

string

仅限输出。驾照号。
licenseeFirstName

string

仅限输出。许可方的名字。
licenseeLastName

string

仅限输出。许可方的姓氏。
rejectionReason

enum (LocalServicesLicenseRejectionReason)

仅限输出。许可遭拒原因。
licenseDocumentReadonly

object (LocalServicesDocumentReadOnly)

仅限输出。包含已上传许可文档信息的只读字段。
expirationDateTime

string

仅限输出。相应许可的到期时间戳。格式为“YYYY-MM-DD HH:MM:SS”，采用 Google Ads 账号的时区。示例：“2018-03-05 09:15:00”或“2018-02-01 14:34:30”

LocalServicesLicenseRejectionReason

枚举，用于描述本地生活服务许可验证制品的可能拒绝原因。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
BUSINESS_NAME_MISMATCH 商家名称与本地生活服务广告的商家名称不一致。
UNAUTHORIZED 许可未经授权或已被撤消。
EXPIRED 许可已过期。
POOR_QUALITY 驾照质量不佳 - 图片模糊不清、难以辨认等。
UNVERIFIABLE 由于图片不合法，无法验证驾照。
WRONG_DOCUMENT_OR_ID 许可不是所需的文件类型，或者包含无效的身份证件。
OTHER 许可存在未明确列出的其他缺陷。

BusinessRegistrationCheckVerificationArtifact

一种用于保存与本地生活服务商家注册检查相关的特定信息的 proto。

JSON 表示法 
{
  "registrationType": enum (LocalServicesBusinessRegistrationType),
  "checkId": string,
  "rejectionReason": enum (LocalServicesBusinessRegistrationCheckRejectionReason),

  // Union field business_registration can be only one of the following:
  "registrationNumber": {
    object (BusinessRegistrationNumber)
  },
  "registrationDocument": {
    object (BusinessRegistrationDocument)
  }
  // End of list of possible types for union field business_registration.
}
字段
registrationType

enum (LocalServicesBusinessRegistrationType)

仅限输出。工商登记检查的类型（编号、证件）。
checkId

string

仅限输出。检查的 ID，例如 vat_tax_id，表示“增值税号”要求。
rejectionReason

enum (LocalServicesBusinessRegistrationCheckRejectionReason)

仅限输出。注册文件遭拒的原因。
联合字段 business_registration。工商登记的注册信息。它将采用以下形式之一，具体取决于不同国家/地区的要求。business_registration 只能是下列其中一项：
registrationNumber

object (BusinessRegistrationNumber)

仅限输出。存储商家政府签发的号码。
registrationDocument

object (BusinessRegistrationDocument)

仅限输出。用于存储商家证件信息的消息。

LocalServicesBusinessRegistrationType

枚举，用于描述本地服务商家注册检查验证制品的可能注册类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
NUMBER 注册号检查类型。
DOCUMENT 注册文件检查类型。

LocalServicesBusinessRegistrationCheckRejectionReason

枚举，用于描述本地服务商家注册检查验证制品的可能拒绝原因。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
BUSINESS_NAME_MISMATCH 商家名称与本地生活服务广告的商家名称不一致。
BUSINESS_DETAILS_MISMATCH 商家详情不一致。
ID_NOT_FOUND 未找到工商注册 ID。
POOR_DOCUMENT_IMAGE_QUALITY 上传的证件不清晰、模糊不清等
DOCUMENT_EXPIRED 上传的文件已过期。
DOCUMENT_INVALID 证件已被撤消或作废。
DOCUMENT_TYPE_MISMATCH 证件类型不匹配。
DOCUMENT_UNVERIFIABLE 上传的证件无法验证为合法证件。
OTHER 由于存在问题，无法完成商家注册流程。如需了解详情，请访问 https://support.google.com/localservices。

BusinessRegistrationNumber

一种用于保存与本地服务商家注册号相关信息的 proto。

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

string

仅限输出。商家由政府签发的编号。

BusinessRegistrationDocument

一种用于保存与本地服务商家登记文件相关信息的 proto。

JSON 表示法 
{
  "documentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
字段
documentReadonly

object (LocalServicesDocumentReadOnly)

仅限输出。包含已上传的商业登记文件信息的只读字段。

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 平板电脑。

OfflineConversionUploadClientSummary

客户级线下转化数据上传摘要。

JSON 表示法 
{
  "resourceName": string,
  "client": enum (OfflineEventUploadClient),
  "status": enum (OfflineConversionDiagnosticStatus),
  "totalEventCount": string,
  "successfulEventCount": string,
  "successRate": number,
  "pendingEventCount": string,
  "pendingRate": number,
  "lastUploadDateTime": string,
  "dailySummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "jobSummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "alerts": [
    {
      object (OfflineConversionAlert)
    }
  ]
}
字段
resourceName

string

仅限输出。客户级线下转化上传摘要的资源名称。线下转化数据上传客户摘要资源名称采用以下格式：

customers/{customerId}/offlineConversionUploadClientSummaries/{client}
client

enum (OfflineEventUploadClient)

仅限输出。上传事件的客户端类型。
status

enum (OfflineConversionDiagnosticStatus)

仅限输出。线下转化客户摘要的总体状态。状态是根据最近一个有上传统计信息的日历日生成的。
totalEventCount

string (int64 format)

仅限输出。上传的事件总数。
successfulEventCount

string (int64 format)

仅限输出。成功上传的事件总数。
successRate

number

仅限输出。成功率。
pendingEventCount

string (int64 format)

仅限输出。待上传事件的总数。
pendingRate

number

仅限输出。待处理事件总数与事件总数的比率。
lastUploadDateTime

string

仅限输出。最新上传批次的日期。格式为“yyyy-mm-dd hh:mm:ss”，并且采用 Google Ads 账号的时区。
dailySummaries[]

object (OfflineConversionSummary)

仅限输出。按过去 N 天汇总的历史统计数据。
jobSummaries[]

object (OfflineConversionSummary)

仅限输出。按最近 N 个作业汇总的历史统计信息。
alerts[]

object (OfflineConversionAlert)

仅限输出。每个错误代码的详细信息。提醒是根据最近一个包含上传统计数据的日历日生成的。

OfflineEventUploadClient

客户类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
GOOGLE_ADS_API Google Ads API。
GOOGLE_ADS_WEB_CLIENT Google Ads 网络客户端，可能包含多个来源，例如 Google Ads 界面、SFTP 等。
ADS_DATA_CONNECTOR 连接平台。

OfflineConversionDiagnosticStatus

离线注入设置的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
EXCELLENT 您的线下数据注入设置已启用，并且最适合进行下游处理。
GOOD 您的线下数据提取设置已启用，但还可以做出进一步改进。查看提醒。
NEEDS_ATTENTION 您的线下数据提取设置已启用，但存在一些错误需要您注意。查看提醒。
NO_RECENT_UPLOAD 您的线下数据提取设置在过去 28 天内未收到任何数据，其中可能存在问题。

OfflineConversionSummary

按上传日期或作业分组的历史上传摘要。

JSON 表示法 
{
  "successfulCount": string,
  "failedCount": string,
  "pendingCount": string,

  // Union field dimension_key can be only one of the following:
  "jobId": string,
  "uploadDate": string
  // End of list of possible types for union field dimension_key.
}
字段
successfulCount

string (int64 format)

仅限输出。成功事件的总数。
failedCount

string (int64 format)

仅限输出。失败事件的总数。
pendingCount

string (int64 format)

仅限输出。待上传事件的总数。
联合字段 dimension_key。摘要的维度键。dimension_key 只能是下列其中一项：
jobId

string (int64 format)

仅限输出。最后 N 个作业的维度键。
uploadDate

string

仅限输出。过去 N 天的维度键。

OfflineConversionAlert

针对线下转化客户摘要的提醒。

JSON 表示法 
{
  "error": {
    object (OfflineConversionError)
  },
  "errorPercentage": number
}
字段
error

object (OfflineConversionError)

仅限输出。线下转化客户提醒出错。
errorPercentage

number

仅限输出。误差百分比，此字段的范围应为 [0, 1.0]。

OfflineConversionError

线下转化客户摘要可能出现的错误。

JSON 表示法 
{

  // Union field error_code can be only one of the following:
  "collectionSizeError": enum (CollectionSizeError),
  "conversionAdjustmentUploadError": enum (ConversionAdjustmentUploadError),
  "conversionUploadError": enum (ConversionUploadError),
  "dateError": enum (DateError),
  "distinctError": enum (DistinctError),
  "fieldError": enum (FieldError),
  "mutateError": enum (MutateError),
  "notAllowlistedError": enum (NotAllowlistedError),
  "stringFormatError": enum (StringFormatError),
  "stringLengthError": enum (StringLengthError)
  // End of list of possible types for union field error_code.
}
字段
联合字段 error_code。说明出错。error_code 只能是下列其中一项：
collectionSizeError

enum (CollectionSizeError)

仅限输出。集合大小错误。
conversionAdjustmentUploadError

enum (ConversionAdjustmentUploadError)

仅限输出。转化调整上传错误。
conversionUploadError

enum (ConversionUploadError)

仅限输出。转化数据上传错误。
dateError

enum (DateError)

仅限输出。日期错误。
distinctError

enum (DistinctError)

仅限输出。不同的错误。
fieldError

enum (FieldError)

仅限输出。字段错误。
mutateError

enum (MutateError)

仅限输出。Mutate 错误。
notAllowlistedError

enum (NotAllowlistedError)

仅限输出。未列入许可名单错误。
stringFormatError

enum (StringFormatError)

仅限输出。字符串格式错误。
stringLengthError

enum (StringLengthError)

仅限输出。字符串长度错误。

CollectionSizeError

用于描述可能出现的集合大小错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不含收到的错误代码。
TOO_FEW 太少。
TOO_MANY 数量过多。

ConversionAdjustmentUploadError

枚举，用于描述可能出现的转化调整上传错误。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
TOO_RECENT_CONVERSION_ACTION 无法将事件导入刚刚创建的转化操作。请在 6 小时后再次尝试导入。
CONVERSION_ALREADY_RETRACTED 相应转化已撤消。此调整项未得到处理。
CONVERSION_NOT_FOUND 找不到此转化操作和转化标识符对应的转化数据。请确保您的转化标识符与正确的转化操作相关联，然后重试。
CONVERSION_EXPIRED 无法对早于 54 天前发生的转化进行调整。
ADJUSTMENT_PRECEDES_CONVERSION 调整的 adjustmentDateTime 发生在关联的转化之前。请确保您的 adjustmentDateTime 正确无误，然后重试。
MORE_RECENT_RESTATEMENT_FOUND 已报告关联的转化的最新调整 adjustmentDateTime。请确保您的调整 adjustmentDateTime 正确无误，然后重试。
TOO_RECENT_CONVERSION 由于转化时间过近，因此无法记录调整项。请尝试调整至少 24 小时前发生的转化。
CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE 无法对设置为使用默认价值的转化进行调整。请检查您的转化操作价值设置，然后重试。
TOO_MANY_ADJUSTMENTS_IN_REQUEST 请尝试在单个 API 请求中上传少于 2,001 个调整项。
TOO_MANY_ADJUSTMENTS 相应转化的调整次数已达到上限。请确保您仅对现有转化做出必要的调整。
RESTATEMENT_ALREADY_EXISTS 相应转化先前已有相同 adjustmentDateTime 的重报。请确保调整项的 adjustmentDateTime 正确无误且唯一，然后重试。
DUPLICATE_ADJUSTMENT_IN_REQUEST 导入的调整项包含重复的转化调整项，且具有相同的 adjustmentDateTime。请确保调整项的 adjustmentDateTime 正确无误，然后重试。
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS 请确保您已在转化设置中同意客户数据处理条款，然后重试。
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT 无法将增强型转化与指定的转化操作搭配使用。
INVALID_USER_IDENTIFIER 请务必使用 SHA-256 算法对用户提供的数据进行哈希处理，并确保您按照相关准则进行规范化。
UNSUPPORTED_USER_IDENTIFIER 请使用用户提供的数据（例如使用 SHA-256 算法进行哈希处理的电子邮件地址或电话号码），然后重试。
GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET 无法同时设置 gclidDateTimePair 和 orderId。请仅使用一种类型，然后重试。
CONVERSION_ALREADY_ENHANCED 转化已经包含相同订单 ID 和转化操作的增强信息。请确保您的数据配置正确无误，然后重试。
DUPLICATE_ENHANCEMENT_IN_REQUEST 多项增强功能具有相同的转化操作和订单 ID。请确保您的数据配置正确无误，然后重试。
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT 由于 Google 客户数据政策，此账号无法使用增强型转化。请与您的 Google 代表联系。
MISSING_ORDER_ID_FOR_WEBPAGE 调整网站转化需要提供订单 ID（即交易 ID）。请确保您的网站代码能够获取订单 ID，并且您在进行调整时发送相同的订单 ID。
ORDER_ID_CONTAINS_PII 无法对包含个人身份信息 (PII) 的订单 ID 进行调整。
INVALID_JOB_ID 请求中提供的职位 ID 不在允许范围内。职位 ID 必须是 [1, 2^31] 这个范围内的正整数。
NO_CONVERSION_ACTION_FOUND 找不到调整请求中指定的转化操作。请确保该转化操作可在此账号中使用。
INVALID_CONVERSION_ACTION_TYPE 调整请求中指定的转化操作类型不支持上传调整项。RETRACTION 或 RESTATEMENT 类型的转化调整项只能用于 SALESFORCE、UPLOAD_CLICK 或 WEBPAGE 类型的转化操作。ENHANCEMENT 类型的转化调整项只能用于 WEBPAGE 类型的转化操作。

ConversionUploadError

枚举，用于描述可能出现的转化数据上传错误。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
TOO_MANY_CONVERSIONS_IN_REQUEST 在单个请求中上传的事件数量少于 2,001 个。
UNPARSEABLE_GCLID 无法对导入的 GCLID 进行解码。
CONVERSION_PRECEDES_EVENT 导入事件的 conversionDateTime 早于点击。请确保您的 conversionDateTime 正确无误，然后重试。
EXPIRED_EVENT 此项转化的点击时间早于其点击型转化时间范围，因此无法记录导入的事件。请确保您导入的是最新数据。
TOO_RECENT_EVENT 与给定标识符或 iOS 网址参数关联的点击发生时间还不到 6 小时。请在 6 小时后重试。
EVENT_NOT_FOUND 导入的事件无法归因于某个点击。导致这种情况的原因可能是：相应事件不是由 Google Ads 广告系列带来的。
UNAUTHORIZED_CUSTOMER 点击 ID 或调用与您无权访问的 Google Ads 账号相关联。请务必导入由您的经理账号管理的账号的转化数据。
TOO_RECENT_CONVERSION_ACTION 无法将事件导入刚刚创建的转化操作。请在 6 小时后再次尝试导入。
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME 在发生点击时，相应点击的 Google Ads 账号的有效转化账号中未启用转化跟踪。
EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION 导入的事件包含外部归因数据，但相应转化操作未设置为使用外部归因模型。请确保转化操作配置正确无误，然后重试。
EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION 转化操作已设置为使用外部归因模型，但导入的事件缺少数据。请确保导入的事件包含外部归因功劳和所有必填字段。
ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION 订单 ID 无法用于通过外部归因模型衡量的转化。请确保该转化配置正确无误，并且导入的事件仅包含必要的数据，然后重试。
ORDER_ID_ALREADY_IN_USE 导入的事件包含之前已记录的订单 ID，因此未处理该事件。
DUPLICATE_ORDER_ID 导入的事件包含多个具有相同订单 ID 的转化，因而未能得到处理。请确保订单 ID 是唯一的，然后重试。
TOO_RECENT_CALL 无法导入 6 小时内发生的通话。请在 6 小时后再次尝试上传。
EXPIRED_CALL 由于通话发生在相应转化操作的回溯期之前，因此无法记录。请确保您的导入设置配置为获取最新数据。
CALL_NOT_FOUND 找不到与导入的事件相关联的来电或点击。请确保您的数据源已设置为包含正确的标识符。
CONVERSION_PRECEDES_CALL 相应来电的 conversionDateTime 早于相关联的点击。确保您的 conversionDateTime 正确无误。
CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME 在导入的来电发生时，点击的 Google Ads 账号的有效转化账号中未启用转化跟踪。
UNPARSEABLE_CALLERS_PHONE_NUMBER 请确保电话号码采用 E.164 (+16502531234)、国际电话号码 (+64 3-331 6005) 或美国国内电话号码 (6502531234) 格式。
CLICK_CONVERSION_ALREADY_EXISTS 导入的事件与现有转化具有相同的点击和 conversionDateTime。为每个唯一事件使用唯一的 conversionDateTime 或订单 ID，然后重试。
CALL_CONVERSION_ALREADY_EXISTS 导入的来电与现有转化具有相同的 conversionDateTime。请确保您的 conversionDateTime 配置正确无误，然后重试。
DUPLICATE_CLICK_CONVERSION_IN_REQUEST 多个事件具有相同的点击和 conversionDateTime。请确保您的 conversionDateTime 配置正确无误，然后重试。
DUPLICATE_CALL_CONVERSION_IN_REQUEST 多个事件具有相同的来电信息和 conversionDateTime。请确保您的 conversionDateTime 配置正确无误，然后重试。
CUSTOM_VARIABLE_NOT_ENABLED 在转化设置中启用自定义变量，然后重试。
CUSTOM_VARIABLE_VALUE_CONTAINS_PII 事件的自定义变量包含个人身份信息 (PII)，因此无法导入。请移除这些变量，然后重试。
INVALID_CUSTOMER_FOR_CLICK 导入的事件带来的点击与其他 Google Ads 账号相关联。请确保要导入的账号正确无误。
INVALID_CUSTOMER_FOR_CALL 来电带来的点击与其他 Google Ads 账号相关联。请确保要导入的账号正确无误。在客户账号上查询 conversionTrackingSetting.google_ads_conversion_customer，以确定正确的账号。
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY 无法导入相应转化，因为转化来源未遵守 Apple 应用透明度跟踪 (ATT) 政策，或者客户未同意跟踪。
CLICK_NOT_FOUND 此事件的电子邮件地址或电话号码无法与点击相匹配。这可能是因为该事件不是由 Google Ads 广告系列促成，您可以放心地忽略此警告。如果包含的导入事件数量超出预期，您可能需要检查设置。
INVALID_USER_IDENTIFIER 请务必使用 SHA-256 算法对用户提供的数据进行哈希处理，并确保您按照相关准则进行规范化。
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER 用户提供的数据不能与外部归因模型一起使用。请改用其他归因模型或省略用户标识符，然后重试。
UNSUPPORTED_USER_IDENTIFIER 所提供的用户标识符不受支持。请仅使用经过哈希处理的电子邮件或电话号码，然后重试。
GBRAID_WBRAID_BOTH_SET 无法同时使用 gbraid 和 wbraid 参数。请仅使用其中一个，然后重试。
UNPARSEABLE_WBRAID 无法解析事件导入数据。请检查您的 wbraid 参数是否未修改，然后重试。
UNPARSEABLE_GBRAID 无法解析事件导入数据。请检查您的 gbraid 参数是否未修改，然后重试。
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID 使用每次点击统计为一次转化设置的转化操作无法与 gbraid 或 wbraid 参数配合使用。
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS 由于 Google 客户数据政策，此账号无法使用增强型转化。请与您的 Google 代表联系。
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS 请确保您已在转化设置中同意客户数据处理条款，然后重试。您可以通过在 Customer 上查询 conversionTrackingSetting.accepted_customer_data_terms 来检查您的设置。
ORDER_ID_CONTAINS_PII 事件的订单 ID 包含个人身份信息 (PII)，因此无法导入。
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS 请确保您已在转化设置中启用增强型潜在客户转化，然后重试。您可以通过在 Customer 上查询 conversionTrackingSetting.enhanced_conversions_for_leads_enabled 来检查设置。
INVALID_JOB_ID 请求中提供的职位 ID 不在允许范围内。职位 ID 必须是 [1, 2^31] 这个范围内的正整数。
NO_CONVERSION_ACTION_FOUND 找不到上传请求中指定的转化操作。请确保该转化操作可在此账号中使用。
INVALID_CONVERSION_ACTION_TYPE 上传请求中指定的转化操作未设置为上传相应转化数据。

DateError

用于描述可能出现的日期错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不含收到的错误代码。
INVALID_FIELD_VALUES_IN_DATE 指定的字段值与有效日期不符。
INVALID_FIELD_VALUES_IN_DATE_TIME 指定的字段值不对应于有效的日期时间。
INVALID_STRING_DATE 字符串日期的格式应为 yyyy-mm-dd。
INVALID_STRING_DATE_TIME_MICROS 字符串日期时间的格式应为 yyyy-mm-dd hh:mm:ss.ssssss。
INVALID_STRING_DATE_TIME_SECONDS 字符串日期时间的格式应为 yyyy-mm-dd hh:mm:ss。
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET 字符串日期时间的格式应为 yyyy-mm-dd hh:mm:ss+|-hh:mm。
EARLIER_THAN_MINIMUM_DATE 日期早于允许的最早日期。
LATER_THAN_MAXIMUM_DATE 日期晚于允许的最晚日期。
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE 构成日期范围的下限日期晚于相应的上限日期。
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL 构成日期范围的上限与下限日期都为 Null。

DistinctError

用于描述可能出现的不同错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不含收到的错误代码。
DUPLICATE_ELEMENT 元素重复。
DUPLICATE_TYPE 重复类型。

FieldError

用于描述可能出现的字段错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不含收到的错误代码。
REQUIRED 缺少必填字段。
IMMUTABLE_FIELD 尝试更改的字段不可变。
INVALID_VALUE 相应字段的值无效。
VALUE_MUST_BE_UNSET 无法设置该字段。
REQUIRED_NONEMPTY_LIST 必需的重复字段为空。
FIELD_CANNOT_BE_CLEARED 无法清除该字段。
BLOCKED_VALUE 相应字段的值位于该字段的禁止列表中。
FIELD_CAN_ONLY_BE_CLEARED 该字段的值无法修改，但可以清除。

MutateError

用于描述可能出现的变异错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不含收到的错误代码。
RESOURCE_NOT_FOUND 找不到所请求的资源。
ID_EXISTS_IN_MULTIPLE_MUTATES 无法在一次请求中对同一资源进行两次更改。
INCONSISTENT_FIELD_VALUES 相应字段的内容与表示相同数据的另一个字段不匹配。
MUTATE_NOT_ALLOWED 不允许对所请求的资源进行更改。
RESOURCE_NOT_IN_GOOGLE_ADS 相应资源不在 Google Ads 中。属于其他广告系统。
RESOURCE_ALREADY_EXISTS 要创建的资源已存在。
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY 此资源无法与“validateOnly”搭配使用。
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE 此操作不能与“partialFailure”搭配使用。
RESOURCE_READ_ONLY 尝试写入只读字段。

NotAllowlistedError

用于描述可能出现的未列入许可名单错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不含收到的错误代码。
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE 客户未列入可使用该功能的许可名单。

StringFormatError

用于描述可能出现的字符串格式错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不含收到的错误代码。
ILLEGAL_CHARS 输入字符串值包含不允许使用的字符。
INVALID_FORMAT 输入字符串值对于关联的字段无效。

StringLengthError

用于描述可能出现的字符串长度错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不含收到的错误代码。
EMPTY 指定的字段应包含至少一个非空白字符。
TOO_SHORT 太短。
TOO_LONG 过长。

OfflineConversionUploadConversionActionSummary

转化操作一级的线下转化数据上传摘要。

JSON 表示法 
{
  "resourceName": string,
  "client": enum (OfflineEventUploadClient),
  "conversionActionId": string,
  "conversionActionName": string,
  "status": enum (OfflineConversionDiagnosticStatus),
  "totalEventCount": string,
  "successfulEventCount": string,
  "pendingEventCount": string,
  "lastUploadDateTime": string,
  "dailySummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "jobSummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "alerts": [
    {
      object (OfflineConversionAlert)
    }
  ]
}
字段
resourceName

string

仅限输出。转化操作级线下转化数据上传摘要的资源名称。线下转化数据上传转化操作摘要资源名称采用以下格式：

customers/{customerId}/offlineConversionUploadConversionActionSummaries/{conversionActionId}~{client}
client

enum (OfflineEventUploadClient)

仅限输出。上传事件的客户端类型。
conversionActionId

string (int64 format)

仅限输出。转化操作 ID。
conversionActionName

string

仅限输出。转化操作的名称。
status

enum (OfflineConversionDiagnosticStatus)

仅限输出。线下转化上传转化操作摘要的总体状态。状态是根据最近一个有上传统计信息的日历日生成的。
totalEventCount

string (int64 format)

仅限输出。上传的事件总数。
successfulEventCount

string (int64 format)

仅限输出。成功上传的事件总数。
pendingEventCount

string (int64 format)

仅限输出。待上传事件的总数。
lastUploadDateTime

string

仅限输出。最新上传批次的日期。格式为“yyyy-mm-dd hh:mm:ss”，并且采用 Google Ads 账号的时区。
dailySummaries[]

object (OfflineConversionSummary)

仅限输出。按过去 N 天汇总的历史统计数据。
jobSummaries[]

object (OfflineConversionSummary)

仅限输出。按最近 N 个作业汇总的历史统计信息。
alerts[]

object (OfflineConversionAlert)

仅限输出。每个错误代码的详细信息。提醒是根据最近一个包含上传统计数据的日历日生成的。

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

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

'qualifyingQuestions/{qualifyingQuestionId}'
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。

PerformanceMaxPlacementView

包含效果最大化广告系列展示位置的展示次数指标的视图。

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

string

仅限输出。效果最大化广告系列展示位置视图的资源名称。效果最大化广告系列展示位置视图资源名称的格式为：

customers/{customerId}/performanceMaxPlacementViews/{base_64_placement}
placementType

enum (PlacementType)

仅限输出。展示位置的类型。效果最大化广告系列展示位置的可能值为 WEBSITE、MOBILE_APPLICATION 或 YOUTUBE_VIDEO。
placement

string

仅限输出。默认展示位置字符串，例如网站网址、移动应用 ID 或 YouTube 视频 ID。
displayName

string

仅限输出。用于表示展示位置的显示名称，例如网站的网址名称、YouTube 视频的 YouTube 视频名称，以及移动应用的已翻译移动应用名称。
targetUrl

string

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

ProductCategoryConstant

商品类别。

JSON 表示法 
{
  "resourceName": string,
  "categoryId": string,
  "level": enum (ProductCategoryLevel),
  "state": enum (ProductCategoryState),
  "localizations": [
    {
      object (ProductCategoryLocalization)
    }
  ],
  "productCategoryConstantParent": string
}
字段
resourceName

string

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

productCategoryConstants/{level}~{categoryId}
categoryId

string (int64 format)

仅限输出。商品类别的 ID。

此 ID 等同于 google_product_category ID，如以下文章中所述：https://support.google.com/merchants/answer/6324436。
level

enum (ProductCategoryLevel)

仅限输出。商品类别的级别。
state

enum (ProductCategoryState)

仅限输出。商品类别的状态。
localizations[]

object (ProductCategoryLocalization)

仅限输出。商品类别的所有可用本地化版本的列表。
productCategoryConstantParent

string

仅限输出。父商品类别的资源名称。

ProductCategoryState

用于描述商品类别状态的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ENABLED 相应类别已启用。
OBSOLETE 相应类别已过时。仅用于生成报告。

ProductCategoryLocalization

商品类别的本地化信息。

JSON 表示法 
{
  "regionCode": string,
  "languageCode": string,
  "value": string
}
字段
regionCode

string

仅限输出。本地化类别的双字母 ISO 3166-1 国家/地区代码（大写）。
languageCode

string

仅限输出。本地化类别的双字母 ISO 639-1 语言代码。
value

string

仅限输出。指定语言区域中相应类别的名称。

ProductGroupView

产品组视图。

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

string

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

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

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

ShoppingProduct

Google Merchant Center 中的一种购物产品，可通过广告系列进行宣传。

该资源会返回与客户相关联的 Google Merchant Center 账号中当前存在的产品。广告系列通过在 ShoppingSetting 中指定商品的商家 ID（或商家的多客户账号 ID，如果可用）来包含商品，并且可以将包含范围限制为具有指定 Feed 标签的商品。标准购物广告系列还可以通过 campaignCriterion.listing_scope 限制纳入范围。

针对此资源的查询指定了范围：账号： - 未指定广告系列或广告组过滤条件。 - 返回关联的 Google Merchant Center 账号中的所有商品。- 指标和某些字段（请参阅各个字段的文档）会针对包含相应产品的所有购物广告系列和效果最大化广告系列进行汇总。广告系列：- 指定了针对 campaign 的相等性过滤条件。支持的广告系列类型包括购物广告系列、效果最大化广告系列、需求开发广告系列和视频广告系列。- 仅返回指定广告系列中包含的商品。- 指标和某些字段（请参阅各个字段的文档）仅限于指定的广告系列。广告组：- 指定了针对 ad group 和 campaign 的等值过滤条件。支持的广告系列类型包括购物广告系列、需求开发广告系列和视频广告系列。- 仅返回指定广告系列中包含的商品。- 指标和某些字段（请参阅各个字段的文档）仅限于指定的广告组。请注意，不允许按日期段进行细分，否则将返回 UNSUPPORTED_DATE_SEGMENTATION 错误。另一方面，允许按日期细分进行过滤。

JSON 表示法 
{
  "resourceName": string,
  "merchantCenterId": string,
  "channel": enum (ProductChannel),
  "languageCode": string,
  "feedLabel": string,
  "itemId": string,
  "targetCountries": [
    string
  ],
  "status": enum (ProductStatus),
  "issues": [
    {
      object (ProductIssue)
    }
  ],
  "multiClientAccountId": string,
  "title": string,
  "brand": string,
  "priceMicros": string,
  "currencyCode": string,
  "channelExclusivity": enum (ProductChannelExclusivity),
  "condition": enum (ProductCondition),
  "availability": enum (ProductAvailability),
  "customAttribute0": string,
  "customAttribute1": string,
  "customAttribute2": string,
  "customAttribute3": string,
  "customAttribute4": string,
  "categoryLevel1": string,
  "categoryLevel2": string,
  "categoryLevel3": string,
  "categoryLevel4": string,
  "categoryLevel5": string,
  "productTypeLevel1": string,
  "productTypeLevel2": string,
  "productTypeLevel3": string,
  "productTypeLevel4": string,
  "productTypeLevel5": string,
  "effectiveMaxCpcMicros": string,
  "campaign": string,
  "adGroup": string
}
字段
resourceName

string

仅限输出。购物商品的资源名称。购物商品资源名称的格式如下：

customers/{customerId}/shoppingProducts/{merchantCenterId}~{channel}~{languageCode}~{feedLabel}~{itemId}
merchantCenterId

string (int64 format)

仅限输出。拥有相应商品的商家的 ID。
channel

enum (ProductChannel)

仅限输出。描述商品所在地区的商品渠道。
languageCode

string

仅限输出。商家提供的语言代码，采用 BCP 47 格式。
feedLabel

string

仅限输出。商家提供的商品 Feed 标签。
itemId

string

仅限输出。商家提供的商品的商品 ID。
targetCountries[]

string

仅限输出。商品要在广告中展示的区域的 ISO 3166-1 代码（由两个大写字母组成）。
status

enum (ProductStatus)

仅限输出。指示相应商品能否在广告中展示的状态。此字段的值仅限于查询中指定的范围，请参阅相应资源的文档。此字段最多可能需要 24 小时才能更新。
issues[]

object (ProductIssue)

仅限输出。影响商品能否在广告中展示的问题列表。此字段的值仅限于查询中指定的范围，请参阅相应资源的文档。此字段最多可能需要 24 小时才能更新。
multiClientAccountId

string (int64 format)

仅限输出。商家的多客户账号的 ID（如有）。
title

string

仅限输出。商家提供的商品名称。
brand

string

仅限输出。商家提供的商品品牌。
priceMicros

string (int64 format)

仅限输出。商家提供的商品价格（以微单位表示），采用 currencyCode 中指定的币种（例如，2.97 美元报告为 2970000）。
currencyCode

string

仅限输出。商家提供的币种代码，采用 ISO 4217 格式。
channelExclusivity

enum (ProductChannelExclusivity)

仅限输出。商家提供的商品的渠道独占性。
condition

enum (ProductCondition)

仅限输出。商家提供的商品使用情况。
availability

enum (ProductAvailability)

仅限输出。商家提供的商品库存状况。
customAttribute0

string

仅限输出。商家提供的商品的自定义属性 0。
customAttribute1

string

仅限输出。商家提供的商品的自定义属性 1。
customAttribute2

string

仅限输出。商家提供的商品的自定义属性 2。
customAttribute3

string

仅限输出。商家提供的商品的自定义属性 3。
customAttribute4

string

仅限输出。商家提供的商品的自定义属性 4。
categoryLevel1

string

仅限输出。商品的第 1 级类别。
categoryLevel2

string

仅限输出。商品的类别级别 2。
categoryLevel3

string

仅限输出。商品的类别级别 3。
categoryLevel4

string

仅限输出。商品的第 4 级类别。
categoryLevel5

string

仅限输出。商品的第 5 级类别。
productTypeLevel1

string

仅限输出。商家提供的商品类型（第 1 级）。
productTypeLevel2

string

仅限输出。商家提供的产品类型（第 2 级）。
productTypeLevel3

string

仅限输出。商家提供的商品类型（第 3 级）。
productTypeLevel4

string

仅限输出。商家提供的商品类型（第 4 级）。
productTypeLevel5

string

仅限输出。商家提供的商品类型（第 5 级）。
effectiveMaxCpcMicros

string (int64 format)

仅限输出。产品的有效最高每次点击费用。只有在查询指定了广告系列或广告组范围，且广告系列使用人工出价时，此字段才可用。该值是为所有已启用的广告组中的产品组内的相应产品设置的最高出价。它表示您愿意为产品获得的每次点击支付的最高金额。此字段最多可能需要 24 小时才能更新。
campaign

string

仅限输出。包含相应产品的广告系列。此字段只能在广告系列范围内选择，并且需要对 campaign 应用等值过滤条件。
adGroup

string

仅限输出。包含相应产品的广告系列的广告组。此字段只能在广告组范围内选择，这需要在 campaign 和 adGroup 上使用等值过滤条件。

ProductAvailability

商品库存状况。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
IN_STOCK 产品有货。
OUT_OF_STOCK 此商品缺货。
PREORDER 商品可预订。

ProductStatus

用于描述商品状态的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
NOT_ELIGIBLE 相应商品无法在广告中展示。
ELIGIBLE_LIMITED 产品可以在广告中展示，但由于存在已发现的问题，其展示位置和时间可能会受到限制。
ELIGIBLE 商品可以在广告中展示。

ProductIssue

影响商品能否在广告中展示的问题。

JSON 表示法 
{
  "errorCode": string,
  "adsSeverity": enum (ProductIssueSeverity),
  "description": string,
  "detail": string,
  "documentation": string,
  "affectedRegions": [
    string
  ],
  "attributeName": string
}
字段
errorCode

string

仅限输出。用于标识问题的错误代码。
adsSeverity

enum (ProductIssueSeverity)

仅限输出。Google Ads 中问题的严重程度。
description

string

仅限输出。问题的简短说明（英文）。
detail

string

仅限输出。问题的详细说明（以英文编写）。
documentation

string

仅限输出。相应问题的帮助中心文章的网址。
affectedRegions[]

string

仅限输出。受问题影响的区域的两个字母的大写 ISO 3166-1 代码列表。如果为空，则表示所有地区都受到影响。
attributeName

string

仅限输出。触发问题的商品属性的名称（如有）。

ProductIssueSeverity

商品问题的严重程度。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
WARNING 此问题会限制相应产品在广告中的效果。
ERROR 此问题会导致相应商品无法在广告中展示。

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

包含可能的用户兴趣分类类型的枚举。

枚举
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

仅限输出。要定位或排除的类别。数组中的每个后续元素都描述了一个更具体的子类别。例如，{"宠物和动物", "宠物", "狗"} 表示“宠物和动物/宠物/狗”类别。可在 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 个字符。

LocalServicesLead

本地生活服务潜在客户的数据。包含用户通过致电、发消息或预订广告客户的服务而生成的潜在客户的详细信息。如需了解详情，请访问 https://ads.google.com/local-services-ads

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "categoryId": string,
  "serviceId": string,
  "contactDetails": {
    object (ContactDetails)
  },
  "leadType": enum (LeadType),
  "leadStatus": enum (LeadStatus),
  "creationDateTime": string,
  "locale": string,
  "leadCharged": boolean,
  "leadFeedbackSubmitted": boolean,
  "note": {
    object (Note)
  },
  "creditDetails": {
    object (CreditDetails)
  }
}
字段
resourceName

string

仅限输出。本地服务潜在客户数据的资源名称。本地生活服务潜在客户资源名称采用以下格式

customers/{customerId}/localServicesLead/{local_services_lead_id}
id

string (int64 format)

仅限输出。相应潜在客户的 ID。
categoryId

string

仅限输出。潜在客户的服务类别。例如：xcat:service_area_business_hvac、xcat:service_area_business_real_estate_agent 等。如需了解详情，请参阅：https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
serviceId

string

仅限输出。相应类别的服务。例如：buyer_agent、seller_agent（针对 xcat:service_area_business_real_estate_agent 类别）。
contactDetails

object (ContactDetails)

仅限输出。潜在客户的详细联系信息。
leadType

enum (LeadType)

仅限输出。本地生活服务潜在客户的类型：电话、消息、预订等。
leadStatus

enum (LeadStatus)

仅限输出。潜在客户的当前状态。
creationDateTime

string

仅限输出。本地生活服务广告创建潜在客户的日期和时间。格式为“YYYY-MM-DD HH:MM:SS”，采用 Google Ads 账号的时区。示例：“2018-03-05 09:15:00”或“2018-02-01 14:34:30”
locale

string

仅限输出。与潜在客户相关联的本地生活服务提供商所用的语言。请参阅 https://developers.google.com/google-ads/api/data/codes-formats#locales
leadCharged

boolean

仅限输出。如果广告客户因潜在客户而付费，则为 true。
leadFeedbackSubmitted

boolean

仅限输出。如果广告客户已针对相应潜在客户提交反馈，则为 true。
note

object (Note)

仅限输出。广告客户为潜在客户添加的备注。
creditDetails

object (CreditDetails)

仅限输出。潜在客户的赠金详情。

ContactDetails

包含使用方联系信息的字段。

JSON 表示法 
{
  "phoneNumber": string,
  "email": string,
  "consumerName": string
}
字段
phoneNumber

string

仅限输出。E164 格式的消费者电话号码。
email

string

仅限输出。消费者的电子邮件地址。
consumerName

string

仅限输出。消费者的姓名（如果消费者通过 google.com 上的消息或预订表单提供了姓名）

LeadType

潜在客户的可能类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
MESSAGE 短信咨询的潜在客户。
PHONE_CALL 通过电话创建的潜在客户。
BOOKING 服务预订潜在客户信息。

LeadStatus

潜在客户的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
NEW 广告客户尚未查看的新潜在客户。
ACTIVE 广告客户已与该潜在客户互动。
BOOKED 潜在客户已预约。
DECLINED 广告客户拒绝了相应潜在客户。
EXPIRED 由于闲置时间过长，潜在客户已过期。
DISABLED 由于垃圾内容或争议而被停用。
CONSUMER_DECLINED 使用方拒绝了潜在客户。
WIPED_OUT 潜在客户的个人身份信息会被清除。

备注

表示广告客户向潜在客户添加的备注。广告客户可以修改注释，这会重置修改时间并更改说明。

JSON 表示法 
{
  "editDateTime": string,
  "description": string
}
字段
editDateTime

string

仅限输出。潜在客户备注的编辑日期和时间。格式为“YYYY-MM-DD HH:MM:SS”，采用 Google Ads 账号的时区。示例：“2018-03-05 09:15:00”或“2018-02-01 14:34:30”
description

string

仅限输出。引导注释的内容。

CreditDetails

表示潜在客户的积分详细信息。

JSON 表示法 
{
  "creditState": enum (CreditState),
  "creditStateLastUpdateDateTime": string
}
字段
creditState

enum (CreditState)

仅限输出。潜在客户的信用状态。
creditStateLastUpdateDateTime

string

仅限输出。相应潜在客户的信用状态上次更新的日期和时间。格式为“YYYY-MM-DD HH:MM:SS”，采用 Google Ads 账号的时区。示例：“2018-03-05 09:15:00”或“2018-02-01 14:34:30”

CreditState

潜在客户可能具有的信用状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
PENDING 已提交赠送金额申请，Google Ads 后端正在处理，但尚未将赠送金额应用到相应账号。
CREDITED 返还金额已发放至 Google Ads 账号。

LocalServicesLeadConversation

本地生活服务潜在客户对话中的数据。包含潜在客户对话的详细信息，这些对话是在用户致电、发消息或预订广告客户的服务时生成的。这些信息会附加到潜在客户中。如需了解详情，请访问 https://ads.google.com/local-services-ads

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "conversationChannel": enum (ConversationType),
  "participantType": enum (ParticipantType),
  "lead": string,
  "eventDateTime": string,
  "phoneCallDetails": {
    object (PhoneCallDetails)
  },
  "messageDetails": {
    object (MessageDetails)
  }
}
字段
resourceName

string

仅限输出。本地生活服务潜在客户对话数据的资源名称。本地生活服务潜在客户对话资源名称采用以下格式

customers/{customerId}/localServicesLeadConversation/{local_services_lead_conversation_id}
id

string (int64 format)

仅限输出。相应潜在客户对话的 ID。
conversationChannel

enum (ConversationType)

仅限输出。Google 本地服务广告潜在客户对话的类型，例如 EMAIL、MESSAGE、PHONE_CALL、SMS 等。
participantType

enum (ParticipantType)

仅限输出。潜在客户对话中的参与者类型，即 ADVERTISER 或 CONSUMER。
lead

string

仅限输出。与潜在客户对话关联的潜在客户的资源名称。
eventDateTime

string

仅限输出。本地生活服务广告创建潜在客户对话的日期和时间。格式为“YYYY-MM-DD HH:MM:SS”，采用 Google Ads 账号的时区。示例：“2018-03-05 09:15:00”或“2018-02-01 14:34:30”
phoneCallDetails

object (PhoneCallDetails)

仅限输出。电话通话对话的详细信息（如果为 PHONE_CALL）。
messageDetails

object (MessageDetails)

仅限输出。电子邮件、消息或短信的对话详细信息。

ConversationType

潜在客户对话的可能类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
EMAIL 电子邮件潜在客户对话。
MESSAGE 短信咨询的潜在客户对话。
PHONE_CALL 来电潜在客户对话。
SMS 短信引导对话。
BOOKING 预订潜在客户对话。
WHATSAPP WhatsApp 潜在客户对话。
ADS_API 通过 Google Ads API 创建的潜在客户对话。

ParticipantType

潜在的对话主参与者类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ADVERTISER 本地生活服务广告提供商参与者。
CONSUMER 本地生活服务广告消费者参与者。

PhoneCallDetails

表示电话对话的详细信息。

JSON 表示法 
{
  "callDurationMillis": string,
  "callRecordingUrl": string
}
字段
callDurationMillis

string (int64 format)

仅限输出。通话时长（以毫秒为单位，从开始到结束）。
callRecordingUrl

string

仅限输出。指向通话录音音频文件的网址。

MessageDetails

表示电子邮件、消息或短信的详细信息。

JSON 表示法 
{
  "text": string,
  "attachmentUrls": [
    string
  ]
}
字段
text

string

仅限输出。消息的文本内容。
attachmentUrls[]

string

仅限输出。指向短信或电子邮件附件的网址。这些网址可用于通过开发者令牌下载附件的内容。

AndroidPrivacySharedKeyGoogleAdGroup

Google 广告组密钥的 Android 隐私共享密钥视图。

JSON 表示法 
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "androidPrivacyNetworkType": enum (AndroidPrivacyNetworkType),
  "adGroupId": string,
  "sharedAdGroupKey": string
}
字段
resourceName

string

仅限输出。Android 隐私共享密钥的资源名称。Android 隐私共享密钥资源名称采用以下格式：

customers/{customerId}/androidPrivacySharedKeyGoogleAdGroups/{campaignId}~{adGroupId}~{androidPrivacyInteractionType}~{androidPrivacyNetworkType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}
campaignId

string (int64 format)

仅限输出。分享密钥编码中使用的广告系列 ID。
androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

仅限输出。分享密钥编码中使用的互动类型枚举。
androidPrivacyInteractionDate

string

仅限输出。共享密钥编码中使用的互动日期，采用“YYYY-MM-DD”格式，时区为 UTC。
androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

仅限输出。共享密钥编码中使用的网络类型枚举。
adGroupId

string (int64 format)

仅限输出。共享密钥编码中使用的广告组 ID。
sharedAdGroupKey

string

仅限输出。编码后的共享广告组密钥的 128 位十六进制字符串，包括“0x”前缀。此键可用于与汇总转化键进行按位或运算，以创建完整的汇总键，从而在 Android Privacy Sandbox 中检索 Aggregate API 报告。

AndroidPrivacyInteractionType

枚举互动类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
CLICK 实体点击互动类型。
ENGAGED_VIEW 10 秒感兴趣的观看互动类型。
VIEW 浏览（广告展示）互动类型。

AndroidPrivacyNetworkType

枚举网络类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
SEARCH 搜索网络。
DISPLAY 展示广告网络。
YOUTUBE YouTube 广告网络。

AndroidPrivacySharedKeyGoogleCampaign

Google 广告系列密钥的 Android 隐私共享密钥视图。

JSON 表示法 
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "sharedCampaignKey": string
}
字段
resourceName

string

仅限输出。Android 隐私共享密钥的资源名称。Android 隐私共享密钥资源名称采用以下格式：

customers/{customerId}/androidPrivacySharedKeyGoogleCampaigns/{campaignId}~{androidPrivacyInteractionType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}
campaignId

string (int64 format)

仅限输出。分享密钥编码中使用的广告系列 ID。
androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

仅限输出。分享密钥编码中使用的互动类型枚举。
androidPrivacyInteractionDate

string

仅限输出。共享密钥编码中使用的互动日期，采用“YYYY-MM-DD”格式，时区为 UTC。
sharedCampaignKey

string

仅限输出。编码后的共享广告系列密钥的 128 位十六进制字符串，包括“0x”前缀。此键可用于与汇总转化键进行按位或运算，以创建完整的汇总键，从而在 Android Privacy Sandbox 中检索 Aggregate API 报告。

AndroidPrivacySharedKeyGoogleNetworkType

Google 网络类型密钥的 Android 隐私共享密钥视图。

JSON 表示法 
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "androidPrivacyNetworkType": enum (AndroidPrivacyNetworkType),
  "sharedNetworkTypeKey": string
}
字段
resourceName

string

仅限输出。Android 隐私共享密钥的资源名称。Android 隐私共享密钥资源名称采用以下格式：

customers/{customerId}/androidPrivacySharedKeyGoogleNetworkTypes/{campaignId}~{androidPrivacyInteractionType}~{androidPrivacyNetworkType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}
campaignId

string (int64 format)

仅限输出。分享密钥编码中使用的广告系列 ID。
androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

仅限输出。分享密钥编码中使用的互动类型枚举。
androidPrivacyInteractionDate

string

仅限输出。共享密钥编码中使用的互动日期，采用“YYYY-MM-DD”格式，时区为 UTC。
androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

仅限输出。共享密钥编码中使用的网络类型枚举。
sharedNetworkTypeKey

string

仅限输出。编码后的共享网络类型密钥的 128 位十六进制字符串，包括“0x”前缀。此键可用于与汇总转化键进行按位或运算，以创建完整的汇总键，从而在 Android Privacy Sandbox 中检索 Aggregate API 报告。

指标

指标数据。

JSON 表示法 
{
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "skAdNetworkInstalls": string,
  "skAdNetworkTotalConversions": string,
  "publisherPurchasedClicks": string,
  "publisherOrganicClicks": string,
  "publisherUnknownClicks": string,
  "linkedSampleEntities": [
    string
  ],
  "sampleBestPerformanceEntities": [
    string
  ],
  "sampleGoodPerformanceEntities": [
    string
  ],
  "sampleLowPerformanceEntities": [
    string
  ],
  "sampleLearningPerformanceEntities": [
    string
  ],
  "sampleUnratedPerformanceEntities": [
    string
  ],
  "absoluteTopImpressionPercentage": number,
  "activeViewCpm": number,
  "activeViewCtr": number,
  "activeViewImpressions": string,
  "activeViewMeasurability": number,
  "activeViewMeasurableCostMicros": string,
  "activeViewMeasurableImpressions": string,
  "activeViewViewability": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversionsValueByConversionDate": number,
  "allNewCustomerLifetimeValue": number,
  "allConversions": number,
  "allConversionsByConversionDate": 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,
  "biddableCohortAppPostInstallConversions": 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,
  "conversionsValueByConversionDate": number,
  "newCustomerLifetimeValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "conversions": number,
  "conversionsByConversionDate": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsValueMicros": string,
  "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,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": 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,
  "orders": number,
  "averageOrderValueMicros": string,
  "averageCartSize": number,
  "costOfGoodsSoldMicros": string,
  "grossProfitMicros": string,
  "grossProfitMargin": number,
  "revenueMicros": string,
  "unitsSold": number,
  "crossSellCostOfGoodsSoldMicros": string,
  "crossSellGrossProfitMicros": string,
  "crossSellRevenueMicros": string,
  "crossSellUnitsSold": number,
  "leadCostOfGoodsSoldMicros": string,
  "leadGrossProfitMicros": string,
  "leadRevenueMicros": string,
  "leadUnitsSold": number,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number,
  "linkedEntitiesCount": string,
  "assetPinnedTotalCount": string,
  "assetPinnedAsHeadlinePositionOneCount": string,
  "assetPinnedAsHeadlinePositionTwoCount": string,
  "assetPinnedAsHeadlinePositionThreeCount": string,
  "assetPinnedAsDescriptionPositionOneCount": string,
  "assetPinnedAsDescriptionPositionTwoCount": string,
  "assetBestPerformanceImpressionPercentage": number,
  "assetGoodPerformanceImpressionPercentage": number,
  "assetLowPerformanceImpressionPercentage": number,
  "assetLearningPerformanceImpressionPercentage": number,
  "assetUnratedPerformanceImpressionPercentage": number,
  "assetBestPerformanceCostPercentage": number,
  "assetGoodPerformanceCostPercentage": number,
  "assetLowPerformanceCostPercentage": number,
  "assetLearningPerformanceCostPercentage": number,
  "assetUnratedPerformanceCostPercentage": number,
  "storeVisitsLastClickModelAttributedConversions": number,
  "resultsConversionsPurchase": number,
  "videoViewRateInFeed": number,
  "videoViewRateInStream": number,
  "videoViewRateShorts": number,
  "coviewedImpressions": string,
  "primaryImpressions": string
}
字段
historicalCreativeQualityScore

enum (QualityScoreBucket)

广告素材的历史质量得分。
historicalLandingPageQualityScore

enum (QualityScoreBucket)

历史着陆页体验的质量。
historicalSearchPredictedCtr

enum (QualityScoreBucket)

历史搜索预测点击率 (CTR)。
interactionEventTypes[]

enum (InteractionEventType)

付费和免费互动的类型。
skAdNetworkInstalls

string (int64 format)

iOS Store Kit 广告联盟转化次数。
skAdNetworkTotalConversions

string (int64 format)

iOS Store Kit 广告联盟转化的总次数。
publisherPurchasedClicks

string (int64 format)

来自并非由发布商所拥有的媒体资源的点击，其流量是由发布商付费或通过奖励活动获得的
publisherOrganicClicks

string (int64 format)

来自并非由发布商所拥有的媒体资源的点击，其流量不是由发布商付费或通过奖励活动获得的
publisherUnknownClicks

string (int64 format)

来自未被标识为“发布商购买”或“发布商自然”的流量的点击
linkedSampleEntities[]

string

使用相应素材资源的最多 20 个关联资源示例的列表。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。
sampleBestPerformanceEntities[]

string

最多包含 20 个示例的关联资源列表，这些资源在过去 30 天内获得了展示，且相应素材资源具有 AssetPerformanceLabel.BEST 效果标签。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。
sampleGoodPerformanceEntities[]

string

最多包含 20 个示例的关联资源列表，这些资源在过去 30 天内获得了展示，且相应素材资源具有 AssetPerformanceLabel.GOOD 效果标签。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。
sampleLowPerformanceEntities[]

string

最多包含 20 个示例的关联资源列表，这些资源在过去 30 天内获得了展示，且相应素材资源的效果标签为 AssetPerformanceLabel.LOW。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。
sampleLearningPerformanceEntities[]

string

最多包含 20 个示例的已关联资源列表，这些资源在过去 30 天内获得了展示，且相应素材资源具有 AssetPerformanceLabel.LEARNING 效果标签。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。
sampleUnratedPerformanceEntities[]

string

最多包含 20 个示例关联资源的列表，这些资源在过去 30 天内获得了展示次数，且素材资源的效果标签为 BEST、GOOD、LOW 和 LEARNING 以外的 AssetPerformanceLabel。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。
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

所有转化的值。
allConversionsValueByConversionDate

number

所有转化的值。 如果选择此列并同时选择日期列，则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列，请访问 https://support.google.com/google-ads/answer/9549009。
allNewCustomerLifetimeValue

number

所有新客户的生命周期转化价值。如果您已在账号级或广告系列级设置了客户获取目标，则无论转化是否可出价，系统都会将新客户带来的额外转化价值纳入其中。如果您的广告系列采用了客户获取目标并选择了“针对新客户提高出价”，则这些价值将包含在“allConversionsValue”中。如需了解详情，请访问 https://support.google.com/google-ads/answer/12080169。
allConversions

number

转化总次数。包括所有转化，无论 includeInConversionsMetric 的值如何。
allConversionsByConversionDate

number

转化总次数。包括所有转化，无论 includeInConversionsMetric 的值如何。如果选择此列并同时选择日期列，则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列，请访问 https://support.google.com/google-ads/answer/9549009。
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

应用内操作次数。
biddableCohortAppPostInstallConversions

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) 除以 combinedQueries。如需了解详情，请参阅 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

互动带来的转化次数除以广告互动次数（例如文字广告点击次数或视频广告观看次数）。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
conversionsValue

number

转化的价值。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
conversionsValueByConversionDate

number

转化的价值。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。如果选择此列并同时选择日期列，则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列，请访问 https://support.google.com/google-ads/answer/9549009。
newCustomerLifetimeValue

number

新客户的生命周期转化价值。如果您已在账号级或广告系列级设置客户获取目标，则出价型转化将包含新客户带来的额外转化价值。如果您的广告系列采用了“客户获取”目标并选择了“针对新客户提高出价”，那么这些价值将纳入“conversionsValue”中以进行优化。如需了解详情，请访问 https://support.google.com/google-ads/answer/12080169。
conversionsValuePerCost

number

转化价值除以广告互动费用。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
conversionsFromInteractionsValuePerInteraction

number

互动带来的转化价值除以广告互动次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
conversions

number

转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
conversionsByConversionDate

number

转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。如果选择此列并同时选择日期列，则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列，请访问 https://support.google.com/google-ads/answer/9549009。
costMicros

string (int64 format)

在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。
costPerAllConversions

number

广告互动费用除以所有转化次数。
costPerConversion

number

广告互动费用除以转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
costPerCurrentModelAttributedConversion

number

广告互动费用除以当前模型归因转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
crossDeviceConversions

number

客户在一台设备上点击 Google Ads 广告，然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 allConversions 中。
crossDeviceConversionsValueMicros

string (int64 format)

跨设备转化的价值总和（以微为单位）。
ctr

number

广告获得的点击次数（点击次数）除以广告展示次数（展示次数）。
currentModelAttributedConversions

number

显示历史转化数据在您目前选择的归因模型下的情况。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
currentModelAttributedConversionsFromInteractionsRate

number

当前模型归因于互动的转化次数除以广告互动次数（例如文字广告点击次数或视频广告观看次数）。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
currentModelAttributedConversionsFromInteractionsValuePerInteraction

number

当前模型归因的互动带来的转化价值除以广告互动次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
currentModelAttributedConversionsValue

number

当前模型归因转化的价值。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
currentModelAttributedConversionsValuePerCost

number

当前模型归因转化的价值除以广告互动费用。这仅包括 includeInConversionsMetric 属性设置为 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 认为不合规定且不向您收费的点击次数。
generalInvalidClickRate

number

从总点击次数（过滤后 + 未过滤的点击次数）中滤除的常规无效点击次数所占的百分比。这些是 Google 认为非法的点击次数，是通过常规滤除方式（即已知无效的数据中心流量、漫游器和“蜘蛛”程序或其他抓取工具、不规则模式等）检测到的。我们不会向您收取这些点击的费用，您的账户统计信息也不会受其影响。如需了解详情，请参阅 https://support.google.com/campaignmanager/answer/6076504 提供的帮助页面。
generalInvalidClicks

string (int64 format)

常规无效点击次数。这些是通过常规滤除方式（例如已知无效的数据中心流量、漫游器和“蜘蛛”程序或其他抓取工具、不规则模式等）检测到的无效点击子集。我们不会向您收取这些点击的费用，您的账户统计信息也不会受其影响。如需了解详情，请参阅 https://support.google.com/campaignmanager/answer/6076504 提供的帮助页面。
messageChats

string (int64 format)

符合消息跟踪条件的“点击即发消息”展示带来的消息对话发起次数。
messageImpressions

string (int64 format)

符合消息跟踪条件的“点击即发消息”广告展示次数。
messageChatRate

number

发起的消息对话次数 (messageChats) 除以消息展示次数 (messageImpressions)。用户通过启用了消息选项和消息跟踪功能的广告展示发起消息对话的比率。请注意，对于给定的消息展示，此比率可能大于 1.0。
mobileFriendlyClicksPercentage

number

适合移动设备的页面的移动点击次数所占的百分比。
optimizationScoreUplift

number

所有建议带来的优化得分总增幅。
optimizationScoreUrl

string

Google Ads 网页界面中优化得分页面的网址。此指标可从 customer 或 campaign 中选择，并可按 segments.recommendation_type 进行细分。例如，SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer 将针对每个唯一的（客户、recommendationType）组合返回一个网址。
organicClicks

string (int64 format)

某人针对特定查询点击未付费结果中您的网站的商品详情的次数。如需了解详情，请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。
organicClicksPerQuery

number

某人点击未付费结果中您的网站的商品详情的次数 (organicClicks) 除以返回您的网站的网页的总搜索次数 (organicQueries)。如需了解详情，请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。
organicImpressions

string (int64 format)

未付费搜索结果中您的网站的商品详情数。如需了解详情，请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。
organicImpressionsPerQuery

number

您的网站的网页在未付费搜索结果中列出的次数 (organicImpressions) 除以在未付费结果中返回您的网站的商品详情的搜索次数 (organicQueries)。如需了解详情，请参阅 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

接听的电话次数 (phoneCalls) 除以电话号码展示次数 (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)

平均目标每次转化费用；如果不可用，则为未设置（例如，对于采用组合出价策略或非 tCPA 策略的广告系列）。
averageTargetRoas

number

平均目标广告支出回报率；如果不可用，则为未设置（例如，对于曾采用组合出价策略或非 tROAS 策略获得流量的广告系列）。
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

转化价值除以转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
valuePerConversionsByConversionDate

number

转化价值除以转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。如果选择此列并同时选择日期列，则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列，请访问 https://support.google.com/google-ads/answer/9549009。
valuePerCurrentModelAttributedConversion

number

当前模型归因转化的价值除以转化次数。这仅包括 includeInConversionsMetric 属性设置为 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

展示后，在任何位置平台上的网站网址获得的点击次数。此衡量指标来自基于资产的位置。
orders

number

“订单数”是指广告为您带来的购买转化总数。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果某次转化是由于用户之前与您广告的互动（点击文字广告或购物广告、观看视频广告等）带来的，系统会将其计为一笔订单。示例：某用户点击了宣传一款帽子的购物广告，然后在您的网站上下单购买了该帽子和一件衬衫。虽然该用户购买了 2 件商品，但仍会计为 1 笔订单。此指标仅在您报告了含购物车数据的转化的情况下可用。
averageOrderValueMicros

string (int64 format)

“平均订单价值”是指广告促成的每笔订单带来的平均收入。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。系统会用订单带来的总收入除以订单总数，计算出平均订单价值。示例：您收到了 3 笔订单，它们分别带来了 10 美元、15 美元和 20 美元的收入。平均订单价值为 15 美元，计算方法为：（10 美元 + 15 美元 + 20 美元）/3。此指标仅在您报告了含购物车数据的转化的情况下可用。
averageCartSize

number

“平均购物车内商品数量”是指广告带来的每个订单的平均商品数量。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。系统会用所售商品总数除以您获得的订单总数，计算出平均购物车内商品数量。示例：您获得了 2 个订单，第一个订单包含 3 件商品，第二个订单包含 2 件商品。平均购物车内商品数量即为 2.5 件商品，计算方法为：(3+2)/2。此指标仅在您报告了含购物车数据的转化的情况下可用。
costOfGoodsSoldMicros

string (int64 format)

“销货成本”(COGS) 是指广告促成的订单中所售产品的总成本。运作方式：您可以在 Merchant Center 中为每个产品添加销货成本价值。如果您报告含购物车数据的转化，系统会将所售产品与其销货成本价值进行匹配，并可据此计算每笔订单的毛利润。示例：某个用户点击了宣传帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。那么，这笔订单的销货成本就是：8 美元 = 3 美元 + 5 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。
grossProfitMicros

string (int64 format)

毛利润是指扣除销货成本 (COGS) 后，归因于广告的订单所产生的利润。运作方式：毛利润是指扣除销货成本后，归因于广告的销售所带来的收益。在计算毛利润时，只会涵盖在 Merchant Center 中具有销货成本值的产品。示例：某个用户点击了宣传帽子的购物广告，然后在您的网站上下单购买了同款帽子和一件衬衫。帽子的价格为 10 美元，衬衫的价格为 20 美元。帽子的销货成本值为 3 美元，但衬衫没有销货成本值。在计算此订单的毛利润时，仅会考虑帽子，因此毛利润为 7 美元（10 美元 - 3 美元）。此指标仅在您报告了含购物车数据的转化的情况下可用。
grossProfitMargin

number

“毛利润率”是指在扣除销货成本 (COGS) 后，广告促成的订单带来的毛利润所占的百分比。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。毛利润率是指用所得毛利润除以总收入，然后再乘 100%，计算得出的值。计算毛利润率时，只会纳入 Merchant Center 中具有销货成本价值的产品。示例：客户在您的网站上下单购买了帽子和衬衫。帽子的价格为 10 美元，其销货成本价值为 3 美元。衬衫的价格为 20 美元，但没有销货成本价值。这笔订单中只有帽子有销货成本价值，因此计算毛利润率时只会将帽子考虑在内，也就是 70% =（10 美元 - 3 美元）/10 美元 x 100%。此指标仅在您报告了含购物车数据的转化的情况下可用。
revenueMicros

string (int64 format)

“收入”是指您从广告促成的订单中赚到的总金额。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。广告促成的所有订单的总价值减去所有折扣即为收入。示例：某个用户点击了宣传帽子的购物广告，然后在您的网站上下单购买了同款帽子和一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。整个订单有 5 美元的折扣。那么，这笔订单的收入就是：25 美元 =（10 美元 + 20 美元）- 5 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。
unitsSold

number

“售出数量”是指广告促成的订单中的售出产品的总数。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。“售出数量”是指广告促成的所有订单中的售出产品的总数。示例：某个用户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，售出数量为 3。此指标仅在您报告了含购物车数据的转化的情况下可用。
crossSellCostOfGoodsSoldMicros

string (int64 format)

“作为交叉销售产品时的销货成本”(COGS) 是指通过对其他产品进行广告宣传而售出产品产生的总成本。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见“购物广告”），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的销货成本是指未宣传的售出产品的总成本。示例：某个用户点击了宣传帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。此订单的作为交叉销售产品时的销货成本为 5 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。
crossSellGrossProfitMicros

string (int64 format)

“作为交叉销售产品时的毛利润”是指在减去销货成本 (COGS) 后，因广告宣传某产品而售出的其他产品给您带来的利润。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见“购物广告”），此产品会被视为广告宣传的产品。购买交易中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的毛利润就是广告促成的交叉销售所产生的收入减去销货成本。示例：某个用户点击了宣传帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。衬衫的价格为 20 美元，其销货成本价值为 5 美元。在这笔订单中，作为交叉销售产品时的毛利润就是：15 美元 = 20 美元 - 5 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。
crossSellRevenueMicros

string (int64 format)

“作为交叉销售产品时的收入”是指因广告宣传某产品而售出的其他产品给您带来的收入总金额。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见“购物广告”），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。“作为交叉销售产品时的收入”就是广告促成的交叉销售所产生的总价值。示例：某个用户点击了宣传帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。在这笔订单中，作为交叉销售产品时的收入为 20 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。
crossSellUnitsSold

number

“作为交叉销售产品时的销量”是指因广告宣传某产品而售出的其他产品的总数。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见“购物广告”），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。“作为交叉销售产品时的销量”是指广告促成的所有订单中的交叉售出产品的总数。示例：某个用户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，作为交叉销售产品时的销量为 2。此指标仅在您报告了含购物车数据的转化的情况下可用。
leadCostOfGoodsSoldMicros

string (int64 format)

“作为主推产品时的销货成本”(COGS) 是指因广告宣传某产品而售出的同一产品的总成本。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些货品的成本会计入“作为主推产品时的销货成本”。示例：某个用户点击了宣传帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。在这笔订单中，作为主推产品时的销货成本为 3 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。
leadGrossProfitMicros

string (int64 format)

“作为主推产品时的毛利润”是指在减去销货成本 (COGS) 后，因广告宣传某产品而售出的同一产品给您带来的利润。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见“购物广告”），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些销售所产生的收入减去销货成本就是作为主推产品时的毛利润。示例：某个用户点击了宣传帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的价格为 10 美元，其销货成本价值为 3 美元。在这笔订单中，作为主推产品时的毛利润就是：7 美元 = 10 美元 - 3 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。
leadRevenueMicros

string (int64 format)

“作为主推产品时的收入”是指因广告宣传某产品而售出的同一产品给您带来的收入总金额。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见“购物广告”），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么您因销售这些产品所得收入的总价值会计入“作为主推产品时的收入”。示例：某个用户点击了宣传帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。在这笔订单中，作为主推产品时的收入为 10 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。
leadUnitsSold

number

“作为主推产品时的销量”是指因广告宣传某产品而售出的同一产品的总数。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见“购物广告”），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些售出产品的总数会计入“作为主推产品时的销量”。示例：某个用户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，作为主推产品时的销量为 1。此指标仅在您报告了含购物车数据的转化的情况下可用。
uniqueUsers

string (int64 format)

在所请求的时间段内，看到您广告的唯一身份用户数量。此指标无法进行汇总，只能针对 92 天以内的日期范围进行请求。此指标适用于以下广告系列类型：展示广告系列、视频广告系列、发现广告系列和应用广告系列。
averageImpressionFrequencyPerUser

number

在所请求的时间段内，唯一身份用户看到您广告的平均次数。此指标无法进行汇总，只能针对 92 天以内的日期范围进行请求。此指标适用于以下广告系列类型：展示广告系列、视频广告系列、发现广告系列和应用广告系列。
linkedEntitiesCount

string (int64 format)

使用相应素材资源的已关联资源的数量。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。
assetPinnedTotalCount

string (int64 format)

相应素材资源被固定的总使用次数。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。此指标仅在搜索渠道中受支持。
assetPinnedAsHeadlinePositionOneCount

string (int64 format)

素材资源固定到标题 1 的实体数量。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。此指标仅在搜索渠道中受支持。
assetPinnedAsHeadlinePositionTwoCount

string (int64 format)

素材资源固定到标题 2 的实体数量。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。此指标仅在搜索渠道中受支持。
assetPinnedAsHeadlinePositionThreeCount

string (int64 format)

素材资源固定到标题 3 的实体数量。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。此指标仅在搜索渠道中受支持。
assetPinnedAsDescriptionPositionOneCount

string (int64 format)

将相应素材资源固定到说明 1 的实体数量。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。此指标仅在搜索渠道中受支持。
assetPinnedAsDescriptionPositionTwoCount

string (int64 format)

将相应素材资源固定到说明 2 的实体数量。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。此指标仅在搜索渠道中受支持。
assetBestPerformanceImpressionPercentage

number

素材资源在 AssetPerformanceLabel 为 BEST 的广告中获得的展示次数所占的百分比。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。此指标仅在搜索渠道中受支持。
assetGoodPerformanceImpressionPercentage

number

素材资源在 AssetPerformanceLabel 为 GOOD 的广告中获得的展示次数所占的百分比。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。此指标仅在搜索渠道中受支持。
assetLowPerformanceImpressionPercentage

number

素材资源在 AssetPerformanceLabel 为 LOW 的广告中获得的展示次数所占的百分比。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。此指标仅在搜索渠道中受支持。
assetLearningPerformanceImpressionPercentage

number

素材资源在 AssetPerformanceLabel 为 LEARNING 的广告中获得的展示次数所占的百分比。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。此指标仅在搜索渠道中受支持。
assetUnratedPerformanceImpressionPercentage

number

素材资源在 AssetPerformanceLabel 不是 BEST、GOOD、LOW 和 LEARNING 的广告中所获得的展示次数百分比。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。此指标仅在搜索渠道中受支持。
assetBestPerformanceCostPercentage

number

素材资源在具有 AssetPerformanceLabel.BEST 的广告中所获得的费用百分比。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。此指标仅在效果最大化广告系列渠道中受支持。
assetGoodPerformanceCostPercentage

number

素材资源在具有 AssetPerformanceLabel.GOOD 的广告中所占的费用百分比。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。此指标仅在效果最大化广告系列渠道中受支持。
assetLowPerformanceCostPercentage

number

素材资源在具有 AssetPerformanceLabel.LOW 的广告中所占的费用百分比。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。此指标仅在效果最大化广告系列渠道中受支持。
assetLearningPerformanceCostPercentage

number

在具有 AssetPerformanceLabel.LEARNING 的广告中，相应素材资源获得的费用百分比。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。此指标仅在效果最大化广告系列渠道中受支持。
assetUnratedPerformanceCostPercentage

number

素材资源在 AssetPerformanceLabel 不是 BEST、GOOD、LOW 和 LEARNING 的广告中所占的费用百分比。此指标只能与 ChannelAggregateAssetView 和 CampaignAggregateAssetView 一起选择。此指标仅在效果最大化广告系列渠道中受支持。
storeVisitsLastClickModelAttributedConversions

number

使用“最终点击”模型归因的实体店光顾次数。
resultsConversionsPurchase

number

统一目标结果的购买转化统计信息。
videoViewRateInFeed

number

视频观看次数除以可能促成视频观看的信息流格式的展示次数。
videoViewRateInStream

number

视频观看次数除以可能促成视频观看的插播广告格式的展示次数。
videoViewRateShorts

number

视频观看次数除以可能促成 Shorts 格式视频观看次数的展示次数。
coviewedImpressions

string (int64 format)

所有同看的展示次数表示看过您广告的总人数。其中包括已登录 Google 账号的用户，以及在联网电视上观看同一广告的其他用户。此指标仅适用于具有 adjustedAgeRange 和 adjustedGender 段的广告系列资源。若要获取所有共同观看的展示次数，必须进行这些细分。
primaryImpressions

string (int64 format)

每当您的广告投放时，就计为一次主要展示。此指标仅适用于具有 adjustedAgeRange 和 adjustedGender 段的广告系列资源。这些细分是获取主要展示次数的必要条件。

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),
  "adFormatType": enum (AdFormatType),
  "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),
  "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),
  "skAdNetworkCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "skAdNetworkSourceType": enum (SkAdNetworkSourceType),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "adjustedAgeRange": enum (AgeRangeType),
  "adjustedGender": enum (GenderType),
  "activityAccountId": string,
  "activityCity": string,
  "activityCountry": string,
  "activityRating": string,
  "activityState": 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,
  "productCategoryLevel1": string,
  "productCategoryLevel2": string,
  "productCategoryLevel3": string,
  "productCategoryLevel4": string,
  "productCategoryLevel5": 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,
  "travelDestinationCity": string,
  "travelDestinationCountry": string,
  "travelDestinationRegion": string,
  "searchSubcategory": string,
  "searchTerm": string,
  "webpage": string,
  "week": string,
  "year": integer,
  "skAdNetworkFineConversionValue": string,
  "skAdNetworkRedistributedFineConversionValue": string,
  "skAdNetworkSourceApp": {
    object (SkAdNetworkSourceApp)
  },
  "skAdNetworkSourceDomain": string,
  "skAdNetworkPostbackSequenceIndex": string,
  "skAdNetworkVersion": string,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
字段
adDestinationType

enum (AdDestinationType)

广告目标类型。
adFormatType

enum (AdFormatType)

广告格式类型。
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 月。
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 显示的是未应用价值规则的转化的总记录价值。“原始”显示的是应用了价值规则的转化的原始价值。GEO_LOCATION、DEVICE、AUDIENCE、ITINERARY 显示的是应用价值规则后的净调整值。
skAdNetworkUserType

enum (SkAdNetworkUserType)

iOS Store Kit 广告网络用户类型。
skAdNetworkAdEventType

enum (SkAdNetworkAdEventType)

iOS Store Kit 广告网络的广告事件类型。
skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

iOS Store Kit 广告联盟归因信用
skAdNetworkCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

iOS Store Kit 广告网络的粗略转化价值。
skAdNetworkSourceType

enum (SkAdNetworkSourceType)

促成 iOS Store Kit Ad Network 安装的广告的展示来源类型。Null 值表示相应细分不适用，例如非 iOS 广告系列，或者 Apple 发送的任何回发中均未包含来源网域或来源应用。
newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

用于按用户是新客户还是回头客来细分转化。此细分通常用于衡量客户获取目标的效果。
adjustedAgeRange

enum (AgeRangeType)

调整后的年龄段。这是应用模型后获得的用户年龄段，可提供更准确的年龄和性别信息。目前，您需要同时选择 adjustedAgeRange 和 adjustedGender，才能获得有效的覆盖面统计信息。这些细分仅适用于许可名单上的客户。
adjustedGender

enum (GenderType)

调整了性别。这是应用模型后获得的用户性别，可提供更准确的年龄和性别信息。目前，您需要同时选择 adjustedAgeRange 和 adjustedGender，才能获得有效的覆盖面统计信息。这些细分仅适用于许可名单上的客户。
activityAccountId

string (int64 format)

活动账号 ID。
activityCity

string

旅游活动所在的城市。
activityCountry

string

旅行活动可用的国家/地区。
activityRating

string (int64 format)

活动评分。
activityState

string

相应旅游活动可供预订的州。
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。
productCategoryLevel1

string

商品的类别（第 1 级）。
productCategoryLevel2

string

商品的类别（第 2 级）。
productCategoryLevel3

string

商品的类别（第 3 级）。
productCategoryLevel4

string

商品的类别（第 4 级）。
productCategoryLevel5

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 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。
travelDestinationCity

string

用户在查询时搜索的城市。
travelDestinationCountry

string

用户在查询时搜索的国家/地区。
travelDestinationRegion

string

用户在查询时搜索的地区。
searchSubcategory

string

搜索字词子类别。空字符串表示未归入其他子类别的搜索字词的包罗万象的子类别。
searchTerm

string

搜索字词。
webpage

string

表示网页条件的广告组条件的资源名称。
week

string

定义为星期一到星期日的一周，由星期一的日期表示。格式为 yyyy-MM-dd。
year

integer

年份，格式为 yyyy。
skAdNetworkFineConversionValue

string (int64 format)

iOS Store Kit 广告资源网转化价值。Null 值表示相应细分不适用，例如非 iOS 广告系列。
skAdNetworkRedistributedFineConversionValue

string (int64 format)

iOS Store Kit Ad Network 重新分配的精细转化价值。

Google 会根据观测到的转化价值（从 Apple 获取）进行估算，以计算从返回 NULL 的 SKAN 回传中获得的转化。此列表示根据模型估算的转化价值与观测到的转化价值之和。如需了解详情，请参阅 https://support.google.com/google-ads/answer/14892597。
skAdNetworkSourceApp

object (SkAdNetworkSourceApp)

促成 iOS Store Kit Ad Network 安装的广告所展示的应用。Null 值表示相应细分不适用（例如，非 iOS 广告系列），或者未出现在 Apple 发送的任何回发中。
skAdNetworkSourceDomain

string

促成 iOS Store Kit Ad Network 安装的广告所展示的网站。Null 值表示相应细分不适用（例如，非 iOS 广告系列），或者未出现在 Apple 发送的任何回发中。
skAdNetworkPostbackSequenceIndex

string (int64 format)

iOS Store Kit 广告网络回传顺序索引。
skAdNetworkVersion

string

所用 SKAdNetwork API 的版本。
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 转化广告的目标网址（密钥未知）

AdFormatType

列举了 Google Ads 格式类型。

请注意，此细分仅适用于视频广告系列和需求开发广告系列。对于素材资源，仅支持视频素材资源。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
OTHER

分配给不支持在视频广告系列和需求开发广告系列中进行格式细分的格式（例如实验性格式）的值。

请注意，这些格式日后可能会更改类别，例如，如果公开了实验性格式或添加了新格式。我们强烈建议您不要依赖此字段来做出长期决策。
UNSEGMENTED

为 TrueView 行动号召视频广告系列统计信息分配的值。

请注意，具有此值的统计信息日后可能会更改类别，例如，如果为新的广告系列类型添加了广告格式细分支持，则可能会发生这种情况。我们强烈建议您不要依赖此字段来做出长期决策。
INSTREAM_SKIPPABLE 可跳过的插播广告。
INSTREAM_NON_SKIPPABLE 不可跳过的插播广告。
INFEED 在信息流平台（例如 Google 探索信息流、YouTube 首页等）上投放的信息流 YouTube 广告或图片广告。
BUMPER 短（<7 秒）不可跳过的 YouTube 插播广告。
OUTSTREAM 外播广告。
MASTHEAD 标头广告。
AUDIO 音频广告。
SHORTS 在 YouTube Shorts 上投放的竖屏全屏视频广告或图片广告，或者以 YouTube Shorts 自然广告形式投放的 BrandConnect 广告。

AdNetworkType

列举 Google Ads 网络类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
SEARCH Google 搜索。
SEARCH_PARTNERS 搜索网络合作伙伴。
CONTENT 展示广告网络。
MIXED 跨广告网络。
YOUTUBE YouTube
GOOGLE_TV Google TV
GOOGLE_OWNED_CHANNELS Google 自有渠道，例如 Google 探索信息流、Gmail、YouTube。此广告资源网络仅供需求开发广告系列使用。

BudgetCampaignAssociationStatus

BudgetCampaignAssociationStatus 段。

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 跨广告网络。通过效果最大化广告系列和发现广告系列。
AD_IMAGE 广告图片。
TRAVEL_ASSETS 旅游 Feed 素材资源。

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 转化延迟时间分桶 UNKNOWN。这是指 Google Ads 中提供“转化延迟时间段”之前的日期。
ADJUSTMENT_UNKNOWN 转化调整延迟时间段 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 专门针对 Search Ads 360 的 Google Analytics 转化。在 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 应用多条规则时。
ITINERARY 当满足查询时行程条件时。

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 版本无法返回真实的枚举值，或者尚不支持该值。
UNAVAILABLE 回发中未提供相应值，或者我们因其他原因而没有相应数据。
WON Google 是赢得广告归因的广告联盟。
CONTRIBUTED Google 符合归因条件，但未赢得归因。

SkAdNetworkSourceType

枚举 SkAdNetwork 来源类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
UNAVAILABLE 回发中未提供来源应用 ID 或来源网域，或者我们因其他原因而没有此数据。
WEBSITE 广告在网页上展示。
MOBILE_APPLICATION 广告在应用中展示。

AssetInteractionTarget

AssetInteractionTarget 段。

JSON 表示法 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
字段
asset

string

资源名称。
interactionOnThisAsset

boolean

仅与 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标搭配使用。指明互动指标是针对素材资源本身还是针对其他素材资源或广告单元。

ConvertingUserPriorEngagementTypeAndLtvBucket

枚举转化用户的先验互动类型和生命周期价值分桶

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
NEW 转化用户是广告客户的新客户。
RETURNING 转化用户返回到广告客户的网站。不同转化类型（例如第二次实体店光顾与第二次在线购买）的回头客定义有所不同。
NEW_AND_HIGH_LTV 转化用户是广告客户的新客户，且具有较高的生命周期价值。