GoogleAdsRow

查詢傳回的資料列。

JSON 表示法 
{
  "accountBudget": {
    object (AccountBudget)
  },
  "accountBudgetProposal": {
    object (AccountBudgetProposal)
  },
  "accountLink": {
    object (AccountLink)
  },
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdAssetCombinationView": {
    object (AdGroupAdAssetCombinationView)
  },
  "adGroupAdAssetView": {
    object (AdGroupAdAssetView)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionCustomizer": {
    object (AdGroupCriterionCustomizer)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupCriterionSimulation": {
    object (AdGroupCriterionSimulation)
  },
  "adGroupCustomizer": {
    object (AdGroupCustomizer)
  },
  "adGroupExtensionSetting": {
    object (AdGroupExtensionSetting)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "adGroupSimulation": {
    object (AdGroupSimulation)
  },
  "adParameter": {
    object (AdParameter)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "adScheduleView": {
    object (AdScheduleView)
  },
  "domainCategory": {
    object (DomainCategory)
  },
  "asset": {
    object (Asset)
  },
  "assetFieldTypeView": {
    object (AssetFieldTypeView)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupProductGroupView": {
    object (AssetGroupProductGroupView)
  },
  "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)
  },
  "smartCampaignSearchTermView": {
    object (SmartCampaignSearchTermView)
  },
  "thirdPartyAppAnalyticsLink": {
    object (ThirdPartyAppAnalyticsLink)
  },
  "topicView": {
    object (TopicView)
  },
  "travelActivityGroupView": {
    object (TravelActivityGroupView)
  },
  "travelActivityPerformanceView": {
    object (TravelActivityPerformanceView)
  },
  "experiment": {
    object (Experiment)
  },
  "experimentArm": {
    object (ExperimentArm)
  },
  "userInterest": {
    object (UserInterest)
  },
  "lifeEvent": {
    object (LifeEvent)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "remarketingAction": {
    object (RemarketingAction)
  },
  "topicConstant": {
    object (TopicConstant)
  },
  "video": {
    object (Video)
  },
  "webpageView": {
    object (WebpageView)
  },
  "leadFormSubmissionData": {
    object (LeadFormSubmissionData)
  },
  "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)

查詢中參照的帳戶預算提案。
adGroup

object (AdGroup)

查詢中參照的廣告群組。
adGroupAd

object (AdGroupAd)

查詢中參照的廣告。
adGroupAdAssetCombinationView

object (AdGroupAdAssetCombinationView)

查詢中的廣告群組廣告素材資源組合檢視畫面。
adGroupAdAssetView

object (AdGroupAdAssetView)

查詢中的廣告群組廣告素材資源檢視畫面。
adGroupAdLabel

object (AdGroupAdLabel)

查詢中參照的廣告群組廣告標籤。
adGroupAsset

object (AdGroupAsset)

查詢中參照的廣告群組素材資源。
adGroupAssetSet

object (AdGroupAssetSet)

查詢中參照的廣告群組素材資源組合。
adGroupAudienceView

object (AdGroupAudienceView)

查詢中參照的廣告群組目標對象資料檢視。
adGroupBidModifier

object (AdGroupBidModifier)

查詢中參照的出價調節係數。
adGroupCriterion

object (AdGroupCriterion)

查詢中參照的條件。
adGroupCriterionCustomizer

object (AdGroupCriterionCustomizer)

查詢中參照的廣告群組條件自訂參數。
adGroupCriterionLabel

object (AdGroupCriterionLabel)

查詢中參照的廣告群組條件標籤。
adGroupCriterionSimulation

object (AdGroupCriterionSimulation)

查詢中參照的廣告群組條件模擬。
adGroupCustomizer

object (AdGroupCustomizer)

查詢中參照的廣告群組自訂參數。
adGroupExtensionSetting

object (AdGroupExtensionSetting)

查詢中參照的廣告群組額外資訊設定。
adGroupFeed

object (AdGroupFeed)

查詢中參照的廣告群組動態饋給。
adGroupLabel

object (AdGroupLabel)

查詢中參照的廣告群組標籤。
adGroupSimulation

object (AdGroupSimulation)

查詢中參照的廣告群組模擬。
adParameter

object (AdParameter)

查詢中參照的廣告參數。
ageRangeView

object (AgeRangeView)

查詢中參照的年齡層資料檢視。
adScheduleView

object (AdScheduleView)

查詢中參照的廣告時段資料檢視。
domainCategory

object (DomainCategory)

查詢中參照的網域類別。
asset

object (Asset)

查詢中參照的資產。
assetFieldTypeView

object (AssetFieldTypeView)

查詢中參照的資產欄位類型檢視畫面。
assetGroupAsset

object (AssetGroupAsset)

查詢中參照的素材資源群組素材資源。
assetGroupSignal

object (AssetGroupSignal)

查詢中參照的素材資源群組信號。
assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

查詢中參照的素材資源群組商家資訊群組篩選器。
assetGroupProductGroupView

object (AssetGroupProductGroupView)

查詢中參照的素材資源群組產品群組檢視畫面。
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)

查詢中參照的廣告活動動態饋給。
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)

查詢中參照的 MergedAudience。
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)

查詢中參照的顧客動態饋給。
customerLabel

object (CustomerLabel)

查詢中參照的客戶標籤。
customerLifecycleGoal

object (CustomerLifecycleGoal)

查詢中參照的客戶生命週期目標。
customerNegativeCriterion

object (CustomerNegativeCriterion)

查詢中參照的客戶排除條件。
customerSearchTermInsight

object (CustomerSearchTermInsight)

查詢中參照的客戶搜尋字詞洞察。
customerUserAccess

object (CustomerUserAccess)

查詢中參照的 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)

查詢中參照的動態饋給項目集。
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)

查詢中參照的產品群組檢視畫面。
recommendation

object (Recommendation)

查詢中參照的建議。
recommendationSubscription

object (RecommendationSubscription)

查詢中參照的建議訂閱項目。
searchTermView

object (SearchTermView)

查詢中參照的搜尋字詞檢視畫面。
sharedCriterion

object (SharedCriterion)

查詢中參照的共用組合。
sharedSet

object (SharedSet)

查詢中參照的共用組合。
smartCampaignSetting

object (SmartCampaignSetting)

查詢中參照的智慧廣告活動設定。
shoppingPerformanceView

object (ShoppingPerformanceView)

查詢中參照的購物成效資料檢視。
smartCampaignSearchTermView

object (SmartCampaignSearchTermView)

查詢中參照的智慧廣告活動搜尋字詞資料檢視。
topicView

object (TopicView)

查詢中參照的主題檢視表。
travelActivityGroupView

object (TravelActivityGroupView)

查詢中參照的旅遊活動群組資料檢視。
travelActivityPerformanceView

object (TravelActivityPerformanceView)

查詢中參照的旅遊活動成效資料檢視。
experiment

object (Experiment)

查詢中參照的實驗。
experimentArm

object (ExperimentArm)

查詢中參照的實驗組。
userInterest

object (UserInterest)

查詢中參照的使用者興趣。
lifeEvent

object (LifeEvent)

查詢中參照的人生大事。
userList

object (UserList)

查詢中參照的使用者名單。
userLocationView

object (UserLocationView)

查詢中參照的使用者位置檢視畫面。
remarketingAction

object (RemarketingAction)

查詢中參照的再行銷動作。
topicConstant

object (TopicConstant)

查詢中參照的主題常數。
video

object (Video)

查詢中參照的影片。
webpageView

object (WebpageView)

查詢中參照的網頁檢視。
leadFormSubmissionData

object (LeadFormSubmissionData)

查詢中參照的待開發客戶表單使用者提交內容。
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

帳戶層級預算。其中包含預算本身的相關資訊，以及最近獲準對預算所做的變更，以及尚待審核的提案變更。「待審核提案」中會顯示待審核的提議變更 (如果有的話)。預算相關的有效詳細資料位於名為「approved_」、「adjusted_」且不含前置字元的欄位。某些有效的詳細資料可能與使用者原先要求的內容不同 (例如支出上限)，系統會透過「proposed_」、「approved_」和「adjusted_」欄位將這些差異調整。

這項資源是透過 AccountBudgetProposal 變更，無法直接變更。預算無論何時最多只能有一個待處理的提案。正在等待待核准的提案。

獲準後，預算可能會受到調整 (例如抵免額調整項)。調整項會在「已核准」和「已調整」欄位之間建立差異，否則這些欄位會完全相同。

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)

僅供輸出。已放送廣告的價值 (以百萬分之一為單位)。

這也包括超量放送費用，在此情況下，系統可能會自動將抵免額套用至預算 (請參閱 TotalAdjustsMicros)。
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)

僅供輸出。建議的支出上限 (以百萬分之一為單位)。一百萬等於 1 單位。
proposedSpendingLimitType

enum (SpendingLimitType)

僅供輸出。提議的支出上限和定義明確的類型，例如 INFINITE。

聯集欄位 approved_spending_limit。核准的支出上限。

舉例來說，如果帳戶的支出金額超過提案核准時建議的支出上限，核准支出上限就會設為已支出的金額。approved_spending_limit 只能採用下列其中一種設定：
approvedSpendingLimitMicros

string (int64 format)

僅供輸出。核准的支出上限 (以百萬分之一為單位)。一百萬等於 1 單位。只有在提議的支出上限是有限時才會填入資料，且該上限值一律會大於或等於提議的支出上限。
approvedSpendingLimitType

enum (SpendingLimitType)

僅供輸出。已核准的支出上限和明確定義的類型，例如 INFINITE。只有在已核准的支出上限為 INFINITE 時，系統才會填入這個值。

聯集欄位 adjusted_spending_limit。套用調整項後的支出上限。調整項資料會儲存在 total_adjustments_micros 中。

這個值會決定帳戶的支出上限。adjusted_spending_limit 只能採用下列其中一種設定：
adjustedSpendingLimitMicros

string (int64 format)

僅供輸出。調整後的支出上限 (以百萬分之一為單位)。一百萬等於 1 單位。

如果已核准的支出上限是有限，調整後的支出上限可能會因預算套用的調整項類型而不同。

如要瞭解各種調整項類型，請參閱：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)

僅供輸出。支出上限 (以百萬分之一為單位)。一百萬等於 1 單位。
spendingLimitType

enum (SpendingLimitType)

僅供輸出。支出上限與定義明確的類型，例如 INFINITE。

AdGroupAdAssetCombinationView

廣告群組廣告素材資源組合的使用情況。回應式搜尋廣告目前僅支援 AdAssetCombinationView，我們預計日後將支援更多廣告類型。

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

廣告群組廣告與素材資源之間的連結。AppAds 和回應式搜尋廣告目前僅支援 廣告群組 AdAssetView。

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 聯播網廣告的興趣和再行銷名單，以及在目標對象層級匯總的搜尋廣告再行銷名單。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。廣告群組目標對象檢視畫面的資源名稱。廣告群組目標對象資料檢視資源名稱的格式如下：

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

AdGroupCriterionSimulation

廣告群組條件模擬。以下分別列出支援的廣告管道類型、條件類型、模擬類型和模擬修改方法組合。從 V5 開始的飯店廣告群組條件模擬作業。

  1. 多媒體廣告 - 關鍵字 - 單次點擊出價 - 單次點擊出價 - UNIFORM
  2. 搜尋 - 關鍵字 - 單次點擊出價 - 單次點擊出價 - 排除
  3. SHOPPING - LISTING_GROUP -CPC_bid - UNIFORM
  4. 飯店 - LISTING_GROUP - 單次點擊出價 - 非重複出價
  5. 飯店 - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
JSON 表示法 
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "criterionId": string,
  "startDate": string,
  "endDate": string,

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

string

僅供輸出。廣告群組條件模擬的資源名稱。廣告群組條件模擬資源名稱的格式如下：

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

enum (SimulationType)

僅供輸出。模擬作業所修改的欄位。
modificationMethod

enum (SimulationModificationMethod)

僅供輸出。模擬作業如何修改欄位。
adGroupId

string (int64 format)

僅供輸出。模擬作業的廣告群組 ID。
criterionId

string (int64 format)

僅供輸出。模擬作業的條件 ID。
startDate

string

