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)
  },
  "adGroupExtensionSetting": {
    object (AdGroupExtensionSetting)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "adGroupSimulation": {
    object (AdGroupSimulation)
  },
  "adParameter": {
    object (AdParameter)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "adScheduleView": {
    object (AdScheduleView)
  },
  "domainCategory": {
    object (DomainCategory)
  },
  "asset": {
    object (Asset)
  },
  "assetFieldTypeView": {
    object (AssetFieldTypeView)
  },
  "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)
  },
  "campaignExtensionSetting": {
    object (CampaignExtensionSetting)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "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)
  },
  "customerExtensionSetting": {
    object (CustomerExtensionSetting)
  },
  "customerFeed": {
    object (CustomerFeed)
  },
  "customerLabel": {
    object (CustomerLabel)
  },
  "customerLifecycleGoal": {
    object (CustomerLifecycleGoal)
  },
  "customerNegativeCriterion": {
    object (CustomerNegativeCriterion)
  },
  "customerSearchTermInsight": {
    object (CustomerSearchTermInsight)
  },
  "customerUserAccess": {
    object (CustomerUserAccess)
  },
  "customerUserAccessInvitation": {
    object (CustomerUserAccessInvitation)
  },
  "customizerAttribute": {
    object (CustomizerAttribute)
  },
  "detailPlacementView": {
    object (DetailPlacementView)
  },
  "detailedDemographic": {
    object (DetailedDemographic)
  },
  "displayKeywordView": {
    object (DisplayKeywordView)
  },
  "distanceView": {
    object (DistanceView)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "expandedLandingPageView": {
    object (ExpandedLandingPageView)
  },
  "extensionFeedItem": {
    object (ExtensionFeedItem)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "feedItemSet": {
    object (FeedItemSet)
  },
  "feedItemSetLink": {
    object (FeedItemSetLink)
  },
  "feedItemTarget": {
    object (FeedItemTarget)
  },
  "feedMapping": {
    object (FeedMapping)
  },
  "feedPlaceholderView": {
    object (FeedPlaceholderView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geographicView": {
    object (GeographicView)
  },
  "groupPlacementView": {
    object (GroupPlacementView)
  },
  "hotelGroupView": {
    object (HotelGroupView)
  },
  "hotelPerformanceView": {
    object (HotelPerformanceView)
  },
  "hotelReconciliation": {
    object (HotelReconciliation)
  },
  "incomeRangeView": {
    object (IncomeRangeView)
  },
  "keywordView": {
    object (KeywordView)
  },
  "keywordPlan": {
    object (KeywordPlan)
  },
  "keywordPlanCampaign": {
    object (KeywordPlanCampaign)
  },
  "keywordPlanCampaignKeyword": {
    object (KeywordPlanCampaignKeyword)
  },
  "keywordPlanAdGroup": {
    object (KeywordPlanAdGroup)
  },
  "keywordPlanAdGroupKeyword": {
    object (KeywordPlanAdGroupKeyword)
  },
  "keywordThemeConstant": {
    object (KeywordThemeConstant)
  },
  "label": {
    object (Label)
  },
  "landingPageView": {
    object (LandingPageView)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "managedPlacementView": {
    object (ManagedPlacementView)
  },
  "mediaFile": {
    object (MediaFile)
  },
  "localServicesEmployee": {
    object (LocalServicesEmployee)
  },
  "localServicesVerificationArtifact": {
    object (LocalServicesVerificationArtifact)
  },
  "mobileAppCategoryConstant": {
    object (MobileAppCategoryConstant)
  },
  "mobileDeviceConstant": {
    object (MobileDeviceConstant)
  },
  "offlineConversionUploadClientSummary": {
    object (OfflineConversionUploadClientSummary)
  },
  "offlineUserDataJob": {
    object (OfflineUserDataJob)
  },
  "operatingSystemVersionConstant": {
    object (OperatingSystemVersionConstant)
  },
  "paidOrganicSearchTermView": {
    object (PaidOrganicSearchTermView)
  },
  "qualifyingQuestion": {
    object (QualifyingQuestion)
  },
  "parentalStatusView": {
    object (ParentalStatusView)
  },
  "perStoreView": {
    object (PerStoreView)
  },
  "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)

查询中引用的广告组定制工具。
adGroupExtensionSetting

object (AdGroupExtensionSetting)

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

object (AdGroupFeed)

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

object (AdGroupLabel)

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

object (AdGroupSimulation)

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

object (AdParameter)

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

object (AgeRangeView)

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

object (AdScheduleView)

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

object (DomainCategory)

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

object (Asset)

查询中引用的资产。
assetFieldTypeView

object (AssetFieldTypeView)

查询中引用的素材资源字段类型视图。
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)

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

object (CampaignExtensionSetting)

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

object (CampaignFeed)

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

查询中引用的 CombinedAudience。
audience

object (Audience)

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

object (ConversionAction)

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

object (ConversionCustomVariable)

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

object (ConversionGoalCampaignConfig)

查询中引用的 ConversionGoalCampaignConfig。
conversionValueRule

object (ConversionValueRule)

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

object (ConversionValueRuleSet)

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

object (ClickView)

查询中引用的 ClickView。
currencyConstant

object (CurrencyConstant)

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

object (CustomAudience)

查询中引用的 CustomAudience。
customConversionGoal

object (CustomConversionGoal)

查询中引用的 CustomConversionGoal。
customInterest

object (CustomInterest)

查询中引用的 CustomInterest。
customer

object (Customer)

查询中提及的客户。
customerAsset

object (CustomerAsset)

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

object (CustomerAssetSet)

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

object (AccessibleBiddingStrategy)

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

object (CustomerCustomizer)

查询中引用的客户定制工具。
customerClient

object (CustomerClient)

查询中引用的 CustomerClient。
customerConversionGoal

object (CustomerConversionGoal)

查询中引用的 CustomerConversionGoal。
customerExtensionSetting

object (CustomerExtensionSetting)

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

object (CustomerFeed)

查询中引用的客户 Feed。
customerLabel

object (CustomerLabel)

查询中引用的客户标签。
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)

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

object (ExtensionFeedItem)

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

object (Feed)

查询中引用的 Feed。
feedItem

object (FeedItem)

查询中引用的 Feed 项。
feedItemSet

object (FeedItemSet)

查询中引用的 Feed 项集。
feedItemTarget

object (FeedItemTarget)

查询中引用的 Feed 项定位条件。
feedMapping

object (FeedMapping)

查询中引用的 Feed 映射。
feedPlaceholderView

object (FeedPlaceholderView)

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

object (GenderView)

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

object (GeoTargetConstant)

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

object (GeographicView)

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

object (GroupPlacementView)

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

object (HotelGroupView)

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

object (HotelPerformanceView)

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

object (HotelReconciliation)

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

object (IncomeRangeView)

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

object (KeywordView)

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

object (KeywordPlan)

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

object (KeywordPlanCampaign)

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

object (KeywordPlanCampaignKeyword)

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

object (KeywordPlanAdGroup)

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

object (KeywordPlanAdGroupKeyword)

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

object (KeywordThemeConstant)

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

object (Label)

查询中引用的标签。
landingPageView

object (LandingPageView)

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

object (LanguageConstant)

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

object (LocationView)

查询中引用的位置视图。
managedPlacementView

object (ManagedPlacementView)

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

object (MediaFile)

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

object (LocalServicesEmployee)

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

object (LocalServicesVerificationArtifact)

查询中引用的本地服务验证工件。
mobileAppCategoryConstant

object (MobileAppCategoryConstant)

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

object (MobileDeviceConstant)

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

object (OfflineConversionUploadClientSummary)

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

object (OfflineUserDataJob)

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

object (OperatingSystemVersionConstant)

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

object (PaidOrganicSearchTermView)

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

object (QualifyingQuestion)

查询中提及的甄别问题。
parentalStatusView

object (ParentalStatusView)

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

object (PerStoreView)

查询中引用的实体店视图。
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”中找到。有关预算的有效详细信息可在前缀为“已批准”“调整”和没有前缀的字段中找到。由于某些有效详细信息可能与用户最初请求的内容不同（例如支出限额），因此这些差异并排显示在“proposed_”、“Approved_”和“adjusted_”字段中，还可能包含“adjusted_”字段。

该资源已使用 AccountBudgetProposal 进行变更，因此无法直接修改。在任意给定时间，一项预算最多只能有一个待处理的提案。将通过 pendingProposal 进行读取。

获得批准后，预算可能需要进行调整（例如贷记调整）。调整会导致“已批准”和“调整后”字段之间存在差异，而这两个字段在其他方面是相同的。

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

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

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

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

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

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

string

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

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

enum (AccountBudgetStatus)

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

string (int64 format)

仅限输出。总调整金额。

礼节性赠送金额的一个例子就是调整项。
amountServedMicros

string (int64 format)

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

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

object (PendingAccountBudgetProposal)

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

string (int64 format)

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

string

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

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

string

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

string

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

string

仅限输出。账号级预算的已批准开始时间，格式为 yyyy-MM-dd HH:mm:ss。

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

string

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

string

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

string

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

enum (TimeType)

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

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

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

string

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

enum (TimeType)

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

string (int64 format)

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

enum (SpendingLimitType)

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

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

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

string (int64 format)

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

enum (SpendingLimitType)

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

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

此值是账号支出金额的最终决定性因素。adjusted_spending_limit 只能是下列其中一项：
adjustedSpendingLimitMicros

string (int64 format)

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

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

要了解不同类型的调整项，请访问：https://support.google.com/google-ads/answer/1704323

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

enum (SpendingLimitType)

仅限输出。经过调整的支出限额，采用明确定义的类型，例如 INFINITE。仅当调整后的支出限额为 INFINITE（如果已批准的支出限额为 INFINITE）时，系统才会填充此字段。

AccountBudgetStatus

AccountBudget 的可能状态。

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

PendingAccountBudgetProposal

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

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

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

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

enum (AccountBudgetProposalType)

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

string

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

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

string

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

string

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

string

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

string

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

string

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

string

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

enum (TimeType)

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

string (int64 format)

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

enum (SpendingLimitType)

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

AdGroupAdAssetCombinationView

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

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

string

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

object (AssetUsage)

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

boolean

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

AssetUsage

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

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

string

资产的资源名称。
servedAssetFieldType

enum (ServedAssetFieldType)

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

AdGroupAdAssetView

AdGroupAd 与素材资源之间的关联。目前，对于应用广告系列和自适应搜索广告，我们仅支持 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

广告组条件模拟。下面分别详细介绍了支持的广告渠道类型、条件类型、模拟类型和模拟修改方法组合。Hotel AdGroupCriterion 模拟操作从 V5 开始。

  1. 展示 - 关键字 - CPC_BID - 统一
  2. 搜索 - 关键字 - CPC_BID - UNIFORM
  3. 购物 - LISTING_GROUP - CPC_BID - 统一
  4. 酒店 - LISTING_GROUP - CPC_BID - 统一
  5. 酒店 - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
JSON 表示法 
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "criterionId": string,
  "startDate": string,
  "endDate": string,

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

string

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

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

enum (SimulationType)

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

enum (SimulationModificationMethod)

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

string (int64 format)

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

string (int64 format)

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

string

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

string

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

object (CpcBidSimulationPointList)

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

object (PercentCpcBidSimulationPointList)

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

SimulationType

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

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

SimulationModificationMethod

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

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
UNIFORM 模拟中的值将值统一应用于给定资源的所有子项。未遵循对子资源的替换。
DEFAULT 模拟中的值应用于指定资源。系统考虑了对子资源的替换，因此流量估算值未纳入这些资源。
SCALING 模拟中的值均按相同系数进行了调整。例如，在模拟的 TargetCpa 广告系列中，广告系列目标和所有广告组目标都按 X 系数进行了调整。

CpcBidSimulationPointList

CPC_BID 类型的模拟的模拟点容器。

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

object (CpcBidSimulationPoint)

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

CpcBidSimulationPoint

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

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

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

string (int64 format)

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

number

预计可出价转化次数。
biddableConversionsValue

number

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

string (int64 format)

预计点击次数。
costMicros

string (int64 format)

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

string (int64 format)

预计展示次数。
topSlotImpressions

string (int64 format)

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

string (int64 format)

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

number

预测指标所依据的模拟缩放调节系数。与所模拟的实体相关的所有每次点击费用出价均按此系数调整。

PercentCpcBidSimulationPointList

PERCENT_CPC_BID 类型的模拟的模拟点容器。

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

object (PercentCpcBidSimulationPoint)

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

PercentCpcBidSimulationPoint

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

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

string (int64 format)

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

number

预计可出价转化次数。
biddableConversionsValue

number

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

string (int64 format)

预计点击次数。
costMicros

string (int64 format)

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

string (int64 format)

预计展示次数。
topSlotImpressions

string (int64 format)

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

AdGroupSimulation

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

  1. 搜索 - CPC_BID - 默认
  2. 搜索 - CPC_BID - UNIFORM
  3. 搜索广告 - 目标每次转化费用 - 统一
  4. 搜索广告系列 - 目标广告支出回报率 - 统一
  5. 展示 - CPC_BID - 默认
  6. 展示 - CPC_BID - 统一
  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

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

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

string

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

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

DomainCategory

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

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

string

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

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

string

仅限输出。建议为哪个广告系列添加此类别。
category

string

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

string

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

string

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

number

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

string (int64 format)

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

boolean

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

string (int64 format)

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

AssetFieldTypeView

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

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

string

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

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

enum (AssetFieldType)

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

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/{asset_group_id}~{listing_group_filter_id}
assetGroup

string

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

string

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

AssetGroupTopCombinationView

广告组广告素材资源组合使用情况的视图。

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

string

仅限输出。素材资源组顶级组合视图的资源名称。素材资源组热门组合视图资源名称采用以下格式："customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{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. 目标每次转化费用 - 统一
  2. 目标广告支出回报率 - 统一
JSON 表示法 
{
  "resourceName": string,
  "biddingStrategyId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

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

string

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

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

string (int64 format)

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

enum (SimulationType)

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

enum (SimulationModificationMethod)

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

string

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

string

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

object (TargetCpaSimulationPointList)

仅限输出。如果模拟类型为 TARGET_CPA，则模拟点。
targetRoasPointList

object (TargetRoasSimulationPointList)

仅限输出。如果模拟类型为 TARGET_ROAS，则模拟得分。

CallView

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

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

string

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

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

string

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

string

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

string (int64 format)

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

string

仅限输出。广告客户提供的通话开始日期和时间。
endCallDateTime

string

仅限输出。广告客户提供的通话结束日期时间。
callTrackingDisplayLocation

enum (CallTrackingDisplayLocation)

仅限输出。通话跟踪显示位置。
type

enum (CallType)

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

enum (GoogleVoiceCallStatus)

仅限输出。通话的状态。

CallTrackingDisplayLocation

可能的来电跟踪展示广告位置。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
AD 通过广告拨打的电话。
LANDING_PAGE 从着陆页广告拨打的电话所指向的号码。

CallType

可能从中进行调用的属性类型。

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

GoogleVoiceCallStatus

Google 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 - 扩展
  • 搜索广告 - 目标每次转化费用 - 统一
  • 搜索广告系列 - 目标每次转化费用 - 扩展
  • 搜索广告系列 - 目标广告支出回报率 - 统一
  • 搜索 - 目标展示次数份额 - 统一
  • 搜索广告系列 - 预算 - 统一
  • 购物广告系列 - 预算 - 统一
  • 购物 - 目标广告支出回报率 - 统一
  • 多渠道 - 目标每次转化费用 - 统一
  • 多渠道 - 目标广告支出回报率 - 统一
  • 发现广告系列 - 目标每次转化费用 - 默认
  • 展示广告 - 目标每次转化费用 - 统一
  • 效果最大化 - 目标每次转化费用 - 统一
  • 效果最大化 - 目标广告支出回报率 - 统一
  • PERFORMANCE_MAX - 预算 - 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)

仅限输出。如果模拟类型为 BUDGET，则模拟得分。

TargetImpressionShareSimulationPointList

TARGET_IMPRESSION_SHARE 类型的模拟的模拟点容器。

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

object (TargetImpressionShareSimulationPoint)

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

TargetImpressionShareSimulationPoint

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

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

number

预计可出价转化次数。
biddableConversionsValue

number

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

string (int64 format)

预计点击次数。
costMicros

string (int64 format)

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

string (int64 format)

预计展示次数。
topSlotImpressions

string (int64 format)

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

string (int64 format)

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

BudgetSimulationPointList

预算类型模拟的模拟点容器。

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

string

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

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

string

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

enum (ChangeEventResourceType)

仅限输出。发生更改的资源的类型。该参数指示要在 oldResource 和 newResource 中设置哪些资源。
changeResourceName

string

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

enum (ChangeClientType)

仅限输出。完成更改的地方。
userEmail

string

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

object (ChangedResource)

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

object (ChangedResource)

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

enum (ResourceChangeOperation)

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

string (FieldMask format)

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

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

string

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

string

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

string

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

string

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

string

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

ChangeEventResourceType

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

枚举
UNSPECIFIED 未指定值。
UNKNOWN 仅用于返回值。表示此版本中未知的未分类资源。
AD Ad 资源发生变化。
AD_GROUP 更改广告组资源。
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 广告组 Feed 资源更改。
AD_GROUP_AD 更改了 AdGroupAd 资源。
ASSET 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 发布所做的更改。
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)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "asset": {
    object (Asset)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  }
}
字段
ad

object (Ad)

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

object (AdGroup)

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

object (AdGroupCriterion)

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

object (Campaign)

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

object (CampaignBudget)

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

object (AdGroupBidModifier)

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

object (CampaignCriterion)

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

object (Feed)

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

object (FeedItem)

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

object (CampaignFeed)

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

object (AdGroupFeed)

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

object (AdGroupAd)

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

object (Asset)

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

object (CustomerAsset)

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

object (CampaignAsset)

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

object (AdGroupAsset)

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

object (AssetSet)

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

object (AssetSetAsset)

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

object (CampaignAssetSet)

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

ResourceChangeOperation

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

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

ChangeStatus

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

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

string

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

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

enum (ChangeStatusResourceType)

仅限输出。表示已更改资源的类型。该参数指示将设置哪些字段。例如，对于 AD_GROUP，系统会设置 campaign 和 adGroup 字段。
resourceStatus

enum (ChangeStatusOperation)

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

ChangeStatusResourceType

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

枚举
UNSPECIFIED 未指定值。
UNKNOWN 仅用于返回值。表示此版本中未知的未分类资源。
AD_GROUP 更改广告组资源。
AD_GROUP_AD 更改了 AdGroupAd 资源。
AD_GROUP_CRITERION 调整 AdGroupCriterion 资源。
CAMPAIGN 广告系列资源更改。
CAMPAIGN_CRITERION 一项 CampaignCriterion 资源更改。
FEED Feed 资源更改。
FEED_ITEM FeedItem 资源更改。
AD_GROUP_FEED 广告组 Feed 资源更改。
CAMPAIGN_FEED CampaignFeed 资源更改。
AD_GROUP_BID_MODIFIER 更改了 AdGroupBidModifier 资源。
SHARED_SET SharedSet 资源更改。
CAMPAIGN_SHARED_SET CampaignSharedSet 资源更改。
ASSET Asset 资源更改。
CUSTOMER_ASSET CustomerAsset 资源发生了更改。
CAMPAIGN_ASSET CampaignAsset 资源更改。
AD_GROUP_ASSET 更改了 AdGroupAsset 资源。
COMBINED_AUDIENCE CombinedAudience 资源更改。

ChangeStatusOperation

已更改的资源的状态

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

CombinedAudience

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

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

string

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

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

string (int64 format)

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

enum (CombinedAudienceStatus)

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

string

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

string

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

CombinedAudienceStatus

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

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

ClickView

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

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

string

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

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

object (ClickLocation)

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

object (ClickLocation)

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

string

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

object (KeywordInfo)

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

string

仅限输出。Google 点击 ID。
pageNumber

string (int64 format)

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

string

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

string

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

string

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

ClickLocation

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

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

string

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

string

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

string

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

string

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

string

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

CurrencyConstant

货币常量。

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

string

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

currencyConstants/{code}
code

string

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

string

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

string

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

string (int64 format)

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

AccessibleBiddingStrategy

表示客户拥有并与客户共享的 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

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

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

string (int64 format)

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

string

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

enum (BiddingStrategyType)

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

string (int64 format)

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

string

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

联合字段 scheme。出价方案。

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

object (MaximizeConversionValue)

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

object (MaximizeConversions)

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

object (TargetCpa)

仅限输出。一种出价策略，可为您设置合适的出价来帮助您争取尽可能多的转化，同时将每次转化费用控制在您设定的目标水平。
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

这是一种自动出价策略，可帮助您尽可能提高收入，同时确保达到平均广告支出回报率。

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

指定客户与客户之间的关联。CustomerClients 仅适用于经理账号。该数据会涵盖所有直接和间接客户客户，以及经理本身。

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

string

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

string

仅限输出。发出请求的客户所拥有的标签的资源名称，这些标签应用于客户客户。标签资源名称采用以下格式：

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

enum (CustomerStatus)

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

string

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

boolean

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

string (int64 format)

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

string

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

boolean

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

boolean

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

string

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

string

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

string (int64 format)

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

CustomerSearchTermInsight

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

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

string

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

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

string

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

string (int64 format)

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

DetailPlacementView

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

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

string

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

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

enum (PlacementType)

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

string

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

string

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

string

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

string

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

PlacementType

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

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

DetailedDemographic

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

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

string

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

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

string (int64 format)

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

string

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

string

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

boolean

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

object (CriterionCategoryAvailability)

仅限输出。详细受众特征的适用范围信息。

CriterionCategoryAvailability

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

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

object (CriterionCategoryChannelAvailability)

此类别可用的频道类型和子类型。
locale[]

object (CriterionCategoryLocaleAvailability)

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

CriterionCategoryChannelAvailability

提供某个类别的广告渠道类型和子类型的信息。

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

enum (CriterionCategoryChannelAvailabilityMode)

频道可用性的格式。可以是 ALL_CHANNELS（不设置其余字段）、CHANNEL_TYPE（只设置 advertisingChannelType 类型，类别可供其下的所有子类型使用）或 CHANNEL_TYPE_AND_SUBTYPES（advertisingChannelType、advertisingChannelSubType 和 includeDefaultChannelSubType 都会设置）。
advertisingChannelType

enum (AdvertisingChannelType)

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

enum (AdvertisingChannelSubType)

相应类别所能提供的频道类型下的频道子类型。
includeDefaultChannelSubType

boolean

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

CriterionCategoryChannelAvailabilityMode

包含可能的 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

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

FeedPlaceholderView

Feed 占位符视图。

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

string

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

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

enum (PlaceholderType)

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

GenderView

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

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

string

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

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

GeographicView

地理视图。

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

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

string

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

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

enum (GeoTargetingType)

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

string (int64 format)

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

GeoTargetingType

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

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

GroupPlacementView

组展示位置视图。

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

string

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

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

enum (PlacementType)

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

string

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

string

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

string

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

HotelGroupView

酒店组视图。

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

string

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

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

HotelPerformanceView

酒店效果视图。

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

string

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

customers/{customerId}/hotelPerformanceView

HotelReconciliation

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

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

string

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

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

string

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

string

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

string

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

string (int64 format)

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

string

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

string

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

string

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

string (int64 format)

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

boolean

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

enum (HotelReconciliationStatus)

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

HotelReconciliationStatus

酒店预订对账的状态。

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

IncomeRangeView

收入范围视图。

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

string

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

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

KeywordView

关键字视图。

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

string

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

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

LandingPageView

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

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

string

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

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

string

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

LanguageConstant

一种语言。

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

string

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

languageConstants/{criterionId}
id

string (int64 format)

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

string

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

string

仅限输出。语言的英语全名，例如“英语（美国）”“西班牙语”等。
targetable

boolean

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

LocationView

地理位置视图按地理位置条件汇总了广告系列的效果。如果未设置任何地理位置条件，则不会返回任何结果；而是使用 geoView 或 userLocationView 作为访问者位置数据。

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

string

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

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

ManagedPlacementView

自选展示位置视图。

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

string

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

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

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)

不可变。内容包含 HTML5 素材资源的 ZIP 归档媒体。
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

表示内容包含 HTML5 素材资源的 ZIP 归档媒体内容。

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 许可不是所请求的文档类型或包含无效的 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

包含本地生活服务企业注册文件专属信息的协议。

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,
  "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

仅限输出。成功率。
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,

  // 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)

仅限输出。失败事件的总数。
联合字段 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)

仅限输出。转变错误。
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。请仅使用 1 种类型，然后重试。
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 进行解码。确保您没有修改点击 ID。
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 请确保您在转化设置中同意客户数据处理条款，然后重试。您可以通过查询客户的 conversionTrackingSetting.accepted_customer_data_terms 检查您的设置。
ORDER_ID_CONTAINS_PII 事件的订单 ID 包含个人身份信息 (PII)，因此无法导入。
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS 请确保您已在转化设置中启用增强型潜在客户转化，然后重试。要检查您的设置，请查询客户的 conversionTrackingSetting.Enhance_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 不能在一个请求中对同一个资源执行两次 mutate 操作。
INCONSISTENT_FIELD_VALUES 该字段的内容与代表相同数据的其他字段不匹配。
MUTATE_NOT_ALLOWED 不允许对所请求的资源执行 mutate 操作。
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 过长。

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。

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 相当于 https://support.google.com/merchants/answer/6324436 一文中所述的 google_product_category ID。
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