僅供輸出。模擬依據的第一天，格式為 YYYY-MM-DD。
endDate

string

僅供輸出。模擬結果的最後一天，格式為 YYYY-MM-DD。
聯集欄位 point_list。模擬點清單。point_list 只能是下列其中一項：
cpcBidPointList

object (CpcBidSimulationPointList)

僅供輸出。如果模擬類型為「CPC_BID」，模擬點。
percentCpcBidPointList

object (PercentCpcBidSimulationPointList)

僅供輸出。如果模擬類型為 PERCENT_CPC_BID，模擬點就會發生。

SimulationType

列舉說明模擬作業修改的欄位。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
CPC_BID 模擬結果可用於單次點擊出價。
CPV_BID 模擬結果是針對單次收視出價。
TARGET_CPA 模擬工具為單次轉換出價目標。
BID_MODIFIER 這項模擬作業適用於出價調節係數，
TARGET_ROAS 模擬功能是針對廣告投資報酬率目標進行模擬。
PERCENT_CPC_BID 模擬結果是單次點擊出價百分比。
TARGET_IMPRESSION_SHARE 模擬結果是曝光比重目標。
BUDGET 模擬作業僅適用於預算。

SimulationModificationMethod

列舉說明模擬作業修改欄位的方法。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
UNIFORM 模擬中的值會套用至指定資源的所有子項。未遵循子資源的覆寫。
DEFAULT 系統會將模擬中的值套用至指定資源。系統會遵循子資源的覆寫設定，且流量估算並未納入這些資源。
SCALING 模擬中的值全都是由相同的因素縮放。舉例來說，在模擬的 TargetCpa 廣告活動中，系統會將廣告活動目標和所有廣告群組目標設定成 X 的係數。

CpcBidSimulationPointList

用於模擬「CPC_BID」類型模擬作業的容器。

JSON 表示法 
{
  "points": [
    {
      object (CpcBidSimulationPoint)
    }
  ]
}
欄位
points[]

object (CpcBidSimulationPoint)

一系列單次點擊出價金額的預測指標。

CpcBidSimulationPoint

特定單次點擊出價金額的預測指標。

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

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

string (int64 format)

廣告主為了獲得預估流量而必須設定的預計每日預算 (以廣告客戶貨幣的百萬分之一表示)。
biddableConversions

number

預計可出價轉換次數。
biddableConversionsValue

number

可出價轉換的預計總價值。
clicks

string (int64 format)

預計點擊次數。
costMicros

string (int64 format)

預估費用 (以百萬分之一為單位)
impressions

string (int64 format)

預計曝光次數。
topSlotImpressions

string (int64 format)

預測的頂端版位曝光次數。只有搜尋廣告管道類型支援這個欄位。
聯集欄位 cpc_simulation_key_value。如果 SimulationModificationMethod = UNIFORM 或 DEFAULT，已設定 cpc_bid_micros。當 SimulationModificationMethod = SCALING 時，已設定 cpc_bid_scaling_modifier。cpc_simulation_key_value 只能是下列其中一項：
cpcBidMicros

string (int64 format)

模擬單次點擊出價，預估指標是根據預測指標計算而得。
cpcBidScalingModifier

number

模擬縮放修飾符是以預測指標為基礎。與模擬實體相關的所有單次點擊出價都會由這個修飾符調整。

PercentCpcBidSimulationPointList

用於模擬 PERCENT_CPC_BID 類型模擬點的容器。

JSON 表示法 
{
  "points": [
    {
      object (PercentCpcBidSimulationPoint)
    }
  ]
}
欄位
points[]

object (PercentCpcBidSimulationPoint)

一系列單次點擊出價百分比的預測指標。

PercentCpcBidSimulationPoint

特定單次點擊出價金額的預測指標。只有飯店廣告管道類型支援這個欄位。

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

string (int64 format)

模擬單次點擊出價百分比，預計指標是根據預測指標計算而得。單次點擊出價百分比 (以商品或服務在廣告價格中所佔的比例表示)。在這裡儲存的值為 1,000,000 * [fraction]。
biddableConversions

number

預計可出價轉換次數。
biddableConversionsValue

number

可出價轉換的預計總價值 (以當地幣別計算)。
clicks

string (int64 format)

預計點擊次數。
costMicros

string (int64 format)

預估費用 (以百萬分之一為單位)
impressions

string (int64 format)

預計曝光次數。
topSlotImpressions

string (int64 format)

預測的頂端版位曝光次數。

AdGroupSimulation

廣告群組模擬。下方詳細說明瞭廣告管道類型、模擬類型和模擬修改方法所支援的組合。

  1. 搜尋聯播網 - 單次點擊出價 - 預設
  2. 搜尋 - 單次點擊出價 - 排除
  3. 搜尋 - TARGET_CPA - 非表單
  4. 搜尋 - TARGET_ROAS - 聯合國處理
  5. 多媒體 - 單次點擊出價 - 預設
  6. 多媒體廣告 - 單次點擊出價 - 不重複出價
  7. 多媒體廣告 - TARGET_CPA - 非必填
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)

僅供輸出。這個類別在類別集中的位置。數字越小表示網域越符合網域；空值表示不建議使用。
hasChildren

boolean

僅供輸出。指出此類別是否包含子類別。
recommendedCpcBidMicros

string (int64 format)

僅供輸出。該類別的建議單次點擊出價。

AssetFieldTypeView

素材資源欄位類型檢視畫面。當使用素材資源做為額外資訊時，這個檢視畫面會回報各素材資源欄位類型的未重疊指標。

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

string

僅供輸出。資產欄位類型檢視畫面的資源名稱。資產欄位類型檢視資源名稱的格式如下所示：

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

enum (AssetFieldType)

僅供輸出。資產欄位類型檢視畫面的素材資源欄位類型。

AssetGroupProductGroupView

素材資源群組產品群組檢視畫面。

JSON 表示法 
{
  "resourceName": string,
  "assetGroup": string,
  "assetGroupListingGroupFilter": string
}
欄位
resourceName

string

僅供輸出。素材資源群組產品群組檢視畫面的資源名稱。素材資源群組產品群組檢視畫面資源名稱的格式如下：

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

string

僅供輸出。與商家資訊群組篩選器相關聯的素材資源群組。
assetGroupListingGroupFilter

string

僅供輸出。素材資源群組商家資訊群組篩選器的資源名稱。

AssetGroupTopCombinationView

廣告群組廣告素材資源組合的使用情況。

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

string

僅供輸出。素材資源群組頂端組合檢視畫面的資源名稱。AssetGroup 頂層組合檢視資源名稱的格式為：「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. TARGET_CPA - 聯合國工夫
  2. TARGET_ROAS - UNIFORM
JSON 表示法 
{
  "resourceName": string,
  "biddingStrategyId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

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

string

僅供輸出。出價策略模擬的資源名稱。出價策略模擬資源名稱的格式如下：

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

string (int64 format)

僅供輸出。出價策略的共用組合 ID。
type

enum (SimulationType)

僅供輸出。模擬作業所修改的欄位。
modificationMethod

enum (SimulationModificationMethod)

僅供輸出。模擬作業如何修改欄位。
startDate

string

僅供輸出。模擬依據的第一天，格式為 YYYY-MM-DD。
endDate

string

僅供輸出。模擬結果的最後一天，格式為 YYYY-MM-DD
聯集欄位 point_list。模擬點清單。point_list 只能是下列其中一項：
targetCpaPointList

object (TargetCpaSimulationPointList)

僅供輸出。如果模擬類型為 TARGET_CPA，則模擬點。
targetRoasPointList

object (TargetRoasSimulationPointList)

僅供輸出。如果模擬類型為「TARGET_ROAS」時，模擬點。

CallView

一種通話檢視，內含來電專用廣告或來電額外資訊的來電追蹤資料。

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

string

僅供輸出。呼叫檢視的資源名稱。呼叫檢視資源名稱的格式如下：

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

string

僅供輸出。來電者的國家/地區代碼。
callerAreaCode

string

僅供輸出。來電者的區碼。如果通話時間長度短於 15 秒，則為空值。
callDurationSeconds

string (int64 format)

僅供輸出。廣告客戶提供的通話時間長度 (以秒為單位)。
startCallDateTime

string

僅供輸出。廣告主提供的通話開始日期時間。
endCallDateTime

string

僅供輸出。廣告主提供的通話結束日期時間。
callTrackingDisplayLocation

enum (CallTrackingDisplayLocation)

僅供輸出。來電追蹤顯示位置。
type

enum (CallType)

僅供輸出。呼叫類型。
callStatus

enum (GoogleVoiceCallStatus)

僅供輸出。通話狀態。

CallTrackingDisplayLocation

可能的來電追蹤顯示位置。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
AD 透過廣告撥打的電話。
LANDING_PAGE 透過到達網頁廣告所撥打的電話。

CallType

發出呼叫時可能出現的屬性類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
MANUALLY_DIALED 使用者手動撥打了電話。

GoogleVoiceCallStatus

Google 語音通話的可能狀態。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
MISSED 未接聽來電。
RECEIVED 已收到通話。

CampaignAudienceView

廣告活動目標對象檢視畫面。包含多媒體廣告聯播網和 YouTube 聯播網廣告的興趣和再行銷名單，以及依廣告活動和目標對象條件匯總的搜尋廣告再行銷名單 (RLSA)。這個檢視畫面只包含廣告活動層級附加的目標對象。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。廣告活動目標對象檢視畫面的資源名稱。廣告活動目標對象資料檢視資源名稱的格式如下：

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

CampaignSearchTermInsight

廣告活動搜尋字詞檢視。歷來資料從 2023 年 3 月起開始提供。

JSON 表示法 
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string,
  "campaignId": string
}
欄位
resourceName

string

僅供輸出。廣告活動層級搜尋字詞洞察的資源名稱。廣告活動層級搜尋字詞洞察資源名稱的格式如下：

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

string

僅供輸出。搜尋類別的標籤。如果搜尋字詞不符合其他類別，就會表示屬於「全部接收」類別。
id

string (int64 format)

僅供輸出。深入分析的 ID。
campaignId

string (int64 format)

僅供輸出。廣告活動的 ID。

CampaignSimulation

廣告活動模擬。下方詳細說明瞭廣告管道類型、模擬類型和模擬修改方法所支援的組合。

  • 搜尋 - 單次點擊出價 - 排除
  • 搜尋 - 單次點擊出價 - 放送
  • 搜尋 - TARGET_CPA - 非表單
  • 搜尋 - TARGET_CPA - SCALING
  • 搜尋 - TARGET_ROAS - 聯合國處理
  • 搜尋 - TARGET_IMPRESSION_SHARE - 專屬
  • 搜尋聯播網 - 預算 - 公開
  • 購物 - 預算 - 不公開
  • 購物 - TARGET_ROAS - UNIFORM
  • MULTI_CHANNEL - TARGET_CPA - UNIFORM
  • MULTI_CHANNEL - TARGET_ROAS - UNIFORM
  • 探索 - TARGET_CPA - 預設
  • 多媒體廣告 - TARGET_CPA - 非必填
  • PERFORMANCE_MAX - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - TARGET_ROAS - UNIFORM
  • PERFORMANCE_MAX - 預算 - 非表單