包含可能的 UserInterestTaxonomyTypes 的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
AFFINITY 此用户兴趣的相似性。
IN_MARKET 此用户兴趣对应的市场。
MOBILE_APP_INSTALL_USER 已知安装了指定类别应用的用户。
VERTICAL_GEO 针对用户兴趣的行业所处的地理位置。
NEW_SMART_PHONE_USER 针对新智能手机用户的用户兴趣标准。

LifeEvent

人生大事：一种基于兴趣的特定行业，可在用户面临人生重大事件时覆盖他们。

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

string

仅限输出。人生大事的资源名称。人生大事资源名称采用以下格式：

customers/{customerId}/lifeEvents/{lifeEventId}
id

string (int64 format)

仅限输出。人生大事的 ID。
name

string

仅限输出。人生大事的名称，例如“最近搬家”
parent

string

仅限输出。LifeEvent 的父级。
launchedToAll

boolean

仅限输出。如果人生大事面向所有渠道和语言区域发布，则为“true”。
availabilities[]

object (CriterionCategoryAvailability)

仅限输出。人生大事的空闲情况信息。

UserLocationView

用户地理位置视图。

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

JSON 表示法 
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
字段
resourceName

string

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

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}
countryCriterionId

string (int64 format)

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

boolean

仅限输出。指明是否已定位地理位置。

TopicConstant

根据展示位置所属的类别（例如“宠物与动物/宠物/狗”），使用主题在 Google 展示广告网络中定位或排除展示位置。

JSON 表示法 
{
  "resourceName": string,
  "path": [
    string
  ],
  "id": string,
  "topicConstantParent": string
}
字段
resourceName

string

仅限输出。主题常量的资源名称。主题常量资源名称的格式为：

topicConstants/{topic_id}
path[]

string

仅限输出。要定位或排除的类别。数组中的每个后续元素都描述了一个更具体的子类别。例如，{"Pets & Animals", "Pets", "Dogs"} 表示“宠物与动物/宠物/狗”类别。如需查看可用主题类别的列表，请访问 https://developers.google.com/google-ads/api/reference/data/verticals
id

string (int64 format)

仅限输出。主题的 ID。
topicConstantParent

string

仅限输出。主题常量的父级的资源名称。

视频

视频。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "channelId": string,
  "durationMillis": string,
  "title": string
}
字段
resourceName

string

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

customers/{customerId}/videos/{videoId}
id

string

仅限输出。视频的 ID。
channelId

string

仅限输出。视频的所有者频道 ID。
durationMillis

string (int64 format)

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

string

仅限输出。视频的标题。

WebpageView

网页浏览。

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

string

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

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

LeadFormSubmissionData

来自潜在客户表单提交的数据。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "asset": string,
  "campaign": string,
  "leadFormSubmissionFields": [
    {
      object (LeadFormSubmissionField)
    }
  ],
  "customLeadFormSubmissionFields": [
    {
      object (CustomLeadFormSubmissionField)
    }
  ],
  "adGroup": string,
  "adGroupAd": string,
  "gclid": string,
  "submissionDateTime": string
}
字段
resourceName

string

仅限输出。潜在客户表单提交数据的资源名称。潜在客户表单提交数据资源名称的表单如下：

customers/{customerId}/leadFormSubmissionData/{lead_form_submission_data_id}
id

string

仅限输出。此次潜在客户表单提交的 ID。
asset

string