JSON 表示法 
{
  "resourceName": string,
  "campaignId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

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

string

僅供輸出。廣告活動模擬的資源名稱。廣告活動模擬資源名稱的格式如下：

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

string (int64 format)

僅供輸出。模擬作業的廣告活動 ID。
type

enum (SimulationType)

僅供輸出。模擬作業所修改的欄位。
modificationMethod

enum (SimulationModificationMethod)

僅供輸出。模擬作業如何修改欄位。
startDate

string

僅供輸出。模擬依據的第一天，格式為 YYYY-MM-DD。
endDate

string

僅供輸出。模擬結果的最後一天，格式為 YYYY-MM-DD
聯集欄位 point_list。模擬點清單。point_list 只能是下列其中一項：
cpcBidPointList

object (CpcBidSimulationPointList)

僅供輸出。如果模擬類型為「CPC_BID」，模擬點。
targetCpaPointList

object (TargetCpaSimulationPointList)

僅供輸出。如果模擬類型為 TARGET_CPA，則模擬點。
targetRoasPointList

object (TargetRoasSimulationPointList)

僅供輸出。如果模擬類型為「TARGET_ROAS」時，模擬點。
targetImpressionSharePointList

object (TargetImpressionShareSimulationPointList)

僅供輸出。如果模擬類型為 TARGET_IMPRESSION_SHARE，則模擬點。
budgetPointList

object (BudgetSimulationPointList)

僅供輸出。如果模擬類型為「BUDGET」，模擬點。

TargetImpressionShareSimulationPointList

用於模擬 TARGET_IMPRESSION_SHARE 類型的容器。

JSON 表示法 
{
  "points": [
    {
      object (TargetImpressionShareSimulationPoint)
    }
  ]
}
欄位
points[]

object (TargetImpressionShareSimulationPoint)

特定目標曝光比重值的預計指標。

TargetImpressionShareSimulationPoint

特定目標曝光比重值的預計指標。

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

string (int64 format)

模擬目標曝光比重值 (以百萬分之一為單位)，預計指標依據。舉例來說，10% 曝光比重 (等於 0.1) 就會儲存為 100_000。這個值已完成驗證，而且不會超過 100 萬 (100%)。
requiredCpcBidCeilingMicros

string (int64 format)

廣告客戶為了獲得這項模擬結果，必須設定的每日單次點擊出價上限 (以廣告客戶貨幣的百萬分之一表示)。
requiredBudgetAmountMicros

string (int64 format)

廣告主為了獲得預估流量而必須設定的預計每日預算 (以廣告客戶貨幣的百萬分之一表示)。
biddableConversions

number

預計可出價轉換次數。
biddableConversionsValue

number

可出價轉換的預計總價值。
clicks

string (int64 format)

預計點擊次數。
costMicros

string (int64 format)

預估費用 (以百萬分之一為單位)
impressions

string (int64 format)

預計曝光次數。
topSlotImpressions

string (int64 format)

預測的頂端版位曝光次數。只有搜尋廣告管道類型支援這個欄位。
absoluteTopImpressions

string (int64 format)

預測的絕對頂端曝光次數。只有搜尋廣告管道類型支援這個欄位。

BudgetSimulationPointList

用於模擬「BUDGET」類型模擬點的容器。

JSON 表示法 
{
  "points": [
    {
      object (BudgetSimulationPoint)
    }
  ]
}
欄位
points[]

object (BudgetSimulationPoint)

一系列預算金額的預測指標。

BudgetSimulationPoint

特定預算金額的預測指標。

JSON 表示法 
{
  "budgetAmountMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "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 天內透過 UI 或 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)

僅供輸出。已變更資源的類型。這會指定哪個資源會在舊資源和 newResource 中設定。
changeResourceName

string

僅供輸出。發生這項變更的 Just 資源。
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

僅供輸出。受到這項異動影響的動態饋給。
feedItem

string

僅供輸出。受到這項變更影響的 FeedItem。
asset

string

僅供輸出。受到這項變更影響的資產。

ChangeEventResourceType

列出 ChangesEvent 資源支援的資源類型。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN 僅用於傳回值。代表這個版本中的未分類資源。
AD 廣告資源變更。
AD_GROUP 廣告群組資源變更。
AD_GROUP_CRITERION 廣告群組條件資源變更。
CAMPAIGN 廣告活動資源變更。
CAMPAIGN_BUDGET CampaignBudget 資源變更。
AD_GROUP_BID_MODIFIER 廣告群組 BidModifier 資源變更。
CAMPAIGN_CRITERION CampaignCriterion 資源變更。
FEED 動態饋給資源變更。
FEED_ITEM FeedItem 資源變更。
CAMPAIGN_FEED CampaignFeed 資源變更。
AD_GROUP_FEED 廣告群組動態饋給資源異動。
AD_GROUP_AD 廣告群組廣告資源變更。
ASSET 資產資源變更。
CUSTOMER_ASSET CustomerAsset 資源變更。
CAMPAIGN_ASSET CampaignAsset 資源變更。
AD_GROUP_ASSET 廣告群組資產變更。
ASSET_SET AssetSet 資源變更。
ASSET_SET_ASSET AssetSetAsset 資源變更。
CAMPAIGN_ASSET_SET CampaignAssetSet 資源變更。

ChangeClientType

changeEvent 資源的執行來源。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN 僅用於傳回值。代表這個版本不明的未分類用戶端類型。
GOOGLE_ADS_WEB_CLIENT 透過 ads.google.com.tw 所做的變更。例如透過廣告活動管理進行變更。
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)

僅供輸出。設定 if changeResourceType == AD 時，才設定此參數。
adGroup

object (AdGroup)

僅供輸出。設定 if changeResourceType == AD_GROUP 時，才設定此參數。
adGroupCriterion

object (AdGroupCriterion)

僅供輸出。設定 if 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)

僅供輸出。設定 if changeResourceType == AD_GROUP_AD 時，才設定此參數。
asset

object (Asset)

僅供輸出。針對 changeResourceType == ASSET 設定。
customerAsset

object (CustomerAsset)

僅供輸出。如果 changeResourceType == CUSTOMER_ASSET ，設定此參數。
campaignAsset

object (CampaignAsset)

僅供輸出。針對 changeResourceType == CAMPAIGN_ASSET 設定。
adGroupAsset

object (AdGroupAsset)

僅供輸出。設定 if 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

僅供輸出。受這項異動影響的客戶資產。
campaignAsset

string

僅供輸出。受到這項異動影響的 CampaignAsset。
adGroupAsset

string

僅供輸出。受這項異動影響的 adAsset。
combinedAudience

string

僅供輸出。受這項異動影響的 MergedAudience。
lastChangeDateTime

string

僅供輸出。最近一次變更於這項資源的時間。
campaign

string

僅供輸出。受這項異動影響的廣告活動。
adGroup

string

僅供輸出。受到這項變更影響的廣告群組。
adGroupAd

string

僅供輸出。受到這項變更影響的 廣告群組廣告。
adGroupCriterion

string

僅供輸出。受此變更影響的 廣告群組條件。
campaignCriterion

string

僅供輸出。受到這項異動影響的 CampaignCriterion。
feed

string

僅供輸出。受到這項異動影響的動態饋給。
feedItem

string

僅供輸出。受到這項變更影響的 FeedItem。
adGroupFeed

string

僅供輸出。受到這項異動影響的廣告群組動態饋給。
campaignFeed

string

僅供輸出。受到這項異動影響的廣告活動動態饋給。
adGroupBidModifier

string

僅供輸出。受這項變更影響的 廣告群組 BidModifier。

ChangeStatusResourceType

列舉列出 ChangeStatus 資源支援的資源類型。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN 僅用於傳回值。代表這個版本中的未分類資源。
AD_GROUP 廣告群組資源變更。
AD_GROUP_AD 廣告群組廣告資源變更。
AD_GROUP_CRITERION 廣告群組條件資源變更。
CAMPAIGN 廣告活動資源變更。
CAMPAIGN_CRITERION CampaignCriterion 資源變更。
FEED 動態饋給資源變更。
FEED_ITEM FeedItem 資源變更。
AD_GROUP_FEED 廣告群組動態饋給資源異動。
CAMPAIGN_FEED CampaignFeed 資源變更。
AD_GROUP_BID_MODIFIER 廣告群組 BidModifier 資源變更。
SHARED_SET SharedSet 資源變更。
CAMPAIGN_SHARED_SET CampaignSharedSet 資源變更。
ASSET 資產資源變更。
CUSTOMER_ASSET CustomerAsset 資源變更。
CAMPAIGN_ASSET CampaignAsset 資源變更。
AD_GROUP_ASSET 廣告群組資產變更。
COMBINED_AUDIENCE MergedAudience 資源變更。

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

僅供輸出。相關的關鍵字 (如果有的話) 會對應到 SEARCH 管道。
keywordInfo

object (KeywordInfo)

僅供輸出。關於相關關鍵字的基本資訊 (如果有的話)。
gclid

string

僅供輸出。Google 點擊編號。
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

代表客戶擁有並與其共用的出價策略檢視畫面。

相較於出價策略，這項資源包括客戶管理員所擁有的策略，以及與客戶的共用策略，以及客戶擁有的策略。這項資源不提供指標，且隻公開一部分的出價策略屬性。

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

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

string

僅供輸出。可存取出價策略的資源名稱。AccessibleBiddingStrategy 資源名稱的格式如下：

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

string (int64 format)

僅供輸出。出價策略的 ID。
name

string

僅供輸出。出價策略的名稱。
type

enum (BiddingStrategyType)

僅供輸出。出價策略的類型。
ownerCustomerId

string (int64 format)

僅供輸出。出價策略擁有者的客戶 ID。
ownerDescriptiveName

string

僅供輸出。出價策略擁有者的描述性名稱。

聯集欄位 scheme。出價配置。

只能設定其中一項。scheme 只能採用下列其中一種設定：
maximizeConversionValue

object (MaximizeConversionValue)

僅供輸出。自動出價策略會以您的預算為廣告活動爭取最大轉換價值，
maximizeConversions

object (MaximizeConversions)

僅供輸出。一種自動出價策略，用您的預算為廣告活動爭取最多轉換。
targetCpa

object (TargetCpa)

僅供輸出。這項出價策略會按照您指定的目標單次轉換出價盡量爭取轉換。
targetImpressionShare

object (TargetImpressionShare)

僅供輸出。會自動最佳化指定百分比曝光的出價策略。
targetRoas

object (TargetRoas)

僅供輸出。這個出價策略會在平均分配特定目標廣告投資報酬率，協助您爭取最高收益。
targetSpend

object (TargetSpend)

僅供輸出。這項出價策略會設定出價，在預算範圍內盡量爭取點擊。

MaximizeConversionValue

自動出價策略會以您的預算為廣告活動爭取最大轉換價值，

JSON 表示法 
{
  "targetRoas": number
}
欄位
targetRoas

number

僅供輸出。目標廣告投資報酬率選項。如果設定這項參數，出價策略會盡可能提高收益，同時平均地設定目標廣告投資報酬率。如果目標廣告投資報酬率偏高，出價策略可能無法用完整筆預算。如未設定目標廣告投資報酬率，出價策略會在預算範圍內盡可能達成最高廣告投資報酬率。

MaximizeConversions

一種自動出價策略，用您的預算為廣告活動爭取最多轉換。

JSON 表示法 
{
  "targetCpaMicros": string
}
欄位
targetCpaMicros

string (int64 format)

僅供輸出。目標單次轉換出價選項。這是指您願意為每次轉換支付的平均金額。

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)

僅供輸出。盡量爭取點擊的支出目標。目標支出出價工具會嘗試支出這個值中較小的值或自然調節支出金額。如果未指定，則會使用預算做為支出目標。這個欄位已淘汰，不應再使用。詳情請參閱 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。
cpcBidCeilingMicros

string (int64 format)

僅供輸出。出價策略可設定的出價上限。這項限制會套用至策略管理的所有關鍵字。

CustomerClient

指定客戶與客戶客戶之間的連結。只有管理員客戶能找到 CustomerClient。包含所有直接和間接客戶，以及管理員本身。

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

string

僅供輸出。客戶用戶端的資源名稱。CustomerClient 資源名稱的格式如下：customers/{customerId}/customerClients/{client_customer_id}
appliedLabels[]

string

僅供輸出。提出要求的客戶所擁有的標籤資源名稱，該標籤將套用至客戶客戶。標籤資源名稱的格式如下：

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

enum (CustomerStatus)

僅供輸出。客戶客戶的狀態。唯讀。
clientCustomer

string

僅供輸出。與客戶連結的客戶資源名稱。唯讀。
hidden

boolean

僅供輸出。指出這是隱藏的帳戶。唯讀。
level

string (int64 format)

僅供輸出。指定客戶和客戶之間的距離。如為自我連結，層級值會是 0。唯讀。
timeZone

string

僅供輸出。用戶端時區的常見語言代碼資料存放區 (CLDR) 字串，例如 America/Los_Angeles。唯讀。
testAccount

boolean

僅供輸出。識別客戶是否為測試帳戶。唯讀。
manager

boolean

僅供輸出。指出客戶是否為管理員。唯讀。
descriptiveName

string