仅限输出。与所提交的潜在客户表单相关联的素材资源。
campaign

string

仅限输出。与所提交的潜在客户表单相关联的广告系列。
leadFormSubmissionFields[]

object (LeadFormSubmissionField)

仅限输出。与潜在客户表单相关联的提交数据。
customLeadFormSubmissionFields[]

object (CustomLeadFormSubmissionField)

仅限输出。与自定义潜在客户表单相关联的提交数据。
adGroup

string

仅限输出。与所提交的潜在客户表单相关联的广告组。
adGroupAd

string

仅限输出。与所提交的潜在客户表单相关联的 AdGroupAd。
gclid

string

仅限输出。与提交的潜在客户表单相关联的 Google 点击 ID。
submissionDateTime

string

仅限输出。潜在客户表单的提交日期和时间。格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”，例如“2019-01-01 12:32:45-08:00”。

LeadFormSubmissionField

已提交的潜在客户表单中的字段。

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

enum (LeadFormFieldUserInputType)

仅限输出。潜在客户表单字段的字段类型。
fieldValue

string

仅限输出。潜在客户表单字段的字段值。

CustomLeadFormSubmissionField

已提交的自定义问题中的字段

JSON 表示法 
{
  "questionText": string,
  "fieldValue": string
}
字段
questionText

string

仅限输出。自定义问题的问题文本，最多 300 个字符。
fieldValue

string

仅限输出。用于自定义问题回答的字段值，最大字符数为 70。

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,
  "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”。
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 抵用金处于待处理状态。
CREDITED 已完成退款申请。

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)

仅限输出。GLS 潜在客户对话的类型，如 EMAIL、MESSAGE、PHONE_CALL、短信等。
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)

仅限输出。邮件对话详情（如 EMAIL、MESSAGE 或短信）。

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”前缀。此键可用于与汇总转化键执行按位 OR 运算符，以创建完整的汇总键，以检索 Android Privacy Sandbox 中的汇总 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”前缀。此键可用于与汇总转化键执行按位 OR 运算符，以创建完整的汇总键，以检索 Android Privacy Sandbox 中的汇总 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”前缀。此键可用于与汇总转化键执行按位 OR 运算符，以创建完整的汇总键，以检索 Android Privacy Sandbox 中的汇总 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,
  "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,
  "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
}
字段
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

一个列表，包含过去 30 天内有过展示次数（且素材资源带有 AssetPerformanceLabel.BEST 效果标签）的最多 20 个示例关联资源。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。
sampleGoodPerformanceEntities[]

string

一个列表，包含过去 30 天内曾有展示次数且素材资源带有 AssetPerformanceLabel.GOOD 效果标签的关联资源（最多 20 个）。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。
sampleLowPerformanceEntities[]

string

一个列表，包含过去 30 天内有过展示次数的素材资源具有 AssetPerformanceLabel.LOW 效果标签，但最多包含 20 个示例关联资源。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。
sampleLearningPerformanceEntities[]

string

一个列表，包含过去 30 天内带有 AssetPerformanceLabel.LEARNING 效果标签且具有展示次数的关联资源（最多 20 个）示例。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。
sampleUnratedPerformanceEntities[]

string

一个包含最多 20 个示例已关联资源且在过去 30 天内获得了展示次数的样本，这些资源的 AssetPerformanceLabel 效果标签不是“BEST”“GOOD”“LOW”和“LEARNING”。该指标只能通过 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