僅供輸出。客戶的描述性名稱。唯讀。
currencyCode

string

僅供輸出。客戶的幣別代碼，例如「USD」、「EUR」。唯讀。
id

string (int64 format)

僅供輸出。客戶的 ID。唯讀。

CustomerSearchTermInsight

客戶搜尋字詞檢視。歷來資料從 2023 年 3 月起開始提供。

JSON 表示法 
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string
}
欄位
resourceName

string

僅供輸出。客戶層級搜尋字詞洞察的資源名稱。客戶層級搜尋字詞洞察資源名稱的格式如下：

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

string

僅供輸出。搜尋類別的標籤。如果搜尋字詞不符合其他類別，就會表示屬於「全部接收」類別。
id

string (int64 format)

僅供輸出。深入分析的 ID。

DetailPlacementView

包含依廣告群組和網址或 YouTube 影片匯總指標的資料檢視。

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

string

僅供輸出。詳細資料位置檢視畫面的資源名稱。詳細資料刊登位置檢視表資源名稱的格式如下所示：

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

enum (PlacementType)

僅供輸出。刊登位置的類型，例如網站、YouTube 影片和行動應用程式。
placement

string

僅供輸出。詳細資料層級的自動刊登位置字串，例如網站網址、行動應用程式 ID 或 YouTube 影片 ID。
displayName

string

僅供輸出。顯示名稱為網站的網址、YouTube 影片名稱，以及行動應用程式的翻譯行動應用程式名稱。
groupPlacementTargetUrl

string

僅供輸出。群組刊登位置的網址 (例如網域、應用程式商店中的行動應用程式連結) 或 YouTube 頻道網址。
targetUrl

string

僅供輸出。刊登位置的網址 (例如網站)、應用程式商店中的行動應用程式連結，或 YouTube 影片網址。

PlacementType

動態饋給對應的可能刊登位置類型。

列舉
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 (只會設定 adChannelType 類型，此類別可供其底下的所有子類型使用) 或 CHANNEL_TYPE_AND_SUBTYPES (全部設定 adsChannelType、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 使用者位於該地點 1.5 公里內。
WITHIN_20KM 使用者位於該地點 20 公里內。
WITHIN_25KM 使用者位於該地點 2.5 公里內。
WITHIN_30KM 使用者位於該地點 30,000 以內。
WITHIN_35KM 使用者位於該地點 3.5 公里內。
WITHIN_40KM 使用者位於該地點 40 公里內。
WITHIN_45KM 使用者位於該地點 45 公里內。
WITHIN_50KM 使用者位於該地點 50 公里內。
WITHIN_55KM 使用者位於該地點 5.5 公里內。
WITHIN_60KM 使用者位於該地點 60 公里內。
WITHIN_65KM 使用者位於該地點 65 公里內。
BEYOND_65KM 使用者超過了地點的 6.5 公里。
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

僅供輸出。針對曝光放送的網頁動態饋給項目網址。

這是唯讀欄位。
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

動態饋給預留位置檢視畫面。

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

string

僅供輸出。動態饋給預留位置檢視畫面的資源名稱。動態饋給預留位置檢視畫面資源名稱的格式如下：

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

enum (PlaceholderType)

僅供輸出。動態饋給預留位置檢視畫面的預留位置類型。

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 是這筆預訂的 ID，如同轉換追蹤代碼的「transaction_id」參數所提供的一樣。
campaign

string

僅供輸出。與轉換相關聯的廣告活動資源名稱。
hotelCenterId

string (int64 format)

僅供輸出。提供飯店廣告活動房價的 Hotel Center 帳戶 ID。
hotelId

string

僅供輸出。預訂房源的專屬 ID，與 Hotel Center 動態饋給提供的 ID 相同。飯店 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

僅供輸出。英文的完整語言名稱，例如「英文 (US)、西班牙文」等。
targetable

boolean

僅供輸出。是否可指定該語言。

LocationView

地區檢視會按地區條件顯示廣告活動的成效摘要。如未設定 Location 條件，則不會傳回任何結果；請改用 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

不可變動。原始媒體檔案的下載位置網址 (或檔案名稱)。只用於音訊和圖片類型的媒體。
name

string

不可變動。媒體檔案名稱。用戶端可使用此名稱來識別先前上傳的媒體。
fileSize

string (int64 format)

僅供輸出。媒體檔案大小，以位元組為單位。
聯集欄位 mediatype。媒體檔案的特定類型。mediatype 只能是下列其中一項：
image

object (MediaImage)

不可變動。封裝圖片。
mediaBundle

object (MediaBundle)

不可變動。ZIP 封存檔，其中內容包含 HTML5 素材資源。
audio

object (MediaAudio)

僅供輸出。封裝音訊。
video

object (MediaVideo)

不可變動。封裝影片。

MediaType

媒體類型。

列舉
UNSPECIFIED 尚未指定媒體類型。
UNKNOWN

這個版本無法得知接收到的值。

這個值僅供回應使用。
IMAGE 用於圖像廣告的靜態圖片。
ICON 用於地圖廣告的小型圖片。
MEDIA_BUNDLE ZIP 檔案，用於範本廣告的欄位。
AUDIO 音訊檔案。
VIDEO 影片檔案。
DYNAMIC_IMAGE 動畫圖片，例如 GIF 動畫。

MediaImage

封裝圖片。

JSON 表示法 
{
  "data": string,
  "fullSizeImageUrl": string,
  "previewSizeImageUrl": string
}
欄位
data

string (bytes format)

不可變動。原始圖片資料。

Base64 編碼的字串。
fullSizeImageUrl

string

僅供輸出。圖片完整尺寸版本的網址。
previewSizeImageUrl

string

僅供輸出。圖片預覽大小版本的網址。

MediaBundle

代表內含 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

僅供輸出。此影片的業界標準商業識別碼 (Industry Standard Commercial Identifier) 代碼，主要用於電視廣告。

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)

僅供輸出。員工狀態，例如「已刪除」或「已啟用」。
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

儲存當地服務保險相關資訊的原型。

JSON 表示法 
{
  "amountMicros": string,
  "rejectionReason": enum (LocalServicesInsuranceRejectionReason),
  "insuranceDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
欄位
amountMicros

string (int64 format)

僅供輸出。保險金額。以保險文件中所提及的貨幣「微量」計算。
rejectionReason

enum (LocalServicesInsuranceRejectionReason)

僅供輸出。保險文件拒絕的原因。
insuranceDocumentReadonly

object (LocalServicesDocumentReadOnly)

僅供輸出。唯讀欄位，內含已上傳保險文件的資訊。

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

保留在地生活服務授權相關資訊的原型。

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

string

僅供輸出。授權類型 / 名稱。
licenseNumber

string

僅供輸出。執照號碼。
licenseeFirstName

string

僅供輸出。被授權人的名字。
licenseeLastName

string

僅供輸出。被授權人的姓氏。
rejectionReason

enum (LocalServicesLicenseRejectionReason)

僅供輸出。授權遭拒原因。
licenseDocumentReadonly

object (LocalServicesDocumentReadOnly)

僅供輸出。唯讀欄位，內含已上傳執照文件的資訊。

LocalServicesLicenseRejectionReason

舉例說明在地生活服務授權驗證成果可能會遭拒的原因。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
BUSINESS_NAME_MISMATCH 商家名稱與在地生活服務廣告的商家名稱不符。
UNAUTHORIZED 授權未經授權或遭到撤銷。
EXPIRED 授權已過期。
POOR_QUALITY 授權品質不佳 - 圖片模糊不清、難以辨識等
UNVERIFIABLE 由於圖像無效，因此無法驗證授權。
WRONG_DOCUMENT_OR_ID 執照與要求的文件類型不符，或是包含無效的 ID。
OTHER 授權有其他未明確列出的瑕疵。

BusinessRegistrationCheckVerificationArtifact

專門保存在地生活服務公司登記檢查資訊的原型。

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

專門保存在地生活服務公司登記號碼資訊的原型。

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 UI、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 找不到與這個轉換動作和轉換 ID 相對應的轉換。請確認轉換 ID 連結至正確的轉換動作，然後再試一次。
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 調整項的訂單 ID 包含個人識別資訊 (PII)，因此無法使用。
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 無法解碼匯入的 Google 點擊 ID。請確認您並未修改點擊 ID。
CONVERSION_PRECEDES_EVENT 匯入的事件含有點擊之前的 conversionDateTime。請確認 conversionDateTime 正確無誤，然後再試一次。
EXPIRED_EVENT 此轉換的點擊時間早於點閱後回溯期，因此無法記錄匯入的事件。請確認您匯入的是最新資料。
TOO_RECENT_EVENT 與指定 ID 或 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 找不到促成匯入事件的通話或點擊。請確認資料來源設定包含正確的 ID。
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 使用者提供的資料無法與外部歸因模式搭配使用。請改用其他歸因模式或省略使用者 ID，然後再試一次。
UNSUPPORTED_USER_IDENTIFIER 不支援提供的使用者 ID。請務必使用經過雜湊處理的電子郵件或電話號碼，然後再試一次。
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.enhanced_conversions_for_leads_enabled。
INVALID_JOB_ID 要求中提供的工作 ID 不在許可範圍內。工作 ID 必須是 [1, 2^31] 範圍內的正整數。
NO_CONVERSION_ACTION_FOUND 找不到上傳要求中指定的轉換動作，請確認該動作可在這個帳戶中找到。
INVALID_CONVERSION_ACTION_TYPE 上傳要求中指定的轉換動作未設為用於上傳轉換。

DateError

列舉說明可能的日期錯誤。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 這個版本無法得知收到的錯誤代碼。
INVALID_FIELD_VALUES_IN_DATE 必須提供有效的日期。
INVALID_FIELD_VALUES_IN_DATE_TIME 必須提供有效的日期時間做為欄位值。
INVALID_STRING_DATE 字串的日期格式必須為 yyyy-mm-dd。
INVALID_STRING_DATE_TIME_MICROS 字串的日期時間格式必須為 yyyy-mm-dd hh:mm:ss.sssss。
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 範圍內的兩個日期都是空值。

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

列舉說明可能的 mut 錯誤。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 這個版本無法得知收到的錯誤代碼。
RESOURCE_NOT_FOUND 找不到要求的資源。
ID_EXISTS_IN_MULTIPLE_MUTATES 無法在一個要求中變更同一項資源兩次。
INCONSISTENT_FIELD_VALUES 欄位內容與其他代表相同資料的欄位不相符。
MUTATE_NOT_ALLOWED 要求的資源不允許改變。
RESOURCE_NOT_IN_GOOGLE_ADS 這項資源不在 Google Ads 中。屬於其他廣告系統。
RESOURCE_ALREADY_EXISTS 正在建立的資源已存在。
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY 這項資源無法與「validateOnly」搭配使用。
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE 這項作業無法與「partialFailure」搭配使用。
RESOURCE_READ_ONLY 嘗試寫入唯讀欄位。

NotAllowlistedError

說明可能未加入許可清單的錯誤。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 這個版本無法得知收到的錯誤代碼。
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE 顧客尚未加入許可清單，因此無法使用這項功能。

StringFormatError

列舉說明可能的字串格式錯誤。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 這個版本無法得知收到的錯誤代碼。
ILLEGAL_CHARS 您輸入的字串值含有禁止使用的字元。
INVALID_FORMAT 您輸入的字串值不適用於相關聯的欄位。

StringLengthError

說明可能的字串長度錯誤。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 這個版本無法得知收到的錯誤代碼。
EMPTY 指定欄位中至少要有一個非空白字元。
TOO_SHORT 太短。
TOO_LONG 名稱過長。

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

僅供輸出。OS 主要版本號碼。
osMinorVersion

integer

僅供輸出。OS 子版本號碼。

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

僅供輸出。資格問題的資源名稱。

「qualifiedQuestions/{qualeligibilityQuestionId}」
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 等同於 google_product_category [Google 產品類別] ID，詳情請參閱 https://support.google.com/merchants/answer/6324436。
level

enum (ProductCategoryLevel)

僅供輸出。產品類別層級。
state

enum (ProductCategoryState)

僅供輸出。產品類別狀態。
localizations[]

object (ProductCategoryLocalization)

僅供輸出。產品類別的所有可用本地化版本清單。
productCategoryConstantParent

string

僅供輸出。父項產品類別的資源名稱。

ProductCategoryState

列舉用來說明產品類別的狀態。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
ENABLED 類別已啟用。
OBSOLETE 類別已過時，只會用於製作報表。

ProductCategoryLocalization

產品類別本地化。

JSON 表示法 
{
  "regionCode": string,
  "languageCode": string,
  "value": string
}
欄位
regionCode

string

僅供輸出。本地化類別的 ISO 3166-1 國家/地區代碼 (採大寫兩個英文字母)。
languageCode

string

僅供輸出。本地化類別的雙字母 ISO 639-1 語言代碼。
value

string

僅供輸出。指定語言代碼的類別名稱。

ProductGroupView

產品群組檢視。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。產品群組檢視畫面的資源名稱。產品群組檢視資源名稱的格式如下：

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

SearchTermView

搜尋字詞檢視畫面，內含廣告群組層級依搜尋字詞匯總的指標。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (SearchTermTargetingStatus),
  "searchTerm": string,
  "adGroup": string
}
欄位
resourceName

string

僅供輸出。搜尋字詞檢視畫面的資源名稱。搜尋字詞檢視表資源名稱的格式如下：

customers/{customerId}/searchTermViews/{campaignId}~{adGroupId}~{URL-base64_search_term}
status

enum (SearchTermTargetingStatus)

僅供輸出。表示搜尋字詞目前是您的目標或排除關鍵字。
searchTerm

string

僅供輸出。搜尋字詞。
adGroup

string

僅供輸出。放送搜尋字詞的廣告群組。

SearchTermTargetingStatus

表示搜尋字詞是其中一個指定或排除關鍵字。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
ADDED 搜尋字詞已新增至目標關鍵字中。
EXCLUDED 搜尋字詞與排除關鍵字相符。
ADDED_EXCLUDED 已加入及排除搜尋字詞。
NONE 未指定或排除搜尋字詞。

ShoppingPerformanceView

Shopping 成效資料檢視。提供購物廣告活動統計資料，這些統計資料按數個產品維度層級匯總。Merchant Center 中的產品維度值 (例如品牌、類別、自訂屬性、產品狀況和產品類型)，都會反映對應事件記錄日期和時間時，各個維度的狀態。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。購物成效檢視畫面的資源名稱。購物效能檢視畫面資源名稱的格式如下：customers/{customerId}/shoppingPerformanceView

SmartCampaignSearchTermView

智慧廣告活動搜尋字詞檢視畫面。

JSON 表示法 
{
  "resourceName": string,
  "searchTerm": string,
  "campaign": string
}
欄位
resourceName

string

僅供輸出。智慧廣告活動搜尋字詞檢視畫面的資源名稱。智慧廣告活動搜尋字詞資料檢視資源名稱的格式如下：

customers/{customerId}/smartCampaignSearchTermViews/{campaignId}~{URL-base64_search_term}
searchTerm

string

僅供輸出。搜尋字詞。
campaign

string

僅供輸出。放送搜尋字詞的智慧廣告活動。

TopicView

主題檢視區塊。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。主題檢視畫面的資源名稱。主題檢視表資源名稱的格式如下：

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

TravelActivityGroupView

旅遊活動群組檢視畫面。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。旅遊活動群組檢視畫面的資源名稱。旅遊活動群組檢視畫面資源名稱的格式如下：

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

TravelActivityPerformanceView

旅遊活動成效資料檢視。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。旅遊活動成效檢視畫面的資源名稱。旅遊活動效能檢視資源名稱的格式如下：

customers/{customerId}/travelActivityPerformanceView

UserInterest

使用者興趣：要指定的特定興趣產業。

JSON 表示法 
{
  "resourceName": string,
  "taxonomyType": enum (UserInterestTaxonomyType),
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ],
  "userInterestId": string,
  "name": string,
  "userInterestParent": string,
  "launchedToAll": boolean
}
欄位
resourceName

string

僅供輸出。使用者興趣的資源名稱。使用者興趣資源名稱的格式如下：

customers/{customerId}/userInterests/{userInterestId}
taxonomyType

enum (UserInterestTaxonomyType)

僅供輸出。使用者興趣的分類類型，
availabilities[]

object (CriterionCategoryAvailability)

僅供輸出。使用者興趣的供應情形資訊。
userInterestId

string (int64 format)

僅供輸出。使用者興趣的 ID。
name

string

僅供輸出。使用者興趣的名稱。
userInterestParent

string

僅供輸出。使用者興趣的父項。
launchedToAll

boolean

僅供輸出。如果使用者興趣適用於所有管道和地區，則為 True。

UserInterestTaxonomyType

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

僅供輸出。與提交的待開發客戶表單相關聯的 廣告群組廣告。
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、SMS 等
participantType

enum (ParticipantType)

僅供輸出。待開發客戶對話的參與者類型 (ADVERTISER 或 CONSUMER)。
lead

string

僅供輸出。與待開發客戶對話相關聯的待開發客戶資源名稱。
eventDateTime

string

僅供輸出。在地生活服務廣告建立待開發客戶對話的日期。格式為「YYYY-MM-DD HH:MM:SS」，以 Google Ads 帳戶的時區為準。範例：「2018-03-05 09:15:00」或「2018-02-01 14:34:30」
phoneCallDetails

object (PhoneCallDetails)

僅供輸出。關於 PHONE_CALL 的通話通話詳細資料。
messageDetails

object (MessageDetails)

僅供輸出。關於 EMAIL、MESSAGE 或 SMS 的訊息對話詳細資料。

ConversationType

可能的待開發客戶對話類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
EMAIL 電子郵件待開發客戶對話。
MESSAGE 訊息待開發客戶對話。
PHONE_CALL 電話待開發客戶對話。
SMS 簡訊待開發客戶對話。
BOOKING 預訂待開發客戶對話。

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」的格式。
androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

僅供輸出。在共用金鑰編碼中使用的網路類型列舉。
adGroupId

string (int64 format)

僅供輸出。在共用鍵編碼中使用的廣告群組 ID。
sharedAdGroupKey

string

僅供輸出。經過編碼的共用廣告群組金鑰的 128 位元十六進位字串，包括「0x」前置字元。您可以使用這個鍵搭配匯總轉換鍵執行位元「或」運算子，建立完整的匯總鍵，以便在 Android Privacy Sandbox 中擷取 Aggregate API 報表。

AndroidPrivacyInteractionType

列舉互動類型

列舉
UNSPECIFIED 未指定。
UNKNOWN 這個版本無法辨識這個值。
CLICK 實體點擊互動類型。
ENGAGED_VIEW 10 秒參與收視互動類型。
VIEW 觀看 (廣告曝光) 互動類型。

AndroidPrivacyNetworkType

列舉網路類型

列舉
UNSPECIFIED 未指定。
UNKNOWN 這個版本無法辨識這個值。
SEARCH 搜尋聯播網。
DISPLAY 您廣告的位置
YOUTUBE YouTube 聯播網。

AndroidPrivacySharedKeyGoogleCampaign

Google 廣告活動金鑰的 Android 隱私權共用金鑰檢視畫面。

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

string

僅供輸出。Android 隱私權共用金鑰的資源名稱。Android 隱私權共用金鑰資源名稱的格式如下：

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

string (int64 format)

僅供輸出。在共用鍵編碼中使用的廣告活動 ID。
androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

僅供輸出。在共用鍵編碼中使用的互動類型列舉。
androidPrivacyInteractionDate

string

僅供輸出。共用金鑰編碼中使用的互動日期，採用世界標準時間「YYYY-MM-DD」的格式。
sharedCampaignKey

string

僅供輸出。經過編碼的共用廣告活動金鑰的 128 位元十六進位字串，包括「0x」前置字串。您可以使用這個鍵搭配匯總轉換鍵執行位元「或」運算子，建立完整的匯總鍵，以便在 Android Privacy Sandbox 中擷取 Aggregate API 報表。

AndroidPrivacySharedKeyGoogleNetworkType

適用於 Google 網路類型金鑰的 Android 隱私權共用金鑰檢視畫面。

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

string

僅供輸出。Android 隱私權共用金鑰的資源名稱。Android 隱私權共用金鑰資源名稱的格式如下：

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

string (int64 format)

僅供輸出。在共用鍵編碼中使用的廣告活動 ID。
androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

僅供輸出。在共用鍵編碼中使用的互動類型列舉。
androidPrivacyInteractionDate

string

僅供輸出。共用金鑰編碼中使用的互動日期，採用世界標準時間「YYYY-MM-DD」的格式。
androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

僅供輸出。在共用金鑰編碼中使用的網路類型列舉。
sharedNetworkTypeKey

string

僅供輸出。經過編碼的共用網路類型金鑰的 128 位元十六進位字串，包括「0x」前置字串。您可以使用這個鍵搭配匯總轉換鍵執行位元「或」運算子，建立完整的匯總鍵，以便在 Android Privacy Sandbox 中擷取 Aggregate API 報表。

指標

指標資料。

JSON 表示法 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "skAdNetworkInstalls": string,
  "skAdNetworkTotalConversions": string,
  "publisherPurchasedClicks": string,
  "publisherOrganicClicks": string,
  "publisherUnknownClicks": string,
  "absoluteTopImpressionPercentage": number,
  "activeViewCpm": number,
  "activeViewCtr": number,
  "activeViewImpressions": string,
  "activeViewMeasurability": number,
  "activeViewMeasurableCostMicros": string,
  "activeViewMeasurableImpressions": string,
  "activeViewViewability": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allNewCustomerLifetimeValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "allConversionsFromStoreWebsite": number,
  "auctionInsightSearchAbsoluteTopImpressionPercentage": number,
  "auctionInsightSearchImpressionShare": number,
  "auctionInsightSearchOutrankingShare": number,
  "auctionInsightSearchOverlapRate": number,
  "auctionInsightSearchPositionAboveRate": number,
  "auctionInsightSearchTopImpressionPercentage": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpe": number,
  "averageCpm": number,
  "averageCpv": number,
  "averagePageViews": number,
  "averageTimeOnSite": number,
  "benchmarkAverageMaxCpc": number,
  "biddableAppInstallConversions": number,
  "biddableAppPostInstallConversions": number,
  "benchmarkCtr": number,
  "bounceRate": number,
  "clicks": string,
  "combinedClicks": string,
  "combinedClicksPerQuery": number,
  "combinedQueries": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "conversionLastReceivedRequestDateTime": string,
  "conversionLastConversionDate": string,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "conversionsValue": number,
  "newCustomerLifetimeValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "conversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "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
}
欄位
allConversionsValueByConversionDate

number

所有轉換的價值。如果選取這個資料欄和日期，日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料，請參閱 https://support.google.com/google-ads/answer/9549009。
allConversionsByConversionDate

number

轉換總次數。無論 includeInConversionsMetric 價值為何，系統都會計入所有轉換。如果選取這個資料欄和日期，日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料，請參閱 https://support.google.com/google-ads/answer/9549009。
conversionsValueByConversionDate

number

轉換價值。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。如果選取這個資料欄和日期，日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料，請參閱 https://support.google.com/google-ads/answer/9549009。
conversionsByConversionDate

number

轉換次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。如果選取這個資料欄和日期，日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料，請參閱 https://support.google.com/google-ads/answer/9549009。
historicalCreativeQualityScore

enum (QualityScoreBucket)

廣告素材歷來品質分數。
historicalLandingPageQualityScore

enum (QualityScoreBucket)

歷來到達網頁體驗的品質。
historicalSearchPredictedCtr

enum (QualityScoreBucket)

歷來搜尋預測點閱率 (CTR)。
interactionEventTypes[]

enum (InteractionEventType)

應付費和免費互動類型。
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)

來自非「發布商購買」或「發布商自然」流量的點擊
absoluteTopImpressionPercentage

number

「搜尋絕對頂端曝光比重」是指有多少百分比的搜尋廣告曝光位於最顯眼的搜尋廣告刊登位置。
activeViewCpm

number

平均可視曝光費用 (activeViewImpressions)。
activeViewCtr

number

Active View 可評估點擊次數除以 Active View 可視曝光次數。