应用内操作次数。
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) 除以合并查询次数。如需了解详情，请访问帮助页面：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 认为不合规定且不向您收费的点击次数。
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 将为每个唯一的 (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

收到的来电次数 (phoneCall) 除以您的电话号码的展示次数 (phoneImpressions)。
relativeCtr

number

您的点击率 (Ctr) 除以展示您的广告的网站上所有广告主的平均点击率。衡量您的广告与同一网站上的其他广告相比在展示广告网络中的效果。
searchAbsoluteTopImpressionShare

number

在最显眼购物位置展示的客户的购物或搜索广告展示次数所占百分比。如需了解详情，请参阅 https://support.google.com/google-ads/answer/7501826。任何低于 0.1 的值都会报告为 0.0999。
searchBudgetLostAbsoluteTopImpressionShare

number

此数字用于估算您的广告因预算不足而未能在搜索结果中作为头条广告进行展示的频率。注意：搜索网络预算错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchBudgetLostImpressionShare

number

您的广告有资格在搜索网络中展示但由于预算过低而未展示的次数的估算百分比。注意：搜索网络预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchBudgetLostTopImpressionShare

number

此数字用于估算您的广告因预算不足而未能在顶部自然搜索结果邻近位置展示的频率。注意：搜索网络预算错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchClickShare

number

您在搜索网络中获得的点击次数除以您有资格获得的估算点击次数。注意：搜索网络点击次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
searchExactMatchImpressionShare

number

对于与关键字完全匹配（或是关键字的紧密变体形式）的搜索字词，此字段是您获得的展示次数除以您有资格在搜索网络上获得的估算展示次数。注意：搜索网络完全匹配展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
searchImpressionShare

number

您在搜索网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意：在搜索网络中获得的展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
searchRankLostAbsoluteTopImpressionShare

number

此数字是一个估算值，用于估算您的广告因广告评级较低而未能在搜索结果中作为头条广告进行展示的频率。注意：搜索网络排名错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchRankLostImpressionShare

number

您的广告由于广告评级差而未在搜索网络中获得的展示次数的估算百分比。注意：搜索网络排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchRankLostTopImpressionShare

number

此数字是一个估算值，表示您的广告因广告评级较低而未能在顶部自然搜索结果邻近位置展示的频率。注意：搜索网络排名错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchTopImpressionShare

number

您在页首广告中实际获得的展示次数除以您有资格在页首广告中获得的估算展示次数所得到的百分比。注意：搜索网络页首展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。

页首广告通常展示在顶部自然搜索结果上方，但在某些查询中，页首广告可能会展示在顶部自然搜索结果下方。
searchVolume

object (SearchVolumeRange)

搜索字词数据分析类别的搜索量范围。
speedScore

string (int64 format)

衡量点击移动广告后网页加载的速度。得分范围介于 1 到 10 之间，10 是最快的。
averageTargetCpaMicros

string (int64 format)

平均目标每次转化费用，如果未提供，请取消设置（例如，广告系列的流量来自组合出价策略或非目标每次转化费用）。
averageTargetRoas

number

平均目标广告支出回报率，如果未提供，请未设置（例如，对于流量来自组合出价策略或非目标广告支出回报率的广告系列）。
topImpressionPercentage

number

在顶部自然搜索结果邻近位置展示的广告展示次数所占的百分比。
validAcceleratedMobilePagesClicksPercentage

number

到达有效 AMP 网页的 Accelerated Mobile Pages (AMP) 着陆页的广告点击次数所占百分比。
valuePerAllConversions

number

所有转化的价值除以所有转化的次数。
valuePerAllConversionsByConversionDate

number

所有转化的价值除以所有转化次数。如果选择此列并添加了日期，则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列，请访问 https://support.google.com/google-ads/answer/9549009。
valuePerConversion

number

转化价值除以转化次数。这仅包括 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

广告展示后，任意营业地点 surface 上的致电按钮点击次数。此衡量指标来自基于素材资源的位置。
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 来选择。只有效果最大化广告系列渠道支持此指标。

InteractionEventType

描述可能的付费互动和免费互动类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
CLICK 点击访问网站。在大多数情况下，这种互动会导航到外部位置，通常是广告客户的着陆页。这也是点击事件的默认 InteractionEventType。
ENGAGEMENT 用户在原位置与广告互动的明确意向。
VIDEO_VIEW 用户观看了一个视频广告。
NONE 广告转化事件的默认 InteractionEventType。当广告转化行没有指明免费互动（例如广告转化）应作为核心指标的一部分进行“推广”和报告时，会采用此列。这些都属于其他（广告）转化。

SearchVolumeRange

搜索量范围。实际搜索量在此范围内。

JSON 表示法 
{
  "min": string,
  "max": string
}
字段
min

string (int64 format)

搜索量的下限。
max

string (int64 format)

搜索量的上限。

路段

仅限细分字段。

JSON 表示法 
{
  "adDestinationType": enum (AdDestinationType),
  "adNetworkType": enum (AdNetworkType),
  "budgetCampaignAssociationStatus": {
    object (BudgetCampaignAssociationStatus)
  },
  "clickType": enum (ClickType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionAttributionEventType": enum (ConversionAttributionEventType),
  "conversionLagBucket": enum (ConversionLagBucket),
  "conversionOrAdjustmentLagBucket": enum (ConversionOrAdjustmentLagBucket),
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "externalConversionSource": enum (ExternalConversionSource),
  "hotelCheckInDayOfWeek": enum (DayOfWeek),
  "hotelDateSelectionType": enum (HotelDateSelectionType),
  "hotelRateType": enum (HotelRateType),
  "hotelPriceBucket": enum (HotelPriceBucket),
  "keyword": {
    object (Keyword)
  },
  "monthOfYear": enum (MonthOfYear),
  "placeholderType": enum (PlaceholderType),
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "recommendationType": enum (RecommendationType),
  "searchEngineResultsPageType": enum (SearchEngineResultsPageType),
  "searchTermMatchType": enum (SearchTermMatchType),
  "slot": enum (Slot),
  "conversionValueRulePrimaryDimension": enum (ConversionValueRulePrimaryDimension),
  "skAdNetworkUserType": enum (SkAdNetworkUserType),
  "skAdNetworkAdEventType": enum (SkAdNetworkAdEventType),
  "skAdNetworkAttributionCredit": enum (SkAdNetworkAttributionCredit),
  "skAdNetworkCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "skAdNetworkSourceType": enum (SkAdNetworkSourceType),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "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,
  "searchSubcategory": string,
  "searchTerm": string,
  "webpage": string,
  "week": string,
  "year": integer,
  "skAdNetworkFineConversionValue": string,
  "skAdNetworkRedistributedFineConversionValue": string,
  "skAdNetworkSourceApp": {
    object (SkAdNetworkSourceApp)
  },
  "skAdNetworkSourceDomain": string,
  "skAdNetworkPostbackSequenceIndex": string,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
字段
adDestinationType

enum (AdDestinationType)

广告目标页面类型。
adNetworkType

enum (AdNetworkType)

广告网络类型。
budgetCampaignAssociationStatus

object (BudgetCampaignAssociationStatus)

预算广告系列关联状态。
clickType

enum (ClickType)

点击类型。
conversionActionCategory

enum (ConversionActionCategory)

转化操作类别。
conversionAttributionEventType

enum (ConversionAttributionEventType)

转化归因事件类型。
conversionLagBucket

enum (ConversionLagBucket)

一个枚举值，表示展示和转化之间相隔的天数。
conversionOrAdjustmentLagBucket

enum (ConversionOrAdjustmentLagBucket)

一个枚举值，表示从展示到转化，或者从展示到转化调整之间的天数。
dayOfWeek

enum (DayOfWeek)

星期几，例如 MONDAY。
device

enum (Device)

应用指标的设备。
externalConversionSource

enum (ExternalConversionSource)

外部转化来源。
hotelCheckInDayOfWeek

enum (DayOfWeek)

酒店入住日（星期几）。
hotelDateSelectionType

enum (HotelDateSelectionType)

酒店日期选择类型。
hotelRateType

enum (HotelRateType)

酒店房价类型。
hotelPriceBucket

enum (HotelPriceBucket)

酒店价格范围。
keyword

object (Keyword)

关键字标准。
monthOfYear

enum (MonthOfYear)

月份，例如 1 月。
placeholderType

enum (PlaceholderType)

占位符类型。此维度只能与 Feed 项指标一起使用。
productChannel

enum (ProductChannel)

商品的渠道。
productChannelExclusivity

enum (ProductChannelExclusivity)

商品的渠道独占性。
productCondition

enum (ProductCondition)

商品的使用情况。
recommendationType

enum (RecommendationType)

建议类型。
searchEngineResultsPageType

enum (SearchEngineResultsPageType)

搜索引擎结果页 (SERP) 的类型。
searchTermMatchType

enum (SearchTermMatchType)

触发广告的关键字（包括变体）的匹配类型。
slot

enum (Slot)

广告的位置。
conversionValueRulePrimaryDimension

enum (ConversionValueRulePrimaryDimension)

应用的转化价值规则的主要维度。NO_RULE_APPLIED 显示的是未应用价值规则的转化的总记录价值。“ORIGINAL”显示已应用价值规则的转化的原始价值。GEO_LOCATION、DEVICE、AUDIENCE 显示应用价值规则后的净调整。
skAdNetworkUserType

enum (SkAdNetworkUserType)

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

enum (SkAdNetworkAdEventType)

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

enum (SkAdNetworkAttributionCredit)

iOS Store Kit 广告网络归因功劳
skAdNetworkCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

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

enum (SkAdNetworkSourceType)

促成 iOS Store Kit Ad Network 安装的广告的来源类型。Null 值表示此细分不适用（例如非 iOS 广告系列），或者 Apple 发送的任何回传中都不存在来源网域和来源应用。
newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

适用于按用户是新客户还是回头客来细分转化数据。此细分通常用于衡量客户获取目标的影响。
activityAccountId

string (int64 format)

活动帐号 ID。
activityCity

string

开展旅行活动的城市。
activityCountry

string

开展旅行活动的国家/地区。
activityRating

string (int64 format)

活动评分。
activityState

string

提供旅游 activity 的状态。
externalActivityId

string

广告客户提供的活动 ID。
adGroup

string

广告组的资源名称。
assetGroup

string

素材资源组的资源名称。
auctionInsightDomain

string

竞价分析报告中参与者的域名（可见网址）。
campaign

string

广告系列的资源名称。
conversionAction

string

转化操作的资源名称。
conversionActionName

string

转化操作名称。
conversionAdjustment

boolean

这会按原始转化次数和转化价值与转化次数（如果转化调整后）的增量细分您的转化列。假行包含最初所述的数据；而真行则包含现在的数据与最初所述的数据之间的增量。将两组数据相加后得到的调整后数据。
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 年第二季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。
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 广告网络重新分配的精确转化价值。

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 广告网络回传序列索引。
assetInteractionTarget

object (AssetInteractionTarget)

仅与 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标一起使用。指明互动指标是出现在素材资源本身上，还是出现在其他素材资源或广告单元上。当投放的广告的所有部分（例如广告本身以及站内链接等其他组件）一起投放时，系统会统计互动（例如点击次数）。如果 interactionOnThisAsset 为 true，则表示互动发生在此特定素材资源上；如果 InteractionOnThisAsset 为 false，则表示互动并非针对该特定素材资源，而是在已投放此素材资源的广告的其他部分。

AdDestinationType

枚举 Google Ads 目标类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
NOT_APPLICABLE 广告不打算将用户从广告引导至其他目标页面
WEBSITE 网站
APP_STORE iOS App Store 或 Play Store
PHONE_CALL 呼叫拨号器
MAP_DIRECTIONS 地图应用
LOCATION_LISTING 位置专用页面
MESSAGE 短信
LEAD_FORM 潜在客户发掘表单
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS 键未知的广告目标页面

AdNetworkType

枚举 Google Ads 广告网络类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
SEARCH Google 搜索。
SEARCH_PARTNERS 搜索网络合作伙伴。
CONTENT 展示广告网络。
MIXED 跨广告网络。
YOUTUBE YouTube
GOOGLE_TV Google TV

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 广告图片。

ConversionAttributionEventType

归因于的转化的事件类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 表示此版本中未知的值。
IMPRESSION 这次转化就归因于某次展示。
INTERACTION 这次转化就归因于某次互动。

ConversionLagBucket

表示从展示到发生转化之间相隔的天数的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
LESS_THAN_ONE_DAY 转化延迟时间范围为 0 到 1 天。包含 0 天，排除 1 天。
ONE_TO_TWO_DAYS 转化延迟时间范围为 1 天到 2 天。包含 1 天，不包括 2 天。
TWO_TO_THREE_DAYS 转化延迟时间范围为 2 天到 3 天。包含 2 天，不包括 3 天。
THREE_TO_FOUR_DAYS 转化延迟时间范围为 3 到 4 天。包含 3 天，不包括 4 天。
FOUR_TO_FIVE_DAYS 转化延迟时间范围为 4 到 5 天。包含 4 天，不包含 5 天。
FIVE_TO_SIX_DAYS 转化延迟时间范围为 5 天到 6 天。包含 5 天，不包括 6 天。
SIX_TO_SEVEN_DAYS 转化延迟时间范围为 6 天到 7 天。包含 6 天，不包括 7 天。
SEVEN_TO_EIGHT_DAYS 转化延迟时间范围为 7 天到 8 天。包含 7 天，不包含 8 天。
EIGHT_TO_NINE_DAYS 转化延迟时间范围为 8 天到 9 天。包含 8 天，不包含 9 天。
NINE_TO_TEN_DAYS 转化延迟时间范围为 9 天到 10 天。包含 9 天，不包括 10 天。
TEN_TO_ELEVEN_DAYS 转化延迟时间范围为 10 天到 11 天。包含 10 天，不包括 11 天。
ELEVEN_TO_TWELVE_DAYS 转化延迟时间范围为 11 天到 12 天。包含 11 天，不包括 12 天。
TWELVE_TO_THIRTEEN_DAYS 转化延迟时间范围为 12 天到 13 天。包含 12 天，不包括 13 天。
THIRTEEN_TO_FOURTEEN_DAYS 转化延迟时间范围为 13 天至 14 天。包含 13 天，不包括 14 天。
FOURTEEN_TO_TWENTY_ONE_DAYS 转化延迟时间范围从 14 天更改为 21 天。包含 14 天，不包括 21 天。
TWENTY_ONE_TO_THIRTY_DAYS 转化延迟时间范围为 21 天到 30 天。包含 21 天，不包括 30 天。
THIRTY_TO_FORTY_FIVE_DAYS 转化延迟时间范围为 30 天到 45 天。包含 30 天，不包括 45 天。
FORTY_FIVE_TO_SIXTY_DAYS 转化延迟时间范围为 45 天到 60 天。包含 45 天，不包括 60 天。
SIXTY_TO_NINETY_DAYS 转化延迟时间范围为 60 天到 90 天。包含 60 天，不包括 90 天。

ConversionOrAdjustmentLagBucket

枚举从展示到转化，或从展示到转化调整之间的天数。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
CONVERSION_LESS_THAN_ONE_DAY 转化延迟时间范围为 0 到 1 天。包含 0 天，排除 1 天。
CONVERSION_ONE_TO_TWO_DAYS 转化延迟时间范围为 1 天到 2 天。包含 1 天，不包括 2 天。
CONVERSION_TWO_TO_THREE_DAYS 转化延迟时间范围为 2 天到 3 天。包含 2 天，不包括 3 天。
CONVERSION_THREE_TO_FOUR_DAYS 转化延迟时间范围为 3 到 4 天。包含 3 天，不包括 4 天。
CONVERSION_FOUR_TO_FIVE_DAYS 转化延迟时间范围为 4 到 5 天。包含 4 天，不包含 5 天。
CONVERSION_FIVE_TO_SIX_DAYS 转化延迟时间范围为 5 天到 6 天。包含 5 天，不包括 6 天。
CONVERSION_SIX_TO_SEVEN_DAYS 转化延迟时间范围为 6 天到 7 天。包含 6 天，不包括 7 天。
CONVERSION_SEVEN_TO_EIGHT_DAYS 转化延迟时间范围为 7 天到 8 天。包含 7 天，不包含 8 天。
CONVERSION_EIGHT_TO_NINE_DAYS 转化延迟时间范围为 8 天到 9 天。包含 8 天，不包含 9 天。
CONVERSION_NINE_TO_TEN_DAYS 转化延迟时间范围为 9 天到 10 天。包含 9 天，不包括 10 天。
CONVERSION_TEN_TO_ELEVEN_DAYS 转化延迟时间范围为 10 天到 11 天。包含 10 天，不包括 11 天。
CONVERSION_ELEVEN_TO_TWELVE_DAYS 转化延迟时间范围为 11 天到 12 天。包含 11 天，不包括 12 天。
CONVERSION_TWELVE_TO_THIRTEEN_DAYS 转化延迟时间范围为 12 天到 13 天。包含 12 天，不包括 13 天。
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS 转化延迟时间范围为 13 天至 14 天。包含 13 天，不包括 14 天。
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS 转化延迟时间范围从 14 天更改为 21 天。包含 14 天，不包括 21 天。
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS 转化延迟时间范围为 21 天到 30 天。包含 21 天，不包括 30 天。
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS 转化延迟时间范围为 30 天到 45 天。包含 30 天，不包括 45 天。
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS 转化延迟时间范围为 45 天到 60 天。包含 45 天，不包括 60 天。
CONVERSION_SIXTY_TO_NINETY_DAYS 转化延迟时间范围为 60 天到 90 天。包含 60 天，不包括 90 天。
ADJUSTMENT_LESS_THAN_ONE_DAY 转化调整延迟时间范围为 0 到 1 天。包含 0 天，排除 1 天。
ADJUSTMENT_ONE_TO_TWO_DAYS 转化调整延迟时间范围为 1 天到 2 天。包含 1 天，不包括 2 天。
ADJUSTMENT_TWO_TO_THREE_DAYS 转化调整延迟时间范围从 2 天到 3 天。包含 2 天，不包括 3 天。
ADJUSTMENT_THREE_TO_FOUR_DAYS 转化调整延迟时间范围为 3 到 4 天。包含 3 天，不包括 4 天。
ADJUSTMENT_FOUR_TO_FIVE_DAYS 转化调整延迟时间范围从 4 天到 5 天。包含 4 天，不包含 5 天。
ADJUSTMENT_FIVE_TO_SIX_DAYS 转化调整延迟时间范围为 5 天到 6 天。包含 5 天，不包括 6 天。
ADJUSTMENT_SIX_TO_SEVEN_DAYS 转化调整延迟时间范围从 6 天到 7 天。包含 6 天，不包括 7 天。
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS 转化调整延迟时间范围从 7 天到 8 天。包含 7 天，不包含 8 天。
ADJUSTMENT_EIGHT_TO_NINE_DAYS 转化调整延迟时间范围从 8 天到 9 天。包含 8 天，不包含 9 天。
ADJUSTMENT_NINE_TO_TEN_DAYS 转化调整延迟时间范围为 9 天到 10 天。包含 9 天，不包括 10 天。
ADJUSTMENT_TEN_TO_ELEVEN_DAYS 转化调整延迟时间范围从 10 天到 11 天。包含 10 天，不包括 11 天。
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS 转化调整延迟时间范围从 11 天到 12 天。包含 11 天，不包括 12 天。
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS 转化调整延迟时间范围从 12 天到 13 天。包含 12 天，不包括 13 天。
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS 转化调整延迟时间范围从 13 天到 14 天。包含 13 天，不包括 14 天。
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS 转化调整延迟时间范围从 14 天到 21 天。包含 14 天，不包括 21 天。
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS 转化调整延迟时间范围从 21 天到 30 天。包含 21 天，不包括 30 天。
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS 转化调整延迟时间范围从 30 天到 45 天。包含 30 天，不包括 45 天。
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS 转化调整延迟时间范围从 45 天到 60 天。包含 45 天，不包括 60 天。
ADJUSTMENT_SIXTY_TO_NINETY_DAYS 转化调整延迟时间范围从 60 天到 90 天。包含 60 天，不包括 90 天。
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS 转化调整延迟时间范围从 90 天到 145 天。包含 90 天，不包括 145 天。
CONVERSION_UNKNOWN 转化延迟时间范围未知。此维度适用于在 Google Ads 中提供转化延迟时间范围之前的日期。
ADJUSTMENT_UNKNOWN 转化调整延迟时间范围未知。此维度适用于在 Google Ads 中提供转化调整延迟时间范围之前的日期。

ExternalConversionSource

与 ConversionAction 相关联的外部转化来源。

枚举
UNSPECIFIED 未指定。
UNKNOWN 表示此版本中未知的值。
WEBPAGE 用户在浏览广告后转到特定网页时发生的转化；在 Google Ads 界面中显示为“网站”。
ANALYTICS 来自关联的 Google Analytics（分析）目标或交易的转化；在 Google Ads 界面中显示为“Google Analytics（分析）”。
UPLOAD 通过 ConversionUploadService 上传的网站转化；在 Google Ads 界面中显示为“导入点击后发生的转化”。
AD_CALL_METRICS 用户点击广告中的附加电话信息后发生的转化；在 Google Ads 界面中显示为“直接从广告中拨打的来电”。
WEBSITE_CALL_METRICS 用户在点击广告后，拨打广告客户的网站上动态生成的电话号码（通过已安装的 JavaScript 访问）即视为转化；在 Google Ads 界面中显示为“来自网站的致电”。
STORE_VISITS 用户在点击 Google 广告后光顾广告客户的零售店时发生的转化；在 Google Ads 界面中显示为“实体店光顾”。
ANDROID_IN_APP 用户执行应用内操作（例如在 Android 应用中进行购买）时发生的转化；在 Google Ads 界面中显示为“Android 应用内操作”。
IOS_IN_APP 用户执行应用内操作（例如在 iOS 应用中进行购买）时发生的转化；在 Google Ads 界面中显示为“iOS 应用内操作”。
IOS_FIRST_OPEN 用户首次打开 iOS 应用时发生的转化；在 Google Ads 界面中显示为“iOS 应用安装（首次打开）”。
APP_UNSPECIFIED 旧版应用转化，未提供 AppPlatform；在 Google Ads 界面中显示为“移动应用”。
ANDROID_FIRST_OPEN 用户首次打开 Android 应用时发生的转化；在 Google Ads 界面中显示为“Android 应用安装（首次打开）”。
UPLOAD_CALLS 通过 ConversionUploadService 上传的致电转化；在 Google Ads 界面中显示为“导入致电后发生的转化”。
FIREBASE 来自关联的 Firebase 事件的转化；在 Google Ads 界面中显示为“Firebase”。
CLICK_TO_CALL 用户点击手机号码时发生的转化；在 Google Ads 界面中显示为“电话号码点击”。
SALESFORCE 来自 Salesforce 的转化；在 Google Ads 界面中显示为“Salesforce.com”。
STORE_SALES_CRM 由 CRM 记录的实体店购买带来的转化；在 Google Ads 界面中显示为“实体店销售（数据合作伙伴）”。
STORE_SALES_PAYMENT_NETWORK 由付款网络促成的实体店购买带来的转化；在 Google Ads 界面中显示为“实体店销售（付款网络）”。
GOOGLE_PLAY Google Play 无代码转化；在 Google Ads 界面中显示为“Google Play”。
THIRD_PARTY_APP_ANALYTICS 来自关联的第三方应用分析工具事件的转化；在 Google Ads 界面中显示为“第三方应用分析工具”。
GOOGLE_ATTRIBUTION 由 Google 归因工具控制的转化。
STORE_SALES_DIRECT_UPLOAD 基于第一方或第三方商家数据上传的实体店销售转化。在 Google Ads 界面中显示为“实体店销售（直接上传）”。
STORE_SALES 根据上传的第三方或第三方商家数据，和/或使用支付网络中的银行卡在实体店内购买促成的实体店销售转化。在 Google Ads 界面中显示为“实体店销售”。
SEARCH_ADS_360 从 Search Ads 360 Floodlight 数据导入的转化数据。
GOOGLE_HOSTED 用于跟踪用户与广告互动后在 Google 产品和服务中的本地操作的转化。
FLOODLIGHT 由 Floodlight 代码报告的转化次数。
ANALYTICS_SEARCH_ADS_360 专门针对 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 应用了多条规则时。

SkAdNetworkUserType

枚举 SkAdNetwork 用户类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
UNAVAILABLE 回传中不存在该值，或者由于其他原因我们没有此数据。
NEW_INSTALLER 用户首次安装应用。
REINSTALLER 用户之前已安装该应用。

SkAdNetworkAdEventType

枚举 SkAdNetwork 广告事件类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
UNAVAILABLE 回传中不存在该值，或者由于其他原因我们没有此数据。
INTERACTION 用户与广告互动。
VIEW 用户观看了广告。

SkAdNetworkSourceApp

SkAdNetworkSourceApp 细分。

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

string

促成 iOS Store Kit Ad Network 安装的广告所属的应用 ID。

SkAdNetworkAttributionCredit

枚举 SkAdNetwork 归因功劳。

枚举
UNSPECIFIED 默认值。此值等同于 null。
UNKNOWN 该值在此 API 版本中未知。此 API 版本中无法返回 true 枚举值，或者系统尚不支持该值。
UNAVAILABLE 回传中不存在该值，或者由于其他原因我们没有此数据。
WON Google 是在广告归因中胜出的广告网络。
CONTRIBUTED Google 符合归因条件，但未获胜。

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 完成转化的用户是广告主的新用户，具有较高的生命周期价值。