這項指標只會針對多媒體廣告聯播網回報。
activeViewImpressions

string (int64 format)

用來評估廣告在多媒體廣告聯播網網站上可見的頻率。
activeViewMeasurability

number

Active View 可評估的曝光次數在已放送曝光次數中所佔的比例。
activeViewMeasurableCostMicros

string (int64 format)

您獲得的 Active View 可評估曝光費用。
activeViewMeasurableImpressions

string (int64 format)

廣告在刊登位置可見位置顯示的次數。
activeViewViewability

number

廣告出現在已啟用 Active View 的網站上 (可評估曝光) 且可見 (可視曝光) 的次數百分比。
allConversionsFromInteractionsRate

number

互動帶來的所有轉換 (意即瀏覽後轉換) 除以廣告互動次數。
allConversionsValue

number

所有轉換的價值。
allNewCustomerLifetimeValue

number

所有新顧客的生命週期轉換價值。如果在帳戶層級或廣告活動層級設定獲取新客目標，就會納入新顧客的額外轉換價值 (包括可出價和不可出價轉換)。如果廣告活動採用獲取新客目標，並選取「針對新顧客提高出價」，這些價值就會納入「allConversionsValue」中。詳情請參閱 https://support.google.com/google-ads/answer/12080169。
allConversions

number

轉換總次數。無論 includeInConversionsMetric 價值為何，系統都會計入所有轉換。
allConversionsValuePerCost

number

計算方式是將所有轉換的價值除以廣告互動費用 (例如點擊文字廣告或觀看影片廣告)。
allConversionsFromClickToCall

number

使用者按下廣告當下或之後，點擊「致電」按鈕致電商家的次數。計算這項數據時，電話接通與否或通話持續時間等因素不會被納入。

這項指標僅適用於動態饋給項目。
allConversionsFromDirections

number

使用者按下廣告後，點選「取得路線」按鈕前往商家的次數。

這項指標僅適用於動態饋給項目。
allConversionsFromInteractionsValuePerInteraction

number

將互動帶來的所有轉換值除以互動總數。
allConversionsFromMenu

number

使用者點擊廣告後，點擊連結查看商家選單的次數。

這項指標僅適用於動態饋給項目。
allConversionsFromOrder

number

使用者按下廣告後下單的次數。

這項指標僅適用於動態饋給項目。
allConversionsFromOtherEngagement

number

使用者按下廣告後，發生其他轉換的次數 (例如張貼評論或儲存商家地點)。

這項指標僅適用於動態饋給項目。
allConversionsFromStoreVisit

number

使用者點擊廣告後親臨門市的預估次數。

這項指標僅適用於動態饋給項目。
allConversionsFromStoreWebsite

number

使用者點擊廣告後，前往商店網址的次數。

這項指標僅適用於動態饋給項目。
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

平均千次曝光出價
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

廣告在非付費結果中獲得點擊的次數 (合併點擊次數) 除以合併查詢次數。詳情請參閱以下說明頁面：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 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。
newCustomerLifetimeValue

number

新顧客的生命週期轉換價值。如果您在帳戶層級或廣告活動層級設定獲取新客目標，就會納入可出價轉換的新顧客額外轉換價值。如果廣告活動採用獲取新客目標，並選取「針對新顧客提高出價」，這些價值就會納入「conversionsValue」來進行最佳化。詳情請參閱 https://support.google.com/google-ads/answer/12080169。
conversionsValuePerCost

number

轉換價值除以廣告互動費用。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。
conversionsFromInteractionsValuePerInteraction

number

互動轉換價值除以廣告互動次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。
conversions

number

轉換次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。
costMicros

string (int64 format)

在這段期間內，您的單次點擊出價和千次曝光出價總和。
costPerAllConversions

number

廣告互動費用除以所有轉換。
costPerConversion

number

廣告互動費用除以轉換次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。
costPerCurrentModelAttributedConversion

number

廣告互動費用除以目前的模式歸因轉換次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。
crossDeviceConversions

number

客戶在某部裝置上點擊 Google Ads 廣告，然後使用其他裝置或瀏覽器完成轉換。所有轉換已納入跨裝置轉換。
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)

飯店合作夥伴在動態饋給成效下可能獲得的曝光次數。
historicalQualityScore

string (int64 format)

歷來品質分數。
gmailForwards

string (int64 format)

廣告以訊息形式轉寄給他人的次數。
gmailSaves

string (int64 format)

使用者將您的 Gmail 廣告以郵件形式儲存到收件匣的次數。
gmailSecondaryClicks

string (int64 format)

Gmail 廣告展開狀態下的到達網頁點擊次數。
impressionsFromStoreReach

string (int64 format)

根據地點顯示的商家廣告次數。

這項指標僅適用於動態饋給項目。
impressions

string (int64 format)

廣告在搜尋結果網頁或 Google 聯播網網站上顯示的頻率。
interactionRate

number

使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。
interactions

string (int64 format)

互動次數。「互動」是指與文字廣告和購物廣告的廣告格式點擊、觀看影片廣告觀看等動作相關的主要使用者動作。
invalidClickRate

number

報表統計期內，從點擊總數 (已篩選 + 未篩選的點擊) 中篩除的點擊所佔的百分比。
invalidClicks

string (int64 format)

Google 認為點擊次數不合理，因此沒有向您收費。
messageChats

string (int64 format)

針對符合訊息追蹤資格的點選傳訊曝光發起的訊息即時通訊數量。
messageImpressions

string (int64 format)

符合訊息追蹤資格的點選傳訊息曝光次數。
messageChatRate

number

發起的即時通訊訊息 (messageChat) 除以訊息曝光次數 (訊息曝光次數)。使用者從廣告曝光中發起訊息即時通訊的比率，其中含有訊息選項和訊息追蹤。請注意，對於特定訊息曝光，這個速率可能會大於 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

使用者在非付費結果中點選您網站的搜尋結果的次數，除以傳回您網站網頁的搜尋總數 (自然查詢)。詳情請參閱以下說明頁面：https://support.google.com/google-ads/answer/3097241。
organicImpressions

string (int64 format)

網站在非付費搜尋結果中顯示的商品數量。詳情請參閱以下說明頁面：https://support.google.com/google-ads/answer/3097241。
organicImpressionsPerQuery

number

將您網站的網頁列在非付費搜尋結果中的次數 (自然曝光次數) 除以非付費結果中的搜尋結果傳回網站的次數 (自然查詢) 所得的值。詳情請參閱以下說明頁面：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

獲得的通話次數 (來電) 除以電話號碼顯示次數 (電話曝光) 所算出的比例。
relativeCtr

number

您的點閱率除以刊登您廣告的網站上，所有廣告客戶的平均點閱率。評估您的廣告在多媒體廣告聯播網網站上與其他廣告相較之下的成效。
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

曝光後任何地點途徑的通話按鈕點擊次數。這項評估資料來自以素材資源為依據的位置。
viewThroughConversionsFromLocationAssetDirections

number

曝光後任何地點表面的行車路線點擊次數。這項評估資料來自以素材資源為依據的位置。
viewThroughConversionsFromLocationAssetMenu

number

廣告曝光後，任何地點途徑的選單連結點擊次數。這項評估資料來自以素材資源為依據的位置。
viewThroughConversionsFromLocationAssetOrder

number

曝光後任何地點途徑的訂單點擊次數。這項評估資料來自以素材資源為依據的位置。
viewThroughConversionsFromLocationAssetOtherEngagement

number

曝光後任何地點途徑產生的其他本地動作點擊次數。這項評估資料來自以素材資源為依據的位置。
viewThroughConversionsFromLocationAssetStoreVisits

number

廣告曝光後親臨門市的預估次數。這項評估資料來自以素材資源為依據的位置。
viewThroughConversionsFromLocationAssetWebsite

number

廣告曝光後，在任何地點上點擊的網站網址。這項評估資料來自以素材資源為依據的位置。
orders

number

「訂單數」是指廣告為您帶來的購物轉換總數。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果轉換是歸給使用者先前與廣告的互動 (按下文字或購物廣告、觀看影片廣告等等)，就會計為一張訂單。例如：消費者點按帽子的購物廣告後，透過網站下單購買了同一款帽子和一件上衣。即使消費者購買了 2 項產品，仍只會計為 1 筆訂單。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
averageOrderValueMicros

string (int64 format)

「平均訂單價值」是指廣告促成每筆訂單帶來的平均收益。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。「平均訂單價值」是訂單總收益除以訂單總數所得的值。例如：您收到 3 筆訂單，收益分別為 NT $300 元、NT$450 元和 NT $600 元，平均訂單價值就是 $15 美元 = ($10 美元 + $15 美元 + $20 美元)/3。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
averageCartSize

number

「購物車內平均商品數」是指廣告所帶來每筆訂單中的平均產品數量。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。「平均購物車內商品數量」是售出的產品總數除以收到的訂單總數所得的值。例如：您收到 2 筆訂單，第一筆有 3 項產品，第二筆有 2 項，平均購物車內商品數量就是 2.5 項產品 = (3+2)/2。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
costOfGoodsSoldMicros

string (int64 format)

「銷貨成本」(COGS) 是指廣告訂單中售出的產品所產生的總成本。運作方式：您可以在 Merchant Center 中，為每項產品新增銷貨成本價值。如果您將透過購物車資料回報的轉換列入報表，系統便會比對售出的產品及相關銷貨成本價值，並根據這項資料計算每筆訂單產生的毛利。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元，上衣則是 $5 美元。這筆訂單的銷貨成本計算方式為 NT $90 元 + NT $150 元 = NT $240 元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
grossProfitMicros

string (int64 format)

「毛利」是指扣除銷貨成本 (COGS) 後，廣告訂單所產生的利潤。運作方式：毛利是指扣除銷貨成本後，廣告銷售所帶來的收益。計算毛利時，只會納入 Merchant Center 中具有銷貨成本價值的產品。例如：消費者點按帽子的購物廣告後，透過網站下單購買了同一款帽子和一件上衣。帽子的售價是 NT$300 元，上衣則是 NT$600 元。帽子的銷貨成本價值是 $3 美元，但上衣不具銷貨成本價值。計算這筆訂單的毛利時，只會將帽子列入考量，計算方式為 NT $300 元 - NT $90 元 = NT$210 元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
grossProfitMargin

number

「毛利率」是指在扣除銷貨成本 (COGS) 後，廣告訂單所產生的毛利百分比。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。「毛利率」是指產生的毛利除以總收益，再乘以 100% 所得出的值。計算毛利率時，只會納入 Merchant Center 中具有銷貨成本價值的產品。例如：消費者透過網站下單購買了一頂帽子和一件上衣。帽子的售價是 NT$300 元，銷貨成本價值則是 NT$90 元。上衣的售價是 $20 美元，但不具銷貨成本價值。帽子有銷貨成本價值，因此計算這筆訂單的毛利率時，只會將帽子列入考量，計算方式為 (NT$300 元 - NT$90 元)/NT$300 元 x 100% = 70%。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
revenueMicros

string (int64 format)

「收益」是指廣告訂單所產生的總金額。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。「收益」是指扣除任何折扣後，廣告的所有訂單帶來的總價值。例如：消費者點按帽子的購物廣告後，透過網站下單購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，上衣則是 $20 美元。整筆訂單提供 $5 美元的折扣。這筆訂單的收益計算方式為 (NT $300 元 + NT$600 元) - NT $150 元 = NT$750 元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
unitsSold

number

「商品售出數量」是指因廣告而獲得的訂單中的售出產品總數。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。「商品售出數量」是指因廣告而獲得的所有訂單中的售出產品總數。舉例來說，消費者點按帽子的購物廣告後，購買了同一款帽子、一件上衣和一件夾克。這筆訂單的商品售出數量為 3 個。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
crossSellCostOfGoodsSoldMicros

string (int64 format)

「交叉銷售銷貨成本」(COGS) 是指因廣告宣傳某項產品而售出其他產品所產生的總成本。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售銷貨成本」是指所售出非宣傳產品的總費用。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元，上衣則是 $5 美元。這筆訂單的交叉銷售銷貨成本為 NT $150 元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
crossSellGrossProfitMicros

string (int64 format)

「交叉銷售毛利」是指扣除銷貨成本 (COGS) 後，因廣告宣傳某項產品而售出其他產品所產生的利潤。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。購買清單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售毛利」是指扣除銷貨成本後，廣告中交叉銷售所帶來的收益。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。上衣的售價是 NT$600 元，銷貨成本價值則是 NT$150 元。這筆訂單的交叉銷售毛利計算方式為 NT $600 元 - NT $150 元 = NT$450 元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
crossSellRevenueMicros

string (int64 format)

「交叉銷售收益」是指因廣告宣傳某項產品而售出其他產品所賺取的總金額。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售收益」是指廣告中交叉銷售所產生的總價值。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，上衣則是 $20 美元。這筆訂單的交叉銷售收益為 NT $600 元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
crossSellUnitsSold

number

「交叉銷售商品售出數量」是指因廣告宣傳某項產品而售出的其他產品總數。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售商品售出數量」是指廣告的所有訂單帶來的交叉銷售產品總數。舉例來說，消費者點按帽子的購物廣告後，購買了同一款帽子、一件上衣和一件夾克。這筆訂單的交叉銷售商品售出數量為 2。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
leadCostOfGoodsSoldMicros

string (int64 format)

「廣告產品銷貨成本」(COGS) 是指因廣告宣傳產品而售出該產品的總成本。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，這些商品的成本就會計入廣告產品銷貨成本。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元，上衣則是 $5 美元。這筆訂單的廣告產品銷貨成本為 NT $90 元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
leadGrossProfitMicros

string (int64 format)

「廣告產品毛利」是指扣除銷貨成本 (COGS) 後，因廣告宣傳產品而售出該產品所產生的利潤。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，產生的銷售收益扣除銷貨成本，就是廣告產品毛利。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的售價是 NT$300 元，銷貨成本價值則是 NT$90 元。這筆訂單的廣告產品毛利計算方式為 NT $300 元 - NT $90 元 = NT$210 元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
leadRevenueMicros

string (int64 format)

「廣告產品收益」是指因廣告宣傳產品而售出該產品所賺取的總金額。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，廣告產品收益中就會顯示這些產品的銷售總價值。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，上衣則是 $20 美元。這筆訂單的廣告產品收益為 NT $300 元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
leadUnitsSold

number

「廣告商品售出數量」是指因廣告宣傳產品而售出的該產品總數。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，廣告商品售出數量中就會顯示售出產品總數。舉例來說，消費者點按帽子的購物廣告後，購買了同一款帽子、一件上衣和一件夾克。這筆訂單的廣告商品售出數量為 1。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
uniqueUsers

string (int64 format)

在指定的時間範圍內，看過您廣告的不重複使用者人數。這項指標無法匯總，且只能要求在 92 天以下的日期範圍。這項指標適用於以下類型的廣告活動：多媒體、影片、探索和應用程式。
averageImpressionFrequencyPerUser

number

在指定時間範圍內，不重複使用者看到您廣告的平均次數。這項指標無法匯總，且只能要求在 92 天以下的日期範圍。這項指標適用於以下類型的廣告活動：多媒體、影片、探索和應用程式。

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,
  "skAdNetworkConversionValue": string,
  "skAdNetworkSourceApp": {
    object (SkAdNetworkSourceApp)
  },
  "skAdNetworkSourceDomain": string,
  "skAdNetworkPostbackSequenceIndex": string,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
欄位
adDestinationType

enum (AdDestinationType)

廣告到達網頁類型。
adNetworkType

enum (AdNetworkType)

廣告聯播網類型。
budgetCampaignAssociationStatus

object (BudgetCampaignAssociationStatus)

預算廣告活動連結狀態。
clickType

enum (ClickType)

Click type.
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)

預留位置類型。這個指標只會用於動態饋給項目指標。
productChannel

enum (ProductChannel)

產品的頻道。
productChannelExclusivity

enum (ProductChannelExclusivity)

產品的通路獨佔性。
productCondition

enum (ProductCondition)

產品狀況，
recommendationType

enum (RecommendationType)

建議類型。
searchEngineResultsPageType

enum (SearchEngineResultsPageType)

搜尋引擎結果網頁的類型。
searchTermMatchType

enum (SearchTermMatchType)

觸發廣告的關鍵字比對類型 (包括變體)。
slot

enum (Slot)

廣告的位置。
conversionValueRulePrimaryDimension

enum (ConversionValueRulePrimaryDimension)

已套用轉換價值規則的主要維度。NO_RULE_APPLIED 會顯示未套用價值規則的轉換所記錄的總價值。「原始」會顯示已套用價值規則的轉換原始價值。GEO_LOCATION、DEVICE，目標對象會顯示套用價值規則後的淨調整項。
skAdNetworkUserType

enum (SkAdNetworkUserType)

iOS Store Kit 廣告聯播網使用者類型。
skAdNetworkAdEventType

enum (SkAdNetworkAdEventType)

iOS Store Kit 廣告聯播網廣告事件類型。
skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

iOS Store Kit Kit 廣告聯播網歸因功勞
skAdNetworkCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

iOS Store Kit 廣告聯播網概略的轉換價值。
skAdNetworkSourceType

enum (SkAdNetworkSourceType)

顯示帶來 iOS Store Kit Kit Network Network 安裝的廣告的來源類型。空值代表區隔不適用，例如非 iOS 廣告活動，或來源網域和來源應用程式都不在 Apple 傳送的回傳中。
newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

這項功能的用途是按照使用者是新客戶或回訪客戶來區隔轉換。這類區隔通常用於評估獲取新客目標的影響。
activityAccountId

string (int64 format)

活動帳戶 ID。
activityCity

string

提供旅遊活動的城市。
activityCountry

string

提供旅遊活動的國家/地區。
activityRating

string (int64 format)

活動評分。
activityState

string

提供旅遊活動的國家/地區。
externalActivityId

string

廣告主提供的活動編號。
adGroup

string

廣告群組的資源名稱。
assetGroup

string

素材資源群組的資源名稱。
auctionInsightDomain

string

競價分析報表中參與者的網域 (可見網址)。
campaign

string

廣告活動的資源名稱。
conversionAction

string

轉換動作的資源名稱。
conversionActionName

string

轉換動作名稱。
conversionAdjustment

boolean

系統會按照原始轉換和轉換價值，以及若經過調整後的差異值，區隔轉換欄。虛列資料則符合原本所述的方式；但「true」列現在的資料和原本說明的資料有差異。加總這兩者的調整後資料。
date

string

指標適用的日期。格式為 yyyy-MM-dd，例如「2018-04-17」。
geoTargetAirport

string

代表機場的指定地理區域常數資源名稱。
geoTargetCanton

string

代表行政區的指定地理區域常數資源名稱。
geoTargetCity

string

地理目標常數的資源名稱，該常數代表城市。
geoTargetCountry

string

代表國家/地區的指定地理區域常數資源名稱。
geoTargetCounty

string

代表郡/縣的指定地理區域常數資源名稱。
geoTargetDistrict

string

指定地理區域常數的資源名稱，該常數代表區域。
geoTargetMetro

string

代表都會區的指定地理區域常數資源名稱。
geoTargetMostSpecificLocation

string

指定地理區域常數的資源名稱，代表最明確的位置。
geoTargetPostalCode

string

代表郵遞區號的指定地理區域常數資源名稱。
geoTargetProvince

string

代表州/省的指定地理區域常數資源名稱。
geoTargetRegion

string

代表區域的指定地理區域常數資源名稱。
geoTargetState

string

代表狀態的指定地理區域常數資源名稱。
hotelBookingWindowDays

string (int64 format)

飯店預訂期 (天)。
hotelCenterId

string (int64 format)

Hotel Center ID。
hotelCheckInDate

string

飯店入住日期。格式為「yyyy-MM-dd」。
hotelCity

string

旅館所在城市。
hotelClass

integer

飯店星級。
hotelCountry

string

旅館所在國家/地區。
hotelLengthOfStay

integer

飯店入住天數。
hotelRateRuleId

string

飯店房價規則 ID。
hotelState

string

旅館所在州/省。
hour

integer

時段，以 0 到 23 (含) 之間的數字表示。
interactionOnThisExtension

boolean

只搭配動態饋給項目指標使用。指出互動指標是發生在動態饋給項目本身，還是其他額外資訊/廣告單元上。
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

產品的動態饋給標籤。
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。
skAdNetworkConversionValue

string (int64 format)

iOS Store Kit 廣告聯播網轉換價值。空值代表此區隔不適用，例如非 iOS 廣告活動。
skAdNetworkSourceApp

object (SkAdNetworkSourceApp)

應用程式在何處顯示帶來 iOS Store Kit Kit Network Network 安裝的廣告。空值代表此區隔不適用 (例如非 iOS 廣告活動)，或是 Apple 傳送的任何回傳中都不包含這個區隔。
skAdNetworkSourceDomain

string

顯示帶來 iOS Store Kit Kit Network Network 安裝的廣告所在的網站。空值代表此區隔不適用 (例如非 iOS 廣告活動)，或是 Apple 傳送的任何回傳中都不包含這個區隔。
skAdNetworkPostbackSequenceIndex

string (int64 format)

iOS Store Kit 廣告聯播網回傳序列索引。
assetInteractionTarget

object (AssetInteractionTarget)

只搭配 CustomerAsset、CampaignAsset 和 adAsset 指標使用。指出互動指標是發生在素材資源本身，還是其他素材資源/廣告單元上。當廣告放送的所有部分 (例如「廣告本身」和「網站連結」等其他元件) 一起放送時，系統會將互動 (例如點擊) 計算在內。如果 engagementOnThisAsset 為 true，代表互動位於此特定素材資源，當 engagementOnThisAsset 為 False 時，代表互動並非在特定素材資源上，而是在放送這項素材資源的其他部分發生。

AdDestinationType

列舉 Google Ads 目的地類型

列舉
UNSPECIFIED 未指定。
UNKNOWN 這個版本無法辨識這個值。
NOT_APPLICABLE 廣告不會將使用者帶往其他到達網頁
WEBSITE 網站
APP_STORE iOS App Store 或 Play 商店
PHONE_CALL 通話撥號
MAP_DIRECTIONS 地圖應用程式
LOCATION_LISTING 位置資訊專用網頁
MESSAGE 文字訊息
LEAD_FORM 待開發客戶產生表單
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS 包含不明鍵的轉換廣告到達網頁

AdNetworkType

列舉 Google Ads 聯播網類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 這個版本無法辨識這個值。
SEARCH Google 搜尋。
SEARCH_PARTNERS 搜尋聯播網夥伴。
CONTENT 您廣告的位置
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 App Store。
VIDEO_CALL_TO_ACTION_CLICKS 行動號召重疊廣告。
VIDEO_CARD_ACTION_HEADLINE_CLICKS 資訊卡。
VIDEO_END_CAP_CLICKS 結尾展示畫面。
VIDEO_WEBSITE_CLICKS 網站。
WIRELESS_PLAN 無線網路方案。
PRODUCT_LISTING_AD_LOCAL 購物 - 產品 - 本地。
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL 購物 - 產品 - 多管道本地。
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE 購物 - 產品 - 多管道線上。
PRODUCT_LISTING_ADS_COUPON 購物 - 產品 - 優待券。
PRODUCT_LISTING_AD_TRANSACTABLE 購物 - 產品 - 在 Google 上銷售。
PROMOTION_EXTENSION 促銷額外資訊。
HOTEL_PRICE 飯店房價。
PRICE_EXTENSION 價格額外資訊。
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION 在 Google 上預訂的飯店房間選項。
SHOPPING_COMPARISON_LISTING 購物 - 比較商家資訊。
CROSS_NETWORK 跨聯播網。來自最高成效廣告活動和探索廣告活動。

ConversionAttributionEventType

歸因的轉換事件類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 代表這個版本未知的值。
IMPRESSION 系統會將轉換歸因於曝光。
INTERACTION 轉換歸因於互動。

ConversionLagBucket

列舉表示曝光到轉換之間經過的天數。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
LESS_THAN_ONE_DAY 轉換時間差區間從 0 到 1 天。包含 0 天，不包含 1 天。
ONE_TO_TWO_DAYS 轉換時間差區間從 1 到 2 天。包含 1 天，不包含 2 天。
TWO_TO_THREE_DAYS 轉換時間差區間從 2 到 3 天。包含 2 天，不包含 3 天。
THREE_TO_FOUR_DAYS 轉換時間差區間從 3 到 4 天。包含 3 天，不包含 4 天。
FOUR_TO_FIVE_DAYS 轉換時間差區間從 4 到 5 天。包含 4 天，不含 5 天。
FIVE_TO_SIX_DAYS 轉換時間差區間從 5 到 6 天。包含 5 天，不含 6 天。
SIX_TO_SEVEN_DAYS 轉換時間差區間從 6 到 7 天。包含 6 天，不包含 7 天。
SEVEN_TO_EIGHT_DAYS 轉換時間差區間從 7 天到 8 天。包含 7 天，不包含 8 天。
EIGHT_TO_NINE_DAYS 轉換時間差區間從 8 天到 9 天。包含 8 天，不包含 9 天。
NINE_TO_TEN_DAYS 轉換時間差區間從 9 到 10 天。包含 9 天，不包含 10 天。
TEN_TO_ELEVEN_DAYS 轉換時間差區間從 10 到 11 天。包含 10 天，不包含 11 天。
ELEVEN_TO_TWELVE_DAYS 轉換時間差區間從 11 天到 12 天。包含 11 天，不包含 12 天。
TWELVE_TO_THIRTEEN_DAYS 轉換時間差區間從 12 到 13 天。包含 12 天，不包含 13 天。
THIRTEEN_TO_FOURTEEN_DAYS 轉換時間差區間從 13 到 14 天。包含 13 天，不包含 14 天。
FOURTEEN_TO_TWENTY_ONE_DAYS 轉換時間差區間從 14 至 21 天。包含 14 天，不包含 21 天。
TWENTY_ONE_TO_THIRTY_DAYS 轉換時間差區間從 21 到 30 天。包含 21 天，不包含 30 天。
THIRTY_TO_FORTY_FIVE_DAYS 轉換時間差區間從 30 到 45 天。包含 30 天，不包含 45 天。
FORTY_FIVE_TO_SIXTY_DAYS 轉換時間差區間從 45 天到 60 天。包含 45 天，不包含 60 天。
SIXTY_TO_NINETY_DAYS 轉換時間差區間從 60 天到 90 天。包含 60 天，不包含 90 天。

ConversionOrAdjustmentLagBucket

列舉代表從曝光到轉換之間，或曝光與轉換調整之間經過的天數。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
CONVERSION_LESS_THAN_ONE_DAY 轉換時間差區間從 0 到 1 天。包含 0 天，不包含 1 天。
CONVERSION_ONE_TO_TWO_DAYS 轉換時間差區間從 1 到 2 天。包含 1 天，不包含 2 天。
CONVERSION_TWO_TO_THREE_DAYS 轉換時間差區間從 2 到 3 天。包含 2 天，不包含 3 天。
CONVERSION_THREE_TO_FOUR_DAYS 轉換時間差區間從 3 到 4 天。包含 3 天，不包含 4 天。
CONVERSION_FOUR_TO_FIVE_DAYS 轉換時間差區間從 4 到 5 天。包含 4 天，不含 5 天。
CONVERSION_FIVE_TO_SIX_DAYS 轉換時間差區間從 5 到 6 天。包含 5 天，不含 6 天。
CONVERSION_SIX_TO_SEVEN_DAYS 轉換時間差區間從 6 到 7 天。包含 6 天，不包含 7 天。
CONVERSION_SEVEN_TO_EIGHT_DAYS 轉換時間差區間從 7 天到 8 天。包含 7 天，不包含 8 天。
CONVERSION_EIGHT_TO_NINE_DAYS 轉換時間差區間從 8 天到 9 天。包含 8 天，不包含 9 天。
CONVERSION_NINE_TO_TEN_DAYS 轉換時間差區間從 9 到 10 天。包含 9 天，不包含 10 天。
CONVERSION_TEN_TO_ELEVEN_DAYS 轉換時間差區間從 10 到 11 天。包含 10 天，不包含 11 天。
CONVERSION_ELEVEN_TO_TWELVE_DAYS 轉換時間差區間從 11 天到 12 天。包含 11 天，不包含 12 天。
CONVERSION_TWELVE_TO_THIRTEEN_DAYS 轉換時間差區間從 12 到 13 天。包含 12 天，不包含 13 天。
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS 轉換時間差區間從 13 到 14 天。包含 13 天，不包含 14 天。
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS 轉換時間差區間從 14 至 21 天。包含 14 天，不包含 21 天。
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS 轉換時間差區間從 21 到 30 天。包含 21 天，不包含 30 天。
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS 轉換時間差區間從 30 到 45 天。包含 30 天，不包含 45 天。
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS 轉換時間差區間從 45 天到 60 天。包含 45 天，不包含 60 天。
CONVERSION_SIXTY_TO_NINETY_DAYS 轉換時間差區間從 60 天到 90 天。包含 60 天，不包含 90 天。
ADJUSTMENT_LESS_THAN_ONE_DAY 轉換調整項時間差區間介於 0 至 1 天。包含 0 天，不包含 1 天。
ADJUSTMENT_ONE_TO_TWO_DAYS 轉換調整項時間差區間介於 1 至 2 天。包含 1 天，不包含 2 天。
ADJUSTMENT_TWO_TO_THREE_DAYS 轉換調整項時間差區間介於 2 至 3 天。包含 2 天，不包含 3 天。
ADJUSTMENT_THREE_TO_FOUR_DAYS 轉換調整項時間差區間介於 3 至 4 天。包含 3 天，不包含 4 天。
ADJUSTMENT_FOUR_TO_FIVE_DAYS 轉換調整項時間差區間介於 4 至 5 天。包含 4 天，不含 5 天。
ADJUSTMENT_FIVE_TO_SIX_DAYS 轉換調整項時間差區間介於 5 至 6 天。包含 5 天，不含 6 天。
ADJUSTMENT_SIX_TO_SEVEN_DAYS 轉換調整項時間差區間介於 6 至 7 天。包含 6 天，不包含 7 天。
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS 轉換調整項時間差區間介於 7 至 8 天。包含 7 天，不包含 8 天。
ADJUSTMENT_EIGHT_TO_NINE_DAYS 轉換調整項時間差區間介於 8 至 9 天。包含 8 天，不包含 9 天。
ADJUSTMENT_NINE_TO_TEN_DAYS 轉換調整項時間差區間介於 9 至 10 天。包含 9 天，不包含 10 天。
ADJUSTMENT_TEN_TO_ELEVEN_DAYS 轉換調整項時間差區間介於 10 至 11 天。包含 10 天，不包含 11 天。
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS 轉換調整項時間差區間介於 11 至 12 天。包含 11 天，不包含 12 天。
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS 轉換調整項時間差區間介於 12 至 13 天。包含 12 天，不包含 13 天。
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS 轉換調整項時間差區間介於 13 至 14 天。包含 13 天，不包含 14 天。
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS 轉換調整項時間差區間介於 14 至 21 天。包含 14 天，不包含 21 天。
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS 轉換調整項時間差區間介於 21 至 30 天。包含 21 天，不包含 30 天。
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS 轉換調整項時間差區間介於 30 至 45 天。包含 30 天，不包含 45 天。
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS 轉換調整項時間差區間介於 45 至 60 天。包含 45 天，不包含 60 天。
ADJUSTMENT_SIXTY_TO_NINETY_DAYS 轉換調整項時間差介於 60 到 90 天。包含 60 天，不包含 90 天。
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS 轉換調整項時間差介於 90 到 145 天。包含 90 天，不包含 145 天。
CONVERSION_UNKNOWN 轉換時間差類別 UNKNOWN。這是指在 Google Ads 支援轉換時間差區間之前的日期。
ADJUSTMENT_UNKNOWN 轉換調整項時間差類別 UNKNOWN。這是指在 Google Ads 支援轉換調整項時間差區間之前的日期。

ExternalConversionSource

與 ConversionAction 相關聯的外部轉換來源。

列舉
UNSPECIFIED 未指定。
UNKNOWN 代表這個版本未知的值。
WEBPAGE 這是指使用者在觀看廣告後前往特定網頁時發生的轉換；在 Google Ads 使用者介面中會顯示為「網站」。
ANALYTICS 轉換來自已連結的 Google Analytics (分析) 目標或交易，在 Google Ads 使用者介面中會顯示為「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 UI 中顯示為「行動應用程式」。
ANDROID_FIRST_OPEN 這是指使用者首次開啟 Android 應用程式時發生的轉換；在 Google Ads 使用者介面中會顯示為「Android 應用程式安裝 (初次開啟)」。
UPLOAD_CALLS 透過 ConversionUploadService 上傳的來電轉換資料；在 Google Ads 使用者介面中會顯示為「從來電匯入」。
FIREBASE 轉換來自已連結的 Firebase 事件；在 Google Ads UI 中會顯示為「Firebase」。
CLICK_TO_CALL 這是指使用者點選手機號碼時發生的轉換，在 Google Ads 使用者介面中顯示為「電話號碼點擊」。
SALESFORCE 轉換來自 Salesforce，在 Google Ads 使用者介面中會顯示為「Salesforce.com」。
STORE_SALES_CRM 轉換來自客戶關係管理系統記錄的店內購物，在 Google Ads 使用者介面中會顯示為「商店銷售 (資料合作夥伴)」。
STORE_SALES_PAYMENT_NETWORK 轉換來自付款聯播網的店內購物，在 Google Ads 使用者介面中會顯示為「商店銷售 (付款聯播網)」。
GOOGLE_PLAY 無程式碼 Google Play 轉換；在 Google Ads 使用者介面中會顯示為「Google Play」。
THIRD_PARTY_APP_ANALYTICS 轉換來自已連結的第三方應用程式分析事件；在 Google Ads 使用者介面中會顯示為「第三方應用程式分析」。
GOOGLE_ATTRIBUTION 由 Google 歸因分析控制的轉換。
STORE_SALES_DIRECT_UPLOAD 商店銷售轉換是根據第一方或第三方商家資料所上傳的。在 Google Ads 使用者介面中，顯示為「商店銷售 (直接上傳)」。
STORE_SALES 根據上傳的第三方或第三方商家資料，和/或透過付款網路中的卡片在店內購物產生的商店銷售轉換。在 Google Ads 使用者介面中顯示為「商店銷售」。
SEARCH_ADS_360 從 Search Ads 360 Floodlight 資料匯入的轉換。
GOOGLE_HOSTED 與廣告互動後，追蹤來自 Google 產品和服務的本地動作的轉換。
FLOODLIGHT Floodlight 代碼回報的轉換。
ANALYTICS_SEARCH_ADS_360 來自 Google Analytics (分析) 專為 Search Ads 360 提供的轉換。在 Google Ads 使用者介面中會顯示為 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 提供會員方案費率，並滿足基本條件，例如提供公開費率。UI 處理方式會依照公開費率加上刪除線，代表使用者可以享有折扣。如要進一步瞭解合格費率，請參閱：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 是唯一顯示的合作夥伴。

關鍵字

關鍵字條件區隔。

JSON 表示法 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
欄位
info

object (KeywordInfo)

關鍵字資訊。
adGroupCriterion

string

廣告群組條件資源名稱。

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 Google 多媒體廣告聯播網
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 Kit Network Network 安裝的廣告所在的應用程式 ID。

SkAdNetworkAttributionCredit

列舉 SkAdNetwork 歸因抵免額。

列舉
UNSPECIFIED 預設值。這個值等於空值。
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 和 adAsset 指標使用。指出互動指標是發生在素材資源本身，還是其他素材資源/廣告單元上。

ConvertingUserPriorEngagementTypeAndLtvBucket

列舉會轉換使用者先前的參與類型和生命週期價值區間

列舉
UNSPECIFIED 未指定。
UNKNOWN 這個版本無法辨識這個值。
NEW 廣告主第一次進行轉換。
RETURNING 正在轉換的使用者將回到廣告主頁面。回訪的定義因轉換類型而異 (例如第二次親臨門市與第二次線上購物)。
NEW_AND_HIGH_LTV 轉換新使用者是廣告主的新對象，生命週期價值很高。