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)

查詢中參照的 CombinedAudience。
audience

object (Audience)

查詢中參照的目標對象。
conversionAction

object (ConversionAction)

查詢中參照的轉換動作。
conversionCustomVariable

object (ConversionCustomVariable)

查詢中參照的轉換自訂變數。
conversionGoalCampaignConfig

object (ConversionGoalCampaignConfig)

查詢中參照的 ConversionGoalCampaignConfig。
conversionValueRule

object (ConversionValueRule)

查詢中參照的轉換價值規則。
conversionValueRuleSet

object (ConversionValueRuleSet)

查詢中參照的轉換價值規則組合。
clickView

object (ClickView)

查詢中參照的 ClickView。
currencyConstant

object (CurrencyConstant)

查詢中參照的貨幣常數。
customAudience

object (CustomAudience)

查詢中參照的自訂目標對象。
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)

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

帳戶層級預算。內含預算本身的相關資訊、最近核准的預算變更，以及待核准的建議變更。如有待核准的變更內容，會顯示在「pendingProposal」中。如要查看預算的有效詳細資料，請查看前置字串為「approved_」、「Adjusted_」或不含前置字元的欄位。由於部分有效詳細資料可能與使用者最初要求的資料 (例如支出限額) 不同，因此系統會透過「proposed_」和「approved_」欄位 (可能還有「adjusted_」欄位) 並列顯示這些差異。

這個資源會使用 AccountBudgetProposal 進行變異，無法直接變異。預算在任何時間最多只能有一項待處理的提案。會透過 pendingProposal 讀取。

核准後，預算可能會進行調整，例如抵免額調整。調整項會在「已核准」和「已調整」欄位之間產生差異，在其他情況下均相同。

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

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

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

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

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

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

string

僅供輸出。帳戶層級預算的資源名稱。AccountBudget 資源名稱的格式如下：

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

enum (AccountBudgetStatus)

僅供輸出。這項帳戶層級預算的狀態。
totalAdjustmentsMicros

string (int64 format)

僅供輸出。調整項總金額。

例如贈送抵免額。
amountServedMicros

string (int64 format)

僅供輸出。已放送的廣告價值 (以微量為單位)。

這包括超量放送費用，在這種情況下，系統可能會自動將抵免額套用至預算 (請參閱 totalAdjustmentsMicros)。
pendingProposal

object (PendingAccountBudgetProposal)

僅供輸出。如適用，請提供變更這筆預算的待處理提案。
id

string (int64 format)

僅供輸出。帳戶層級預算的 ID。
billingSetup

string

僅供輸出。與這個帳戶層級預算相關聯的帳單設定資源名稱。BillingSetup 資源名稱的格式如下：

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

string

僅供輸出。帳戶層級預算的名稱。
proposedStartDateTime

string

僅供輸出。帳戶層級預算的建議開始時間，格式為 yyyy-MM-dd HH:mm:ss。如果提出的開始時間類型為「現在」，則此為要求時間。
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)

僅供輸出。已核准的結束時間，以及定義明確的類型，例如「永久」。
聯集欄位 proposed_spending_limit。提案的支出上限。proposed_spending_limit 只能是下列其中一項：
proposedSpendingLimitMicros

string (int64 format)

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

enum (SpendingLimitType)

僅供輸出。建議的支出上限，必須是明確定義的類型，例如 INFINITE。

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

舉例來說，如果帳戶已支出的金額在提案獲得核准時，超過建議的支出上限，系統就會將已核准的花費上限設為已支出的金額。approved_spending_limit 只能是下列其中一項：
approvedSpendingLimitMicros

string (int64 format)

僅供輸出。已核准的支出上限 (以百萬分之一表示)。一百萬等於一個單位。只有在提案的支出上限有限時，系統才會填入這個值，且該值一律會大於或等於提案的支出上限。
approvedSpendingLimitType

enum (SpendingLimitType)

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

聯集欄位 adjusted_spending_limit。套用調整後的消費額度。調整項會儲存在 total_adjustments_micros 中。

這個值是決定帳戶可支出的金額的最終依據。adjusted_spending_limit 只能採用下列其中一種設定：
adjustedSpendingLimitMicros

string (int64 format)

僅供輸出。經調整的支出上限 (以百萬分之一表示)。一百萬等於一單位。

如果核准的花費上限沒有限制，則調整後的支出上限可能會因該預算套用的調整項類型 (如適用) 而有所不同。

如要瞭解各種調整選項，請參閱：https://support.google.com/google-ads/answer/1704323

舉例來說，扣款調整項會降低帳戶的支出上限。
adjustedSpendingLimitType

enum (SpendingLimitType)

僅供輸出。調整後的支出上限，為明確定義的類型，例如 INFINITE。只有在調整後的支出上限為無限時，才會填入這個值。如果核准的支出上限為無限，這個值一定會是無限。

AccountBudgetStatus

AccountBudget 的可能狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中的不明值。
PENDING 帳戶預算尚待核准。
APPROVED 帳戶預算已獲核准。
CANCELLED 使用者已取消帳戶預算。

PendingAccountBudgetProposal

與封閉的帳戶層級預算相關聯的待處理提案 (如適用)。

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

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

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

enum (AccountBudgetProposalType)

僅供輸出。此提案的類型，例如 END，可用於結束與此提案相關聯的預算。
accountBudgetProposal

string

僅供輸出。提案的資源名稱。AccountBudgetIdea 資源名稱格式如下：

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)

僅供輸出。結束時間和明確的類型，例如「永久」。
聯集欄位 spending_limit。支出上限。spending_limit 只能是下列其中一項：
spendingLimitMicros

string (int64 format)

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

enum (SpendingLimitType)

僅供輸出。花費上限和明確定義的類型，例如 INFINITE。

AdGroupAdAssetCombinationView

廣告群組廣告素材資源組合的使用情形。目前我們只支援回應式搜尋廣告的 AdGroupAdAssetCombinationView，但日後將支援更多廣告類型。

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

string

僅供輸出。廣告群組廣告素材資源組合檢視畫面的資源名稱。組合 ID 長度為 128 位元，其中前 64 位元會儲存在 asset_combination_id_high，後 64 位元會儲存在 asset_combination_id_low。AdGroupAdAssetCombination 檢視畫面資源名稱的格式為：customers/{customerId}/adGroupAdAssetCombinationViews/{AdGroupAd.ad_group_id}~{AdGroupAd.ad.ad_id}~{AssetCombination.asset_combination_id_low}~{AssetCombination.asset_combination_id_high}
servedAssets[]

object (AssetUsage)

僅供輸出。放送的素材資源。
enabled

boolean

僅供輸出。素材資源組合與最新版廣告之間的狀態。如果為 true，素材資源組合就會連結至最新版本的廣告。如果為 false，表示連結曾經存在，但已遭移除，且最新版本的廣告中不再顯示。

AssetUsage

內含資產的使用資訊。

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

string

資產的資源名稱。
servedAssetFieldType

enum (ServedAssetFieldType)

資產放送的欄位類型。

AdGroupAdAssetView

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

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

string

僅供輸出。廣告群組廣告素材資源檢視的資源名稱。廣告群組廣告素材資源檢視資源名稱的格式如下 (在 V4 之前)：

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

廣告群組廣告素材資源檢視畫面資源名稱的格式如下 (從 V4 開始)：

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

enum (AssetFieldType)

僅供輸出。素材資源在廣告中使用的角色。
policySummary

object (AdGroupAdAssetPolicySummary)

僅供輸出。廣告群組廣告素材資源的政策資訊。
performanceLabel

enum (AssetPerformanceLabel)

僅供輸出。素材資源連結的成效。
pinnedField

enum (ServedAssetFieldType)

僅供輸出。已固定的欄位。
source

enum (AssetSource)

僅供輸出。廣告群組廣告素材資源的來源。
adGroupAd

string

僅供輸出。素材資源所連結的廣告群組廣告。
asset

string

僅供輸出。連結至廣告群組廣告的素材資源。
enabled

boolean

僅供輸出。素材資源與最新廣告版本之間的狀態。如果為 true，素材資源就會連結至最新版本的廣告。如果為 false，表示連結曾經存在，但已遭移除，且最新版本的廣告中不再顯示。

AdGroupAdAssetPolicySummary

包含廣告群組廣告素材資源的政策資訊。

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

object (PolicyTopicEntry)

僅供輸出。列出廣告群組廣告素材資源的政策結果。
reviewStatus

enum (PolicyReviewStatus)

僅供輸出。這個廣告群組廣告素材資源目前處於審查程序的哪個階段。
approvalStatus

enum (PolicyApprovalStatus)

僅供輸出。這個廣告群組廣告素材資源的整體核准狀態，根據個別政策主題項目的狀態計算而得。

AdGroupAudienceView

廣告群組目標對象檢視。包括多媒體廣告聯播網和 YouTube 聯播網廣告的興趣和再行銷名單，以及搜尋廣告再行銷名單 (RLSA) 的成效資料，並在目標對象層級匯總。

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

string

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

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

AdGroupCriterionSimulation

廣告群組條件模擬結果。以下詳述支援的廣告管道類型、條件類型、模擬類型和模擬修改方法組合。飯店 AdGroupCriterion 模擬作業將於 V5 開始。

  1. 多媒體廣告 - 關鍵字 - CPC_出價 - 統一
  2. 搜尋 - 關鍵字 - CPC_BID - UNIFORM
  3. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM
  4. 飯店 - LISTING_GROUP - CPC_BID - UNIFORM
  5. HOTEL - 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

模擬的縮放修飾符，以預測指標為基礎。與模擬實體相關的所有 CPC 出價都會根據這個調節項調整。

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. 搜尋 - 單次點擊出價 - DEFAULT
  2. 搜尋 - 單次點擊出價 - UNIFORM
  3. 搜尋 - TARGET_CPA - UNIFORM
  4. 搜尋 - TARGET_ROAS - UNIFORM
  5. 多媒體 - CPC_BID - DEFAULT
  6. 多媒體廣告 - CPC_BID - UNIFORM
  7. 多媒體廣告 - 目標單次轉換出價 - 均一
JSON 表示法 
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "startDate": string,
  "endDate": string,

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

string

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

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

enum (SimulationType)

僅供輸出。模擬程式修改的欄位。
modificationMethod

enum (SimulationModificationMethod)

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

string (int64 format)

僅供輸出。模擬結果的廣告群組 ID。
startDate

string

僅供輸出。模擬運算的起始日期，格式為 YYYY-MM-DD。
endDate

string

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

object (CpcBidSimulationPointList)

僅供輸出。如果模擬類型為 CPC_BID，是模擬點。
cpvBidPointList

object (CpvBidSimulationPointList)

僅供輸出。如果模擬類型為 CPV_BID，則為模擬點。
targetCpaPointList

object (TargetCpaSimulationPointList)

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

object (TargetRoasSimulationPointList)

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

CpvBidSimulationPointList

用來模擬「CPV_BID」類型的模擬點的容器。

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

object (CpvBidSimulationPoint)

一系列單次收視出價金額的預估指標。

CpvBidSimulationPoint

特定單次收視出價金額的預測指標。

JSON 表示法 
{
  "cpvBidMicros": string,
  "costMicros": string,
  "impressions": string,
  "views": string
}
欄位
cpvBidMicros

string (int64 format)

模擬單次收視出價 (根據預測指標來計算)。
costMicros

string (int64 format)

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

string (int64 format)

預計曝光次數。
views

string (int64 format)

預估觀看次數。

TargetCpaSimulationPointList

用於儲存 TARGET_CPA 類型模擬點的容器。

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

object (TargetCpaSimulationPoint)

一系列目標單次轉換出價金額的預估指標。

TargetCpaSimulationPoint

特定目標單次轉換出價金額的預測指標。

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

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

string (int64 format)

廣告主必須設定每日預算 (以廣告主所用幣別的百萬分之一)，才能獲得預估流量。
appInstalls

number

應用程式安裝次數預測值。
inAppActions

number

預估的應用程式內動作次數。
biddableConversions

number

預計可出價轉換次數。
biddableConversionsValue

number

可設定出價的轉換預估總價值。
clicks

string (int64 format)

預估點擊次數。
costMicros

string (int64 format)

預估費用，以百萬分之一為單位。
impressions

string (int64 format)

預計曝光次數。
topSlotImpressions

string (int64 format)

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

string (int64 format)

互動次數預測值。只有探索廣告管道類型支援這個欄位。
聯集欄位 target_cpa_simulation_key_value。當 SimulationModificationMethod = UNIFORM 或 DEFAULT 時，會設定 target_cpa_micros。當 SimulationModificationMethod = SCALING 時，設定 target_cpa_scaling_modifier。target_cpa_simulation_key_value 只能是下列其中一項：
targetCpaMicros

string (int64 format)

模擬目標單次轉換出價，系統會根據預測指標來計算。
targetCpaScalingModifier

number

模擬資源調度修飾符，用於計算預估指標。所有與模擬實體相關的單次轉換出價目標都會由這個修飾符調整。

TargetRoasSimulationPointList

用於存放模擬點的容器，適用於類型為 TARGET_ROAS 的模擬。

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

object (TargetRoasSimulationPoint)

一系列目標廣告投資報酬率金額的預估指標。

TargetRoasSimulationPoint

特定目標廣告投資報酬率金額的預測指標。

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

string (int64 format)

廣告主必須設定的預估每日預算 (以廣告主幣別的微小單位表示)，才能獲得預估流量。
targetRoas

number

模擬目標廣告投資報酬率 (根據預測指標來計算)。
biddableConversions

number

預計可出價轉換次數。
biddableConversionsValue

number

可設定出價的轉換預估總價值。
clicks

string (int64 format)

預估點擊次數。
costMicros

string (int64 format)

預估費用，以百萬分之一為單位。
impressions

string (int64 format)

預計曝光次數。
topSlotImpressions

string (int64 format)

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

AgeRangeView

年齡層檢視畫面。

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

string

僅供輸出。年齡範圍檢視畫面的資源名稱。年齡範圍檢視畫面的資源名稱格式如下：

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

AdScheduleView

「廣告時段」檢視會按 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/{assetGroupId}~{listing_group_filter_id}
assetGroup

string

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

string

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

AssetGroupTopCombinationView

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

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

string

僅供輸出。素材資源群組熱門組合檢視畫面的資源名稱。AssetGroup Top Combination 檢視畫面的資源名稱格式為：`"customers/{customerId}/assetGroupTopCombinationViews/{assetGroupId}~{asset_combination_category}"
assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

僅供輸出。一起放送的最佳素材資源組合。

AssetGroupAssetCombinationData

素材資源群組素材資源組合資料

JSON 表示法 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
欄位
assetCombinationServedAssets[]

object (AssetUsage)

僅供輸出。已提供的素材資源。

AssetSetTypeView

素材資源組合類型檢視畫面。這個檢視畫面會針對每個素材資源集合類型回報未重複計算的指標。這份報表不包含子資產集類型。相關統計資料會匯總在父項素材資源組合類型下。

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

string

僅供輸出。資產集類型檢視畫面的資源名稱。資產集合類型檢視畫面的資源名稱格式如下：

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

enum (AssetSetType)

僅供輸出。素材資源組合類型檢視畫面的資產集類型。

BiddingStrategySimulation

出價策略模擬結果。以下詳述支援的模擬類型和模擬修改方法組合。

  1. TARGET_CPA - UNIFORM
  2. TARGET_ROAS - UNIFORM
JSON 表示法 
{
  "resourceName": string,
  "biddingStrategyId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

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

string

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

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

string (int64 format)

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

enum (SimulationType)

僅供輸出。模擬程式修改的欄位。
modificationMethod

enum (SimulationModificationMethod)

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

string

僅供輸出。模擬結果的第一天，使用 YYYY-MM-DD 格式。
endDate

string

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

object (TargetCpaSimulationPointList)

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

object (TargetRoasSimulationPointList)

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

CallView

包含來電專用廣告或來電額外資訊來電追蹤資料的來電檢視畫面。

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

string

僅供輸出。通話檢視畫面的資源名稱。呼叫檢視資源名稱的格式為：

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

string

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

string

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

string (int64 format)

僅供輸出。廣告主提供的通話時間長度 (秒)。
startCallDateTime

string

僅供輸出。廣告客戶提供的來電開始日期時間。
endCallDateTime

string

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

enum (CallTrackingDisplayLocation)

僅供輸出。通話追蹤顯示位置。
type

enum (CallType)

僅供輸出。通話類型。
callStatus

enum (GoogleVoiceCallStatus)

僅供輸出。通話狀態。

CallTrackingDisplayLocation

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

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

CallType

呼叫來源的可能屬性類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
MANUALLY_DIALED 通話是手動撥打的。

GoogleVoiceCallStatus

Google Voice 通話的可能狀態。

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

CampaignAudienceView

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

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

string

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

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

CampaignSearchTermInsight

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

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

string

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

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

string

僅供輸出。搜尋類別的標籤。空字串表示不屬於其他類別的搜尋字詞通用類別。
id

string (int64 format)

僅供輸出。洞察資料的 ID。
campaignId

string (int64 format)

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

CampaignSimulation

廣告活動模擬。以下將詳述支援的廣告管道類型、模擬類型和模擬修改方法組合。

  • 搜尋 - 單次點擊出價 - UNIFORM
  • 搜尋 - 單次點擊出價 - SCALING
  • 搜尋 - TARGET_CPA - UNIFORM
  • 搜尋 - TARGET_CPA - 滑雪
  • 搜尋 - TARGET_ROAS - UNIFORM
  • 搜尋聯播網 - TARGET_IMPRESSION_SHARE - 非表單
  • 搜尋 - 預算 - 非表單
  • 購物 - 預算 - 制服
  • 購物 - TARGET_ROAS - UNIFORM
  • MULTI_CHANNEL - TARGET_CPA - UNIFORM
  • MULTI_CHANNEL - TARGET_ROAS - UNIFORM
  • DISCOVERY - TARGET_CPA - DEFAULT
  • 多媒體廣告 - 目標單次轉換出價 - 均一
  • 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)

僅供輸出。已變更資源的類型。這會指定要在 oldResource 和 newResource 設定的資源。
changeResourceName

string

僅供輸出。發生該變更的簡單資源。
clientType

enum (ChangeClientType)

僅供輸出。變更發生的管道。
userEmail

string

僅供輸出。進行這項變更的使用者電子郵件。
oldResource

object (ChangedResource)

僅供輸出。變更前的舊資源。系統只會填入變更的欄位。
newResource

object (ChangedResource)

僅供輸出。變更後的新資源。系統只會填入變更的欄位。
resourceChangeOperation

enum (ResourceChangeOperation)

僅供輸出。變更資源的作業。
changedFields

string (FieldMask format)

僅供輸出。在傳回的資源中變更的欄位清單。

這是以半形逗號分隔的完整欄位名稱清單。範例："user.displayName,photo"。
campaign

string

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

string

僅供輸出。受這項異動影響的廣告群組。
feed

string

僅供輸出。這項變更會影響的動態饋給。
feedItem

string

僅供輸出。受這項異動影響的 FeedItem。
asset

string

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

ChangeEventResourceType

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

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

ChangeClientType

changeEvent 資源的執行來源。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN 僅用於傳回值。代表這個版本中未知的未分類用戶端類型。
GOOGLE_ADS_WEB_CLIENT 透過「ads.google.com」所做的變更。例如透過廣告活動管理所做的變更。
GOOGLE_ADS_AUTOMATED_RULE 透過 Google Ads 自動規則所做的變更。
GOOGLE_ADS_SCRIPTS 透過 Google Ads 指令碼所做的變更。
GOOGLE_ADS_BULK_UPLOAD 透過 Google Ads 大量上傳功能所做的變更。
GOOGLE_ADS_API 由 Google Ads API 所做的變更。
GOOGLE_ADS_EDITOR Google Ads 編輯器所做的變更。這個值是預留位置。API 不會傳回這些變更。
GOOGLE_ADS_MOBILE_APP 由 Google Ads 行動應用程式所做的變更。
GOOGLE_ADS_RECOMMENDATIONS 根據 Google Ads 最佳化建議所做的變更。
SEARCH_ADS_360_SYNC 透過 Search Ads 360 Sync 所做的變更。
SEARCH_ADS_360_POST 透過 Search Ads 360 Post 進行的變更。
INTERNAL_TOOL 透過內部工具所做的變更。舉例來說，當使用者針對廣告活動等實體設定網址範本時，範本會自動納入 SA360 Clickserver 網址。
OTHER 未歸類的變更類型，例如透過 Google Ads 兌換優待券所造成的變更。
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION 訂閱 Google Ads 最佳化建議後所做的變更。

ChangedResource

封裝函式原型，可呈現所有支援的資源。系統只會設定 changeResourceType 的資源。

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

object (Ad)

僅供輸出。如果 changeResourceType 等於 AD，則設為此值。
adGroup

object (AdGroup)

僅供輸出。如果 changeResourceType 等於 AD_GROUP，則設為這個值。
adGroupCriterion

object (AdGroupCriterion)

僅供輸出。如果 changeResourceType 等於 AD_GROUP_CRITERION，則設為此值。
campaign

object (Campaign)

僅供輸出。在 changeResourceType == CAMPAIGN 的情況下設定。
campaignBudget

object (CampaignBudget)

僅供輸出。若 changeResourceType == CAMPAIGN_BUDGET，請設定此屬性。
adGroupBidModifier

object (AdGroupBidModifier)

僅供輸出。如果 changeResourceType 等於 AD_GROUP_BID_MODIFIER，則會設為這個值。
campaignCriterion

object (CampaignCriterion)

僅供輸出。在 changeResourceType == CAMPAIGN_CRITERION 的情況下設定此屬性。
feed

object (Feed)

僅供輸出。如果 changeResourceType 等於 FEED，請設定這個值。
feedItem

object (FeedItem)

僅供輸出。如果 changeResourceType == FEED_ITEM，請設定此屬性。
campaignFeed

object (CampaignFeed)

僅供輸出。在 changeResourceType == CAMPAIGN_FEED 的情況下設定此屬性。
adGroupFeed

object (AdGroupFeed)

僅供輸出。如果 changeResourceType 等於 AD_GROUP_FEED，請設定這個值。
adGroupAd

object (AdGroupAd)

僅供輸出。如果 changeResourceType 等於 AD_GROUP_AD，請設定這個值。
asset

object (Asset)

僅供輸出。如果 changeResourceType 等於 ASSET，則設為此值。
customerAsset

object (CustomerAsset)

僅供輸出。如果 changeResourceType 等於 CUSTOMER_ASSET，請設定這個值。
campaignAsset

object (CampaignAsset)

僅供輸出。如果 changeResourceType 等於 CAMPAIGN_ASSET，就會設為此值。
adGroupAsset

object (AdGroupAsset)

僅供輸出。在 changeResourceType == AD_GROUP_ASSET 的情況下設定。
assetSet

object (AssetSet)

僅供輸出。在 changeResourceType == ASSET_SET 的情況下設定。
assetSetAsset

object (AssetSetAsset)

僅供輸出。如果 changeResourceType 等於 ASSET_SET_ASSET，則會設為此值。
campaignAssetSet

object (CampaignAssetSet)

僅供輸出。在 changeResourceType == CAMPAIGN_ASSET_SET 的情況下設定。

ResourceChangeOperation

changeEvent 資源中已變更資源的作業。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN 僅用於傳回值。代表這個版本不明的未分類作業。
CREATE 已建立資源。
UPDATE 資源已修改。
REMOVE 資源已移除。

ChangeStatus

說明傳回的資源的狀態。ChangeStatus 最多可能需要 3 分鐘才能反映新的變更。

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

string

僅供輸出。變更狀態的資源名稱。變更狀態資源名稱的格式如下：

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

enum (ChangeStatusResourceType)

僅供輸出。代表已變更資源的類型。這會決定要設定哪些欄位。舉例來說，系統會在「AD_GROUP」中設定「campaign」和「adGroup」的欄位。
resourceStatus

enum (ChangeStatusOperation)

僅供輸出。代表變更資源的狀態。
sharedSet

string

僅供輸出。受到這項異動影響的 SharedSet。
campaignSharedSet

string

僅供輸出。受這項異動影響的 CampaignSharedSet。
asset

string

僅供輸出。受到這項異動影響的資產。
customerAsset

string

僅供輸出。受這項異動影響的 CustomerAsset。
campaignAsset

string

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

string

僅供輸出。受到這項異動影響的廣告群組資產。
combinedAudience

string

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

string

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

string

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

string

僅供輸出。受這項異動影響的廣告群組。
adGroupAd

string

僅供輸出。受這項異動影響的 AdGroupAd。
adGroupCriterion

string

僅供輸出。受這項異動影響的 AdGroupCriterion。
campaignCriterion

string

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

string

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

string

僅供輸出。受這項異動影響的 FeedItem。
adGroupFeed

string

僅供輸出。受這項異動影響的 AdGroupFeed。
campaignFeed

string

僅供輸出。受這項異動影響的 CampaignFeed。
adGroupBidModifier

string

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

ChangeStatusResourceType

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

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN 僅用於傳回值。代表這個版本中不明的未分類資源。
AD_GROUP 廣告群組資源變更。
AD_GROUP_AD AdGroupAd 資源變更。
AD_GROUP_CRITERION AdGroupCriterion 資源變更。
CAMPAIGN 廣告活動資源變更。
CAMPAIGN_CRITERION CampaignCriterion 資源變更。
FEED 動態饋給資源變更。
FEED_ITEM FeedItem 資源變更。
AD_GROUP_FEED 廣告群組 Feed 資源變更。
CAMPAIGN_FEED CampaignFeed 資源變更。
AD_GROUP_BID_MODIFIER AdGroupBidModifier 資源變更。
SHARED_SET SharedSet 資源變更。
CAMPAIGN_SHARED_SET CampaignSharedSet 資源變更。
ASSET 素材資源變更。
CUSTOMER_ASSET CustomerAsset 資源變更。
CAMPAIGN_ASSET CampaignAsset 資源變更。
AD_GROUP_ASSET AdGroupAsset 資源變更。
COMBINED_AUDIENCE CombinedAudience 資源變更。

ChangeStatusOperation

變更資源的狀態

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN 僅用於傳回值。代表這個版本中不明的未分類資源。
ADDED 已建立資源。
CHANGED 資源已修改。
REMOVED 資源已移除。

CombinedAudience

說明合併目標對象的資源，其中包含不同的目標對象。

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

string

不可變動。合併目標對象的資源名稱。合併目標對象的名稱格式如下：

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

string (int64 format)

僅供輸出。合併目標對象的 ID。
status

enum (CombinedAudienceStatus)

僅供輸出。這個合併目標對象的狀態。指出是否已啟用或移除合併目標對象。
name

string

僅供輸出。合併目標對象的名稱。所有合併目標對象的名稱都不得重複。
description

string

僅供輸出。這個合併目標對象的說明。

CombinedAudienceStatus

列舉包含可能的合併目標對象狀態類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
ENABLED 已啟用狀態 - 已啟用合併目標對象，可供指定。
REMOVED 已移除狀態：合併目標對象已移除，無法用於指定目標。

ClickView

點擊資料檢視，內含各點擊層級匯總的指標，包括有效和無效點擊。對於非搜尋廣告活動，Metrics.clicks 代表有效和無效互動的數量。包含 ClickView 的查詢必須設有篩選器，將結果限制為一天，且可要求查詢 90 天前到要求時間的資料。

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

string

僅供輸出。點擊檢視畫面的資源名稱。點擊檢視資源名稱的格式如下：

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

object (ClickLocation)

僅供輸出。與曝光相關喜好區域相符的位置條件。
locationOfPresence

object (ClickLocation)

僅供輸出。符合曝光關聯存在位置的地區條件。
keyword

string

僅供輸出。相關聯的關鍵字 (如有)，且點擊次數對應至「搜尋」管道。
keywordInfo

object (KeywordInfo)

僅供輸出。關聯關鍵字的基本資訊 (如有)。
gclid

string

僅供輸出。Google 點擊編號。
pageNumber

string (int64 format)

僅供輸出。刊登廣告的搜尋結果頁碼。
adGroupAd

string

僅供輸出。相關聯的廣告。
campaignLocationTarget

string

僅供輸出。相關的廣告活動指定地區 (如果有的話)。
userList

string

僅供輸出。相關聯的使用者名單 (如果有的話)。

ClickLocation

與點擊相關聯的位置條件。

JSON 表示法 
{
  "city": string,
  "country": string,
  "metro": string,
  "mostSpecific": string,
  "region": string
}
欄位
city

string

與曝光相關聯的城市位置條件。
country

string

與曝光相關聯的國家/地區位置條件。
metro

string

與曝光相關聯的都會區位置條件。
mostSpecific

string

與曝光相關聯的最明確位置條件。
region

string

與曝光相關的區域地點條件。

CurrencyConstant

貨幣常數。

JSON 表示法 
{
  "resourceName": string,
  "code": string,
  "name": string,
  "symbol": string,
  "billableUnitMicros": string
}
欄位
resourceName

string

僅供輸出。貨幣常數的資源名稱。貨幣常數資源名稱格式為：

currencyConstants/{code}
code

string

僅供輸出。ISO 4217 三字母貨幣代碼，例如「USD」
name

string

僅供輸出。幣別的英文全名。
symbol

string

僅供輸出。用來說明此貨幣的標準符號，例如「$」代表美元。
billableUnitMicros

string (int64 format)

僅供輸出。此貨幣的可收費單位。帳單金額應為此值的倍數。

AccessibleBiddingStrategy

代表客戶擁有且已共用出價策略的檢視畫面。

相較於出價策略，這項資源除了涵蓋這位客戶擁有的策略外，還包括由客戶管理員擁有且與這位客戶共用的策略。這項資源不提供指標，也只會揭露一部分的 BiddingStrategy 屬性。

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

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

string

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

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

string (int64 format)

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

string

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

enum (BiddingStrategyType)

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

string (int64 format)

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

string

僅供輸出。擁有出價策略的客戶的 descriptiveName。

聯集欄位 scheme。出價架構。

只能設定一個。scheme 只能是下列其中一項：
maximizeConversionValue

object (MaximizeConversionValue)

僅供輸出。自動出價策略，可在預算範圍內為廣告活動爭取最高轉換價值。
maximizeConversions

object (MaximizeConversions)

僅供輸出。這是一種自動出價策略，可在預算範圍內為廣告活動爭取最多轉換。
targetCpa

object (TargetCpa)

僅供輸出。這是一種出價策略，可根據您指定的目標單次轉換出價設定出價，盡量爭取轉換。
targetImpressionShare

object (TargetImpressionShare)

僅供輸出。這類出價策略會根據指定的曝光百分比自動進行最佳化。
targetRoas

object (TargetRoas)

僅供輸出。一種出價策略，可在計算特定目標廣告投資報酬率的同時，盡可能提高收益。
targetSpend

object (TargetSpend)

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

盡量提高轉換價值

自動出價策略，可在預算範圍內為廣告活動爭取最高轉換價值。

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

number

僅供輸出。「目標廣告投資報酬率」選項。如果設定這項策略，出價策略會在計算目標廣告投資報酬率的同時，盡可能提高收益。如果目標廣告投資報酬率過高，出價策略可能無法用盡預算。如果未設定目標廣告投資報酬率，出價策略會盡量以預算達成最高廣告投資報酬率。

盡量爭取轉換

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

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)

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

string (int64 format)

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

CustomerClient

指定客戶與客戶端客戶之間的連結。CustomerClients 僅適用於管理員客戶。包括所有直接和間接客戶客戶，以及管理員本身。

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

string

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

string

僅供輸出。要求客戶擁有的標籤資源名稱，並套用至用戶端客戶。標籤資源名稱的格式為：

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

enum (CustomerStatus)

僅供輸出。客戶的狀態。僅供檢視。
clientCustomer

string

僅供輸出。與指定客戶相關聯的客戶端客戶資源名稱。唯讀。
hidden

boolean

僅供輸出。指出這是隱藏的帳戶。僅供檢視。
level

string (int64 format)

僅供輸出。特定顧客和客戶之間的距離。對於自連結，層級值為 0。唯讀。
timeZone

string

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

boolean

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

boolean

僅供輸出。指出客戶是否為管理員。僅供檢視。
descriptiveName

string

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

string

僅供輸出。客戶的貨幣代碼 (例如「USD」、「EUR」)。僅供檢視。
id

string (int64 format)

僅供輸出。客戶帳戶的 ID。僅供檢視。

CustomerSearchTermInsight

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

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

string

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

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

string

僅供輸出。搜尋類別的標籤。空字串代表搜尋字詞不屬於其他類別的通用類別。
id

string (int64 format)

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

DetailPlacementView

這種資料檢視，會依據廣告群組和網址或 YouTube 影片匯總指標。

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

string

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

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

enum (PlacementType)

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

string

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

string

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

string

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

string

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

PlacementType

動態饋給對應適用的刊登位置類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
WEBSITE 網站(例如「www.flowers4sale.com」)。
MOBILE_APP_CATEGORY 行動應用程式類別 (例如「遊戲」)。
MOBILE_APPLICATION 行動應用程式(例如 'mobileapp::2-com.whatsthewordanswers')。
YOUTUBE_VIDEO YouTube 影片 (例如「youtube.com/video/wtLJPvx7-ys」)。
YOUTUBE_CHANNEL YouTube 頻道(例如「youtube.com::L8ZULXASCc1I_oaOT0NaOQ」)。
GOOGLE_PRODUCTS Google 自有自營的介面(例如「tv.google.com」)。

DetailedDemographic

詳細客層：指定特定興趣的垂直類別，根據長期生活資料觸及使用者。

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

string

僅供輸出。詳細客層的資源名稱。以下是詳細客層資源名稱的格式：

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

string (int64 format)

僅供輸出。詳細客層的 ID。
name

string

僅供輸出。詳細客層的名稱。例如「最高學歷」
parent

string

僅供輸出。detailedDemographic 的父項。
launchedToAll

boolean

僅供輸出。如果所有頻道和地區都已推出詳細客層，則為 True。
availabilities[]

object (CriterionCategoryAvailability)

僅供輸出。詳細客層的可用資訊。

CriterionCategoryAvailability

每個廣告管道的適用類別資訊。

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

object (CriterionCategoryChannelAvailability)

該類別可用的管道類型和子類型。
locale[]

object (CriterionCategoryLocaleAvailability)

管道類別可用的語言代碼。

CriterionCategoryChannelAvailability

各類別提供的廣告管道類型和子類型相關資訊。

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

enum (CriterionCategoryChannelAvailabilityMode)

管道可用性的格式。可以是 ALL_CHANNELS (不會設定其他欄位)、CHANNEL_TYPE (只會設定 advertisingChannelType 類型，這個類別適用於下方所有子類型) 或 CHANNEL_TYPE_AND_SUBTYPES (會設定 advertisingChannelType、advertisingChannelSubType 和 includeDefaultChannelSubType)。
advertisingChannelType

enum (AdvertisingChannelType)

這個類別適用的管道類型。
advertisingChannelSubType[]

enum (AdvertisingChannelSubType)

這個類別適用的管道類型下方的管道子類型。
includeDefaultChannelSubType

boolean

是否包含預設管道子類型。舉例來說，如果 advertisingChannelType 為 DISPLAY，且 includeDefaultChannelSubType 為 false，表示未設定管道子類型的預設多媒體廣告活動不會納入這個可用性設定。

CriterionCategoryChannelAvailabilityMode

包含可能的 CriterionCategoryChannelAvailabilityMode 列舉。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
ALL_CHANNELS 這個類別適用於所有管道類型和子類型的廣告活動。
CHANNEL_TYPE_AND_ALL_SUBTYPES 此類別適用於特定類型的廣告活動，包括其下的所有子類型。
CHANNEL_TYPE_AND_SUBSET_SUBTYPES 此類別適用於特定類型的廣告活動和子類型。

CriterionCategoryLocaleAvailability

某個類別可供哪些語言代碼使用。

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

enum (CriterionCategoryLocaleAvailabilityMode)

可用語言代碼的格式。這個項目可以是 LAUNCHED_TO_ALL (國家/地區和語言一律空白)、COUNTRY (只設定國家/地區)、LANGUAGE (只設定語言)、COUNTRY_AND_LANGUAGE (系統會設定國家/地區和語言)。
countryCode

string

與類別相關聯的 ISO-3166-1 alpha-2 國家/地區代碼。
languageCode

string

類別相關語言的 ISO 639-1 代碼。

CriterionCategoryLocaleAvailabilityMode

包含可能的 CriterionCategoryLocaleAvailabilityMode 列舉。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
ALL_LOCALES 此類別適用於所有地區的廣告活動。
COUNTRY_AND_ALL_LANGUAGES 這個類別適用於清單中國家/地區的廣告活動，不限語言。
LANGUAGE_AND_ALL_COUNTRIES 不論國家/地區為何，適用語言清單中的廣告活動都可以使用此類別。
COUNTRY_AND_LANGUAGE 此類別適用於國家/地區、語言組合清單中的廣告活動。

DisplayKeywordView

多媒體廣告關鍵字檢視。

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

string

僅供輸出。多媒體廣告關鍵字檢視畫面的資源名稱。顯示關鍵字檢視資源名稱的格式為：

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

DistanceView

距離檢視畫面：根據使用者與廣告主地點額外資訊的距離，匯總指標。每個 DistanceBucket 都包含距離在範圍內的所有曝光，而單一曝光會為包含使用者距離的所有 DistanceBucket 提供指標。

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

string

僅供輸出。距離檢視畫面的資源名稱。距離檢視資源名稱的格式為：

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

enum (DistanceBucket)

僅供輸出。將使用者與地點額外資訊的距離分組。
metricSystem

boolean

僅供輸出。如果 DistanceBucket 使用公制單位，則為 true；否則為 false。

DistanceBucket

使用者與廣告客戶地點額外資訊之間的距離區間。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
WITHIN_700M 使用者位於該地點的 700 公尺範圍內。
WITHIN_1KM 使用者位於地區 1 公里以內。
WITHIN_5KM 使用者位於該地點的 5 公里範圍內。
WITHIN_10KM 使用者位於地區 10 公里以內。
WITHIN_15KM 使用者位於該地點的 15 公里範圍內。
WITHIN_20KM 使用者位於該地點的 20 公里範圍內。
WITHIN_25KM 使用者位於該地點的 25 公里範圍內。
WITHIN_30KM 使用者位於該位置的 30 公里範圍內。
WITHIN_35KM 使用者位於地區 35 公里內。
WITHIN_40KM 使用者位於該位置的 40 公里範圍內。
WITHIN_45KM 使用者位於地區 45 公里內。
WITHIN_50KM 使用者位於地區 50 公里內。
WITHIN_55KM 使用者位於地區 55 公里內。
WITHIN_60KM 使用者位於該位置的 60 公里範圍內。
WITHIN_65KM 使用者位於地區 65 公里內。
BEYOND_65KM 使用者位於距離指定位置 65 公里以外。
WITHIN_0_7MILES 使用者位於該地點的 0.7 英里內。
WITHIN_1MILE 使用者位於該地點的 1 英里內。
WITHIN_5MILES 使用者位於該位置的 5 英里範圍內。
WITHIN_10MILES 使用者位於地區方圓 10 英里內。
WITHIN_15MILES 使用者位於該位置的 15 英里範圍內。
WITHIN_20MILES 使用者位於地區方圓 20 英里內。
WITHIN_25MILES 使用者位於該位置的 25 英里範圍內。
WITHIN_30MILES 使用者位於該地區方圓 30 英里內。
WITHIN_35MILES 使用者位於該地區方圓 35 英里內。
WITHIN_40MILES 使用者位於距離該地 40 英里內。
BEYOND_40MILES 使用者位置超過該地區 40 英里。

DynamicSearchAdsSearchTermView

動態搜尋廣告搜尋字詞檢視畫面。

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

string

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

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

string

僅供輸出。搜尋字詞

這是唯讀欄位。
headline

string

僅供輸出。動態產生的動態搜尋廣告標題。

這是唯讀欄位。
landingPage

string

僅供輸出。曝光中動態選取的到達網頁網址。

這是唯讀欄位。
pageUrl

string

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

這是唯讀欄位。
hasNegativeKeyword

boolean

僅供輸出。如果查詢與排除關鍵字相符，則為 True。

這是唯讀欄位。
hasMatchingKeyword

boolean

僅供輸出。如果查詢已新增至指定關鍵字，則為「是」。

這是唯讀欄位。
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 頻道名稱。
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」參數。
checkInDate

string

僅供輸出。系統會在預訂完成後記錄入住日期。如果在對帳時修改入住日期，修訂後的日期則會取代這個資料欄中的原始日期。格式為 YYYY-MM-DD。
checkOutDate

string

僅供輸出。系統會在預訂完成後記錄退房日期。如果在對帳時修改入住日期，修訂後的日期則會取代這個資料欄中的原始日期。格式為 YYYY-MM-DD。
reconciledValueMicros

string (int64 format)

必要欄位。僅供輸出。已對帳金額是指房客支付的最終訂房金額。如果原始訂房價值因任何原因 (例如行程異動或升級銷售客房) 而改變，則已對帳金額應為收取的全部最終金額。取消預訂後，已對帳金額應包含任何取消費用或已收取無法退款的住宿費。值以基準單位貨幣的百萬分之一表示。舉例來說，$12.35 會以 12350000 表示。貨幣單位為客戶預設的客戶貨幣。
billed

boolean

僅供輸出。特定預訂是否已結算。結算完成後就無法修改預訂。
status

enum (HotelReconciliationStatus)

必要欄位。僅供輸出。預訂在對帳和收費方面的目前狀態。預訂費用必須在退房日期算起 45 天內完成對帳。凡是未在 45 天內對帳完畢的預訂都會以原價收費。

HotelReconciliationStatus

飯店預訂對帳狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 這個值在這個版本中未知。
RESERVATION_ENABLED 預訂的時間是未來的日期，或旅客已入住但尚未超過退房日期。無法針對仍然有效的預訂進行對帳。
RECONCILIATION_NEEDED 旅客已退房，或是已超過預訂日期但旅客並未取消。凡是沒有在退房日期算起 45 天內對帳完畢的預訂，都會依據原預訂價格收費。
RECONCILED 這些預訂已對帳。完成對帳的預訂費用會在退房日期算起 45 天後收取。
CANCELED 這項預訂已標記為取消。若取消入住的值大於零 (因設有最低住宿日數規定或取消費用)，會在退房日期算起 45 天後收費。

IncomeRangeView

收入範圍檢視。

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

string

僅供輸出。收入範圍檢視畫面的資源名稱。收入範圍檢視畫面的資源名稱格式如下：

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

KeywordView

關鍵字檢視。

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

string

僅供輸出。關鍵字檢視的資源名稱。關鍵字檢視資源名稱的格式為：

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

LandingPageView

到達網頁檢視畫面，其中的指標是在未展開的最終到達網址層級匯總。

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

string

僅供輸出。到達網頁檢視畫面的資源名稱。到達網頁檢視資源名稱的格式如下：

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

string

僅供輸出。廣告客戶指定的最終到達網址。

LanguageConstant

語言。

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

string

僅供輸出。語言常數的資源名稱。語言常數資源名稱的格式為：

languageConstants/{criterionId}
id

string (int64 format)

僅供輸出。語言常數的 ID。
code

string

僅供輸出。語言代碼，例如「en_US」、「en_AU」、「es」、「fr」等。
name

string

僅供輸出。英文全名，例如「英文 (美國)」、「西班牙文」等。
targetable

boolean

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

LocationView

地區檢視會根據地區條件總結廣告活動成效。如果未設定 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

不可變動。原始媒體檔案的下載網址 (或檔案名稱)。僅適用於 AUDIO 和 IMAGE 類型的媒體。
name

string

不可變動。媒體檔案名稱。用戶端可使用這個名稱，協助識別先前上傳的媒體。
fileSize

string (int64 format)

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

object (MediaImage)

不可變動。封裝圖片。
mediaBundle

object (MediaBundle)

不可變動。含有 HTML5 素材資源的 ZIP 封存媒體。
audio

object (MediaAudio)

僅供輸出。封裝音訊。
video

object (MediaVideo)

不可變動。封裝影片。

MediaType

媒體類型，

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

這個版本不支援接收值。

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

MediaImage

封裝圖片。

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

string (bytes format)

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

Base64 編碼字串。
fullSizeImageUrl

string

僅供輸出。圖片原始尺寸版本的網址。
previewSizeImageUrl

string

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

MediaBundle

代表含有 HTML5 素材資源的 ZIP 封存媒體。

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

string (bytes format)

不可變動。原始壓縮資料。

Base64 編碼字串。
url

string

僅供輸出。存取已上傳的壓縮資料的網址。例如：https://tpc.googlesyndication.com/simgad/123。這個欄位為唯讀。

MediaAudio

封裝音訊。

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

string (int64 format)

僅供輸出。音訊的時間長度 (以毫秒為單位)。

MediaVideo

封裝影片。

JSON 表示法 
{
  "adDurationMillis": string,
  "youtubeVideoId": string,
  "advertisingIdCode": string,
  "isciCode": string
}
欄位
adDurationMillis

string (int64 format)

僅供輸出。影片的時間長度 (以毫秒為單位)。
youtubeVideoId

string

不可變動。YouTube 影片 ID (如 YouTube 網址所示)。在 ID 中加入前置字串「https://www.youtube.com/watch?v=」，即可取得這部影片的 YouTube 串流網址。
advertisingIdCode

string

僅供輸出。這部影片的廣告數位識別碼，由美國廣告代理商協會定義，主要用於電視廣告。
isciCode

string

僅供輸出。此影片的工業標準商業識別碼 (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)

僅供輸出。員工狀態，例如 DELETED 或 ENABLED。
type

enum (LocalServicesEmployeeType)

僅供輸出。員工類型。
universityDegrees[]

object (UniversityDegree)

僅供輸出。列出這名員工已取得且想展示的學位。
residencies[]

object (Residency)

僅供輸出。員工完成居留的機構。
fellowships[]

object (Fellowship)

僅供輸出。員工完成獎學金的機構。
languagesSpoken[]

string

僅供輸出。員工所使用的語言，以 https://developers.google.com/admin-sdk/directory/v1/languages 中的語言代碼表示
categoryIds[]

string

僅供輸出。員工類別。如要查看在地生活服務類別 ID 清單，請前往 https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids。
id

string (int64 format)

僅供輸出。員工的 ID。
jobTitle

string

僅供輸出。這位員工的職稱，例如法律產業的「資深合作夥伴」。
yearStartedPracticing

integer

僅供輸出。這名員工開始從事這項專業的年份。
nationalProviderIdNumber

string

僅供輸出。與員工相關聯的 NPI ID。
emailAddress

string

僅供輸出。員工的電子郵件地址。
firstName

string

僅供輸出。員工的名字。
middleName

string

僅供輸出。員工的姓氏。
lastName

string

僅供輸出。員工的姓氏。

LocalServicesEmployeeStatus

描述在地生活服務員工狀態的列舉。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
ENABLED 員工未遭移除，且員工狀態為有效。
REMOVED 員工已遭到移除。用於從商家中刪除員工。

LocalServicesEmployeeType

描述在地生活服務員工類型的列舉。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
BUSINESS_OWNER 代表商家擁有者。
EMPLOYEE 代表商家的員工。

UniversityDegree

這位員工獲得並想加以展示的學位清單。

JSON 表示法 
{
  "institutionName": string,
  "degree": string,
  "graduationYear": integer
}
欄位
institutionName

string

僅供輸出。取得學位的大學名稱。
degree

string

僅供輸出。取得學位的名稱。
graduationYear

integer

僅供輸出。畢業年份。

居住地資訊

員工的醫療居住地詳細資料。住院資訊屬於畢業醫學教育的階段，該階段由資深臨床醫師負責監督，並提供合格的醫療專業做法。

JSON 表示法 
{
  "institutionName": string,
  "completionYear": integer
}
欄位
institutionName

string

僅供輸出。完成駐村的機構名稱。
completionYear

integer

僅供輸出。完成年份。

同工

員工的醫療福利詳細資料。住院醫師完成住院醫師訓練後，會接受一段醫療訓練。

JSON 表示法 
{
  "institutionName": string,
  "completionYear": integer
}
欄位
institutionName

string

僅供輸出。完成獎學金計畫的機構名稱。
completionYear

integer

僅供輸出。完成年份。

LocalServicesVerificationArtifact

在地生活服務驗證資源。

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

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

string

不可變動。在地生活服務驗證的資源名稱。在地生活服務驗證資源名稱的格式為：

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

string

僅供輸出。這個驗證成果的建立時間戳記。格式為 Google Ads 帳戶時區的「YYYY-MM-DD HH:MM:SS」。範例：「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

僅供輸出。判定這項背景調查案件結果的時間戳記。格式為 Google Ads 帳戶時區的「YYYY-MM-DD HH:MM:SS」。範例：「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 商家名稱與 Local Services Ads 中的商家名稱不符。
INSURANCE_AMOUNT_INSUFFICIENT 保險金額不符合該地理區域和類別 ID 組合法律摘要說明文件中所列的規定。
EXPIRED 保險文件已過期。
NO_SIGNATURE 保險文件缺少簽名。
NO_POLICY_NUMBER 保險文件缺少保單號碼。
NO_COMMERCIAL_GENERAL_LIABILITY 保險文件中未勾選商業綜合責任險 (CGL) 方塊。
EDITABLE_FORMAT 保險文件的格式可以編輯。
CATEGORY_MISMATCH 保險文件未涵蓋特定類別的保險。
MISSING_EXPIRATION_DATE 保險文件缺少到期日。
POOR_QUALITY 保險文件品質不佳 - 影像模糊、難以辨識等...
POTENTIALLY_EDITED 保險文件疑似經過編輯。
WRONG_DOCUMENT_TYPE 系統不接受保險文件。例如，我們不接受保險提案文件，但缺失責任範圍。
NON_FINAL 保險文件尚未最終確認。
OTHER 保險文件有其他未明確列出的缺陷。

LocalServicesDocumentReadOnly

含唯讀存取資料的在地生活服務文件。

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

string

網址：存取已上傳的「在地生活服務」文件。

LicenseVerificationArtifact

持有在地生活服務執照相關資訊的 proto。

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

string

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

string

僅供輸出。執照號碼。
licenseeFirstName

string

僅供輸出。執照持有人的名字。
licenseeLastName

string

僅供輸出。授權者的姓氏。
rejectionReason

enum (LocalServicesLicenseRejectionReason)

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

object (LocalServicesDocumentReadOnly)

僅供輸出。這個唯讀欄位包含上傳的執照文件資訊。

LocalServicesLicenseRejectionReason

列舉說明在地生活服務執照驗證構件的可能拒絕原因。

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

BusinessRegistrationCheckVerificationArtifact

用來保存當地服務商家登記檢查相關資訊的 proto。

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

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

enum (LocalServicesBusinessRegistrationType)

僅供輸出。商業登記核對的類型 (編號、文件)。
checkId

string

僅供輸出。支票的 ID (例如 vat_tax_id)，代表「加值稅稅號」規定。
rejectionReason

enum (LocalServicesBusinessRegistrationCheckRejectionReason)

僅供輸出。註冊文件遭拒的原因。
聯集欄位 business_registration。商業登記的註冊資訊。根據不同國家/地區的規定，這份表單應為下列其中一種格式。business_registration 只能是下列其中一項：
registrationNumber

object (BusinessRegistrationNumber)

僅供輸出。商家政府核發的號碼儲存訊息。
registrationDocument

object (BusinessRegistrationDocument)

僅供輸出。儲存商家文件資訊的訊息。

LocalServicesBusinessRegistrationType

列舉說明在地生活服務商家登記檢查驗證成果的可能註冊類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
NUMBER 登記號碼檢查類型。
DOCUMENT 登記文件檢查類型。

LocalServicesBusinessRegistrationCheckRejectionReason

列舉說明在地生活服務商家登記調查驗證構件可能遭拒的原因。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中的不明值。
BUSINESS_NAME_MISMATCH 商家名稱與 Local Services Ads 中的商家名稱不符。
BUSINESS_DETAILS_MISMATCH 商家詳細資料不一致。
ID_NOT_FOUND 找不到商業登記 ID。
POOR_DOCUMENT_IMAGE_QUALITY 上傳的文件不清晰、模糊等
DOCUMENT_EXPIRED 上傳的文件已過期。
DOCUMENT_INVALID 文件已遭撤銷或修訂。
DOCUMENT_TYPE_MISMATCH 文件類型不符。
DOCUMENT_UNVERIFIABLE 無法驗證上傳文件是否合法。
OTHER 發生問題，因此無法完成商家註冊程序。如要瞭解詳情，請與 https://support.google.com/localservices 聯絡。

BusinessRegistrationNumber

用來保存當地服務商家登記編號相關資訊的 proto。

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

string

僅供輸出。商家政府核發的號碼。

BusinessRegistrationDocument

特定當地服務商業登記文件的資訊。

JSON 表示法 
{
  "documentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
欄位
documentReadonly

object (LocalServicesDocumentReadOnly)

僅供輸出。這個唯讀欄位含有已上傳的商家登記文件相關資訊。

MobileAppCategoryConstant

行動應用程式類別常數。

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

string

僅供輸出。行動應用程式類別常數的資源名稱。行動應用程式類別常數資源名稱的格式為：

mobileAppCategoryConstants/{mobile_app_category_id}
id

integer

僅供輸出。行動應用程式類別常數的 ID。
name

string

僅供輸出。行動應用程式類別名稱。

MobileDeviceConstant

行動裝置常數。

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

string

僅供輸出。行動裝置常數的資源名稱。行動裝置常數資源名稱的格式為：

mobileDeviceConstants/{criterionId}
type

enum (MobileDeviceType)

僅供輸出。行動裝置的類型。
id

string (int64 format)

僅供輸出。行動裝置常數的 ID。
name

string

僅供輸出。行動裝置的名稱。
manufacturerName

string

僅供輸出。行動裝置的製造商。
operatingSystemName

string

僅供輸出。行動裝置的作業系統。

MobileDeviceType

行動裝置類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
MOBILE 手機。
TABLET 平板電腦。

OfflineConversionUploadClientSummary

客戶層級的離線轉換上傳摘要。

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

string

僅供輸出。客戶層級離線轉換上傳摘要的資源名稱。離線轉換上傳用戶端摘要資源名稱的格式如下：

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

enum (OfflineEventUploadClient)

僅供輸出。上傳事件的用戶端類型。
status

enum (OfflineConversionDiagnosticStatus)

僅供輸出。離線轉換客戶摘要的整體狀態。系統會根據上傳統計資料，從最近的曆法日期產生狀態。
totalEventCount

string (int64 format)

僅供輸出。上傳事件總數。
successfulEventCount

string (int64 format)

僅供輸出。成功上傳的事件總數。
successRate

number

僅供輸出。成功率。
lastUploadDateTime

string

僅供輸出。最新上傳批次的日期。格式為「yyyy-mm-dd hh:mm:ss」，以 Google Ads 帳戶的時區為準。
dailySummaries[]

object (OfflineConversionSummary)

僅供輸出。過去 N 天的歷史統計資料摘要。
jobSummaries[]

object (OfflineConversionSummary)

僅供輸出。記錄統計資料的摘要，依最近 N 項工作顯示。
alerts[]

object (OfflineConversionAlert)

僅供輸出。每個錯誤代碼的詳細資料。系統會根據最近的日期產生快訊，並顯示上傳統計資料。

OfflineEventUploadClient

用戶端類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中的不明值。
GOOGLE_ADS_API Google Ads API。
GOOGLE_ADS_WEB_CLIENT Google Ads 網路用戶端，可包含多個來源，例如 Google Ads 使用者介面、SFTP 等
ADS_DATA_CONNECTOR 連線平台。

OfflineConversionDiagnosticStatus

離線擷取設定可能的狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
EXCELLENT 離線資料擷取設定已啟用，且最適合下游處理。
GOOD 離線擷取設定已啟用，但仍有改善空間。查看快訊。
NEEDS_ATTENTION 離線擷取設定已啟用，但有錯誤，請您留意。查看快訊。
NO_RECENT_UPLOAD 離線擷取設定在過去 28 天內未收到任何資料，其中可能發生問題。

OfflineConversionSummary

按上傳日期或工作分組的歷史上傳摘要。

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

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

string (int64 format)

僅供輸出。成功事件總數。
failedCount

string (int64 format)

僅供輸出。失敗事件總數。
聯集欄位 dimension_key。摘要的維度鍵。dimension_key 只能是下列其中一項：
jobId

string (int64 format)

僅供輸出。最近 N 項工作的維度鍵。
uploadDate

string

僅供輸出。過去 N 天的維度鍵。

OfflineConversionAlert

離線轉換客戶摘要的警示。

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

object (OfflineConversionError)

僅供輸出。離線轉換用戶端快訊發生錯誤。
errorPercentage

number

僅供輸出。錯誤百分比，這個欄位的範圍應為 [0, 1.0]。

OfflineConversionError

離線轉換用戶端摘要的可能錯誤。

JSON 表示法 
{

  // Union field error_code can be only one of the following:
  "collectionSizeError": enum (CollectionSizeError),
  "conversionAdjustmentUploadError": enum (ConversionAdjustmentUploadError),
  "conversionUploadError": enum (ConversionUploadError),
  "dateError": enum (DateError),
  "distinctError": enum (DistinctError),
  "fieldError": enum (FieldError),
  "mutateError": enum (MutateError),
  "notAllowlistedError": enum (NotAllowlistedError),
  "stringFormatError": enum (StringFormatError),
  "stringLengthError": enum (StringLengthError)
  // End of list of possible types for union field error_code.
}
欄位
聯集欄位 error_code。說明發生錯誤。error_code 只能是下列其中一項：
collectionSizeError

enum (CollectionSizeError)

僅供輸出。集合大小錯誤。
conversionAdjustmentUploadError

enum (ConversionAdjustmentUploadError)

僅供輸出。轉換調整項上傳錯誤。
conversionUploadError

enum (ConversionUploadError)

僅供輸出。轉換上傳錯誤。
dateError

enum (DateError)

僅供輸出。日期錯誤。
distinctError

enum (DistinctError)

僅供輸出。不重複錯誤。
fieldError

enum (FieldError)

僅供輸出。欄位錯誤。
mutateError

enum (MutateError)

僅供輸出。更改錯誤。
notAllowlistedError

enum (NotAllowlistedError)

僅供輸出。未加入許可清單的錯誤。
stringFormatError

enum (StringFormatError)

僅供輸出。字串格式錯誤。
stringLengthError

enum (StringLengthError)

僅供輸出。字串長度錯誤。

CollectionSizeError

列舉可能的集合大小錯誤。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 這個版本不知道收到的錯誤代碼。
TOO_FEW 太少，
TOO_MANY 太多。

ConversionAdjustmentUploadError

列舉可能的轉換調整項上傳錯誤。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
TOO_RECENT_CONVERSION_ACTION 無法將事件匯入剛建立的轉換動作。請於 6 小時後再次嘗試匯入。
CONVERSION_ALREADY_RETRACTED 轉換已撤銷，系統並未處理這項調整。
CONVERSION_NOT_FOUND 找不到與這個轉換動作和轉換 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

說明可能的 CHANGE 錯誤。

列舉
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

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

'qualifyingQuestions/{qualifyingQuestionId}'
qualifyingQuestionId

string (int64 format)

僅供輸出。資格問題的 ID。
locale

string

僅供輸出。資格問題的語言。
text

string

僅供輸出。評估問題。

ParentalStatusView

家長狀態資料檢視。

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

string

僅供輸出。家長狀態檢視畫面的資源名稱。家長狀態檢視表資源名稱格式如下：

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

PerStoreView

個別商店瀏覽。這個檢視畫面提供廣告主的個別商店曝光觸及數和本地動作轉換統計資料。

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

string

僅供輸出。每個商店檢視表的資源名稱。個別商店檢視資源名稱的格式如下：

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

string

僅供輸出。個別商店檢視畫面的地點 ID。

ProductCategoryConstant

產品類別。

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

string

僅供輸出。產品類別的資源名稱。產品類別資源名稱的格式如下：

productCategoryConstants/{level}~{categoryId}
categoryId

string (int64 format)

僅供輸出。產品類別的 ID。

這個 ID 等同於 google_product_category ID，詳情請參閱本文：https://support.google.com/merchants/answer/6324436。
level

enum (ProductCategoryLevel)

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

enum (ProductCategoryState)

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

object (ProductCategoryLocalization)

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

string

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

ProductCategoryState

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

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

ProductCategoryLocalization

產品類別的本地化。

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

string

僅供輸出。經本地化的類別，由大寫的兩個英文字母組成的 ISO 3166-1 國家/地區代碼。
languageCode

string

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

string

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

ProductGroupView

產品群組檢視畫面。

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

string

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

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

SearchTermView

搜尋字詞檢視畫面，其中的指標會在廣告群組層級依搜尋字詞匯總。

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

string

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

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

enum (SearchTermTargetingStatus)

僅供輸出。指出搜尋字詞目前是您指定或排除的關鍵字之一。
searchTerm

string

僅供輸出。搜尋字詞。
adGroup

string

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

SearchTermTargetingStatus

指出搜尋字詞是其中一個指定或已排除的關鍵字。

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

ShoppingPerformanceView

購物成效資料檢視。提供在多個產品維度層級匯總的購物廣告活動統計資料。Merchant Center 中的產品維度值 (例如品牌、類別、自訂屬性、產品條件和產品類型) 則會反映每個維度在記錄相應事件時的日期和時間。

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

string

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

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

使用者興趣

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

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

僅供輸出。如果使用者的興趣已套用至所有管道和語言代碼，則為「是」。

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)

僅供輸出。國家/地區的條件編號。
targetingLocation

boolean

僅供輸出。指出是否指定了地區。

TopicConstant

根據刊登位置所屬的類別 (例如「寵物與動物/寵物/狗」)，使用主題指定或排除 Google 多媒體廣告聯播網中的刊登位置。

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

string

僅供輸出。主題常數的資源名稱。主題常數資源名稱的格式如下：

topicConstants/{topic_id}
path[]

string

僅供輸出。要指定或排除的類別。陣列中的後續元素會描述更具體的子類別。舉例來說，{"Pets & Animals", "Pets", "Dogs"} 代表「寵物與動物/寵物/狗」類別。可用的主題類別清單：https://developers.google.com/google-ads/api/reference/data/verticals
id

string (int64 format)

僅供輸出。主題的 ID。
topicConstantParent

string

僅供輸出。主題常數父項的資源名稱。

影片

影片。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "channelId": string,
  "durationMillis": string,
  "title": string
}
欄位
resourceName

string

僅供輸出。影片的資源名稱。影片資源名稱的格式如下：

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

string

僅供輸出。影片的 ID。
channelId

string

僅供輸出。影片的擁有者頻道 ID。
durationMillis

string (int64 format)

僅供輸出。影片的時間長度 (以毫秒為單位)。
title

string

僅供輸出。影片的標題。

WebpageView

網頁檢視畫面。

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

string

僅供輸出。網頁檢視畫面的資源名稱。網頁檢視資源名稱的格式如下：

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

LeadFormSubmissionData

待開發客戶表單提交資料。

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

string

僅供輸出。待開發客戶表單提交資料的資源名稱。待開發客戶表單提交資料資源名稱的格式如下：

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

string

僅供輸出。這份待開發客戶表單提交的 ID。
asset

string

僅供輸出。與提交的待開發客戶表單相關聯的素材資源。
campaign

string

僅供輸出。與所提交待開發客戶表單相關聯的廣告活動。
leadFormSubmissionFields[]

object (LeadFormSubmissionField)

僅供輸出。與待開發客戶表單相關聯的提交資料。
customLeadFormSubmissionFields[]

object (CustomLeadFormSubmissionField)

僅供輸出。與自訂待開發客戶表單相關聯的提交資料。
adGroup

string

僅供輸出。與所提交待開發客戶表單相關聯的廣告群組。
adGroupAd

string

僅供輸出。與提交的待開發客戶表單相關聯的 AdGroupAd。
gclid

string

僅供輸出。與替換的待開發客戶表單相關聯的 Google 點擊 ID。
submissionDateTime

string

僅供輸出。待開發客戶表單的提交日期和時間。格式為「yyyy-mm-dd hh:mm:ss+|-hh:mm」，例如「2019-01-01 12:32:45-08:00」。

LeadFormSubmissionField

提交的待開發客戶表單欄位。

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

enum (LeadFormFieldUserInputType)

僅供輸出。待開發客戶表單欄位的欄位類型。
fieldValue

string

僅供輸出。待開發客戶表單欄位的欄位值。

CustomLeadFormSubmissionField

提交的自訂問題中的欄位

JSON 表示法 
{
  "questionText": string,
  "fieldValue": string
}
欄位
questionText

string

僅供輸出。自訂問題的題目文字，字元數上限為 300 個。
fieldValue

string

僅供輸出。自訂問題回應的欄位值 (最多 70 個字元)。

LocalServicesLead

來自在地生活服務待開發客戶的資料。包含當使用者撥打電話、訊息或向廣告客戶預訂服務時產生的待開發客戶詳細資料。詳情請參閱：https://ads.google.com/local-services-ads

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

string

僅供輸出。在地生活服務 - 待開發客戶資料的資源名稱。在地生活服務待開發客戶資源名稱：

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

string (int64 format)

僅供輸出。待開發客戶的 ID。
categoryId

string

僅供輸出。待開發客戶的服務類別。例如 xcat:service_area_business_hvac、xcat:service_area_business_real_estate_agent 等。詳情請參閱：https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
serviceId

string

僅供輸出。服務類別。例如：buyer_agent、seller_agent 代表 xcat:service_area_business_real_estate_agent 類別。
contactDetails

object (ContactDetails)

僅供輸出。待開發客戶的聯絡資料。
leadType

enum (LeadType)

僅供輸出。在地生活服務待開發客戶類型：電話、訊息、預訂等
leadStatus

enum (LeadStatus)

僅供輸出。待開發客戶目前的狀態。
creationDateTime

string

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

string

僅供輸出。待開發客戶連結的在地生活服務供應商所使用的語言。詳情請參閱 https://developers.google.com/google-ads/api/data/codes-formats#locales
leadCharged

boolean

僅供輸出。如果廣告主為待開發客戶付費，則為 true。
note

object (Note)

僅供輸出。廣告主已為待開發客戶新增附註。
creditDetails

object (CreditDetails)

僅供輸出。待開發客戶的抵免額詳細資料。

ContactDetails

包含消費者聯絡資料的欄位。

JSON 表示法 
{
  "phoneNumber": string,
  "email": string,
  "consumerName": string
}
欄位
phoneNumber

string

僅供輸出。消費者電話號碼，格式為 E.164。
email

string

僅供輸出。消費者電子郵件地址。
consumerName

string

僅供輸出。消費者名稱 (如果消費者透過 google.com 上的訊息或預訂表單提供名稱)

LeadType

待開發客戶的可能類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中的不明值。
MESSAGE 訊息待開發客戶。
PHONE_CALL 由來電建立的待開發客戶。
BOOKING 預訂待開發客戶。

LeadStatus

待開發客戶的可能狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中的不明值。
NEW 廣告主尚未看到的新待開發客戶。
ACTIVE 廣告主曾與之互動的待開發客戶。
BOOKED 待開發客戶已預訂。
DECLINED 待開發客戶已遭廣告主拒絕。
EXPIRED 待開發客戶因閒置而過期。
DISABLED 因垃圾內容或爭議而停用。
CONSUMER_DECLINED 消費者拒絕待開發客戶。
WIPED_OUT 系統會清除待開發客戶的個人識別資訊。

注意事項

代表廣告客戶在待開發客戶中新增的附註。廣告客戶可以編輯附註，系統會重設編輯時間並變更說明。

JSON 表示法 
{
  "editDateTime": string,
  "description": string
}
欄位
editDateTime

string

僅供輸出。編輯待開發客戶附註的日期。格式為「YYYY-MM-DD HH:MM:SS」，以 Google Ads 帳戶的時區為準。範例：「2018-03-05 09:15:00」或「2018-02-01 14:34:30」
description

string

僅供輸出。待開發客戶附註內容。

CreditDetails

代表待開發客戶的信用卡詳細資料。

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

enum (CreditState)

僅供輸出。待開發客戶的信用狀態。
creditStateLastUpdateDateTime

string

僅供輸出。待開發客戶信用狀態上次更新時間的日期。格式為「YYYY-MM-DD HH:MM:SS」，以 Google Ads 帳戶的時區為準。例如：「2018-03-05 09:15:00」或「2018-02-01 14:34:30」

CreditState

待開發客戶可能的信用狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中的不明值。
PENDING 已提出抵免額申請，並由 Google Ads 後端處理中，但尚未套用至帳戶。
CREDITED 抵免額已核發至 Google Ads 帳戶。

LocalServicesLeadConversation

來自在地生活服務的待開發客戶對話資料。包含待開發客戶對話的詳細資料，這會在使用者撥打電話、訊息或向廣告主預訂服務時產生。這些資料會附加到待開發客戶。更多資訊：https://ads.google.com/local-services-ads

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

string

僅供輸出。在地生活服務 - 待開發客戶對話資料的資源名稱。在地生活服務待開發客戶對話資源名稱：

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

string (int64 format)

僅供輸出。這場待開發客戶對話的 ID。
conversationChannel

enum (ConversationType)

僅供輸出。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」前置字元。您可以使用這個鍵搭配匯總轉換鍵使用位元 OR 運算子，建立完整的匯總鍵，藉此在 Android Privacy Sandbox 中擷取匯總 API 報表。

AndroidPrivacyInteractionType

列舉互動類型

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

AndroidPrivacyNetworkType

列舉網路類型

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

AndroidPrivacySharedKeyGoogleCampaign

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

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」。您可以使用這個鍵搭配匯總轉換鍵使用位元 OR 運算子，建立完整的匯總鍵，藉此在 Android Privacy Sandbox 中擷取匯總 API 報表。

AndroidPrivacySharedKeyGoogleNetworkType

Android 隱私權共用鍵檢視畫面，用於 Google 網路類型鍵。

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」前置字元。您可以使用這個鍵搭配匯總轉換鍵使用位元 OR 運算子，建立完整的匯總鍵，藉此在 Android Privacy Sandbox 中擷取匯總 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

所有轉換的價值。如果選取這個欄和日期，日期欄中的值代表轉換日期。您可以前往 https://support.google.com/google-ads/answer/9549009 查看 by_conversion_date 欄的詳細資料。
allConversionsByConversionDate

number

轉換總數。這包含所有轉換，不論 includeInConversionsMetric 的值為何。如果選取這個欄和日期，日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料，請前往 https://support.google.com/google-ads/answer/9549009。
conversionsValueByConversionDate

number

轉換的價值。這項指標只會納入已將 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價，系統會調整您的出價策略來爭取這些轉換。如果選取這個欄和日期，日期欄中的值代表轉換日期。您可以前往 https://support.google.com/google-ads/answer/9549009 查看 by_conversion_date 欄的詳細資料。
conversionsByConversionDate

number

轉換次數。這項指標只會納入已將 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換出價，系統會調整出價策略來爭取這些轉換。如果選取這個欄和日期，日期欄中的值代表轉換日期。您可以前往 https://support.google.com/google-ads/answer/9549009 查看 by_conversion_date 欄的詳細資料。
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

平均千次曝光出價 (CPM)。
averageCpv

number

每次有人觀看您的廣告時，您需要支付的平均費用金額。計算方式是所有廣告收視次數的總費用除以觀看次數。
averagePageViews

number

每個工作階段的平均網頁瀏覽量。
averageTimeOnSite

number

將所有工作階段的總持續時間 (以秒為單位) 除以工作階段數。從 Google Analytics 匯入。
benchmarkAverageMaxCpc

number

其他廣告主對類似產品的出價。
biddableAppInstallConversions

number

應用程式安裝次數。
biddableAppPostInstallConversions

number

應用程式內動作次數。
benchmarkCtr

number

根據使用者看到廣告後按下廣告的頻率，指出其他廣告主類似產品的購物廣告成效。
bounceRate

number

使用者只造訪您網站上的單一網頁的點擊百分比。從 Google Analytics 匯入。
clicks

string (int64 format)

點擊次數。
combinedClicks

string (int64 format)

使用者點按無付費搜尋結果中廣告或網站資訊的次數。詳情請參閱說明頁面：https://support.google.com/google-ads/answer/3097241。
combinedClicksPerQuery

number

將廣告或網站在免費搜尋結果中的點擊次數 (combinedClicks) 除以 combinedQueries 後所得的值。詳情請參閱說明頁面：https://support.google.com/google-ads/answer/3097241。
combinedQueries

string (int64 format)

在免費結果中，從您的網站傳回網頁，或帶出您其中一則文字廣告的搜尋次數。詳情請參閱說明頁面：https://support.google.com/google-ads/answer/3097241。
contentBudgetLostImpressionShare

number

廣告因為預算過低而無法在多媒體廣告聯播網上顯示的次數百分比。注意：內容聯播網預算錯失的曝光比重必須介於 0 到 0.9 之間。任何超過 0.9 的值都會回報為 0.9001。
contentImpressionShare

number

將廣告從多媒體廣告聯播網獲得的曝光次數，除以預估曝光次數後所得出的百分比。注意：內容曝光比重報表的值介於 0.1 到 1 之間。0.1 以下的值會回報為 0.0999。
conversionLastReceivedRequestDateTime

string

這個轉換動作的轉換代碼上次成功觸發並被 Google Ads 偵測到的日期/時間。這個觸發事件不一定是可歸因的轉換 (比方說，代碼是從先前不是按下相應廣告主廣告的瀏覽器啟動)。日期/時間會以客戶的時區為準。
conversionLastConversionDate

string

這項轉換動作最近一次轉換的日期。日期會以客戶的時區為準。
contentRankLostImpressionShare

number

廣告因為廣告評級偏低而無法在多媒體廣告聯播網上獲得的預估曝光百分比。注意：內容排名錯失的曝光比重會以 0 到 0.9 的範圍回報。任何超過 0.9 的值都會回報為 0.9001。
conversionsFromInteractionsRate

number

互動所產生的轉換次數除以廣告互動次數 (例如點選文字廣告或觀看影片廣告)。這只包含 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用以轉換為準出價，系統會調整出價策略來爭取這些轉換。
conversionsValue

number

轉換的價值。這項指標只會納入已將 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價，系統會調整您的出價策略來爭取這些轉換。
newCustomerLifetimeValue

number

新顧客的終身轉換價值。如果您在帳戶層級或廣告活動層級設定了獲取新客目標，出價轉換會納入新顧客額外轉換價值。如果廣告活動採用獲取新客目標，並選取「為新顧客提高出價」，這些值就會納入「轉換價值」進行最佳化。詳情請參閱 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

發起訊息即時通訊的次數 (messageChats) 除以訊息曝光次數 (messageImpressions)。使用者透過廣告曝光 (已啟用訊息選項和訊息追蹤) 發起訊息即時通訊的比率。請注意，某則訊息的曝光率可能會超過 1.0。
mobileFriendlyClicksPercentage

number

前往適合透過行動裝置瀏覽的網頁的行動點擊百分比。
optimizationScoreUplift

number

所有建議的總最佳化分數升幅。
optimizationScoreUrl

string

Google Ads 網頁介面中最佳化分數頁面的網址。這項指標可以從 customer 或 campaign 選取，並按 segments.recommendation_type 區隔。舉例來說，SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer 會傳回各個不重複 (客戶、建議類型) 組合的網址。
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

獲得的來電次數 (來電次數) 除以電話號碼顯示次數 (phone 曝光) 的次數。
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

所有轉換的價值除以所有轉換的次數。如果選取這個欄和日期，日期欄中的值代表轉換日期。您可以前往 https://support.google.com/google-ads/answer/9549009 查看 by_conversion_date 欄的詳細資料。
valuePerConversion

number

轉換價值除以轉換次數。這只包含 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價，系統會調整您的出價策略來爭取這些轉換。
valuePerConversionsByConversionDate

number

轉換價值除以轉換次數。這只包含 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價，系統會調整您的出價策略來爭取這些轉換。選取這個資料欄時，日期欄中的值代表轉換日期。您可以前往 https://support.google.com/google-ads/answer/9549009 查看 by_conversion_date 欄的詳細資料。
valuePerCurrentModelAttributedConversion

number

將目前歸因模式的轉換次數除以轉換次數所得的值。這項指標只會納入已將 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價，系統會調整您的出價策略來爭取這些轉換。
videoQuartileP100Rate

number

觀眾觀看完影片的曝光次數百分比。
videoQuartileP25Rate

number

觀眾觀看您 25% 影片的曝光次數百分比。
videoQuartileP50Rate

number

觀眾觀看 50% 影片的曝光次數百分比。
videoQuartileP75Rate

number

觀眾觀看影片 75% 的曝光次數百分比。
videoViewRate

number

計算方式是 TrueView 影片廣告獲得的觀看次數除以曝光次數，動態內 TrueView 廣告的縮圖曝光次數也包含在內。
videoViews

string (int64 format)

影片廣告的觀看次數。
viewThroughConversions

string (int64 format)

瀏覽後轉換總次數。當客戶觀看圖像或互動式多媒體廣告後，在您的網站上完成轉換 (例如點擊) 其他廣告，就可能會發生這種情況。
allConversionsFromLocationAssetClickToCall

number

付費廣告事件 (點擊或曝光) 發生後，任何位置顯示的通話按鈕點擊次數。這項指標來自以素材資源為準的位置。
allConversionsFromLocationAssetDirections

number

發生可收費的廣告事件 (點擊或曝光) 後，任何地點介面上的行車路線點擊次數。這個指標來自以素材資源為基礎的地點。
allConversionsFromLocationAssetMenu

number

發生可收費廣告事件 (點擊或曝光) 後，任何位置上的選單連結點擊次數。這個指標來自以素材資源為基礎的地點。
allConversionsFromLocationAssetOrder

number

付費廣告事件 (點擊或曝光) 之後，任何地點上的訂單點擊次數。這個指標來自以素材資源為基礎的地點。
allConversionsFromLocationAssetOtherEngagement

number

在發生可收費廣告事件 (點擊或曝光) 後，任何地區途徑上其他類型本地動作的點擊次數。這項指標來自以素材資源為準的位置。
allConversionsFromLocationAssetStoreVisits

number

發生可收費廣告事件 (點擊或曝光) 後的預估親臨門市次數。這個指標來自以素材資源為基礎的地點。
allConversionsFromLocationAssetWebsite

number

發生可收費廣告事件 (點擊或曝光) 後，任何位置顯示的網站網址點擊次數。這項指標來自以素材資源為準的位置。
eligibleImpressionsFromLocationAssetStoreReach

string (int64 format)

顯示商店位置或指定地點的曝光次數。這個指標來自以素材資源為基礎的地點。
viewThroughConversionsFromLocationAssetClickToCall

number

曝光後任何地點介面獲得的通話按鈕點擊次數。這個指標來自以素材資源為基礎的地點。
viewThroughConversionsFromLocationAssetDirections

number

曝光後，在任何地點途徑上獲得的點擊次數。這項指標來自以素材資源為準的位置。
viewThroughConversionsFromLocationAssetMenu

number

曝光後任何地點上的選單連結點擊次數。這個指標來自以素材資源為基礎的地點。
viewThroughConversionsFromLocationAssetOrder

number

曝光後任何地點上的訂單點擊次數。這個指標來自以素材資源為基礎的地點。
viewThroughConversionsFromLocationAssetOtherEngagement

number

廣告曝光後在任何地區獲得的其他類型的本地動作點擊次數。這項指標來自以素材資源為準的位置。
viewThroughConversionsFromLocationAssetStoreVisits

number

廣告曝光後的預估親臨門市次數。這個指標來自以素材資源為基礎的地點。
viewThroughConversionsFromLocationAssetWebsite

number

曝光後，在任何地點途徑上點擊網站網址的次數。這個指標來自以素材資源為基礎的地點。
orders

number

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

string (int64 format)

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

number

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

number

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

string (int64 format)

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

string (int64 format)

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

星期幾，例如星期一。
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、AUDIENCE 會顯示套用價值規則後的淨調整項。
skAdNetworkUserType

enum (SkAdNetworkUserType)

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

enum (SkAdNetworkAdEventType)

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

enum (SkAdNetworkAttributionCredit)

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

enum (SkAdNetworkCoarseConversionValue)

iOS Store Kit Ad Network 粗略轉換價值。
skAdNetworkSourceType

enum (SkAdNetworkSourceType)

帶來 iOS Store Kit 廣告聯播網安裝的廣告所在的來源類型。空值表示這個區隔不適用，例如非 iOS 廣告活動，或是 Apple 傳送的任何回傳中都沒有來源網域或來源應用程式。
newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

這項參數可根據使用者是新顧客或回訪顧客，區隔轉換。這個區隔通常用於評估客戶開發目標的影響。
activityAccountId

string (int64 format)

活動帳戶 ID。
activityCity

string

可使用旅遊活動的城市。
activityCountry

string

適用旅遊活動的國家/地區。
activityRating

string (int64 format)

活動評分。
activityState

string

可提供旅遊活動的狀態。
externalActivityId

string

廣告主提供的活動 ID。
adGroup

string

廣告群組的資源名稱。
assetGroup

string

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

string

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

string

廣告活動的資源名稱。
conversionAction

string

轉換動作的資源名稱。
conversionActionName

string

轉換動作名稱。
conversionAdjustment

boolean

這樣系統就會按照原始轉換/轉換價值，以及轉換經過調整後，將轉換欄區分為原始轉換/轉換價值。假列會顯示原始資料；真列則會顯示目前資料與原始資料之間的差異。將調整後的資料總和加總。
date

string

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

string

代表機場的地理目標常數資源名稱。
geoTargetCanton

string

代表區的 GeoTarget 常數資源名稱。
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-04-01。格式為 yyyy-MM-dd。
searchSubcategory

string

搜尋字詞子類別。空白字串代表完全屬於其他子類別的搜尋字詞的通用子類別。
searchTerm

string

搜尋字詞。
webpage

string

代表網頁條件的廣告群組條件資源名稱。
week

string

定義為星期一到星期日的週，以星期一的日期表示。格式為 yyyy-MM-dd。
year

integer

年份，格式為 yyyy。
skAdNetworkConversionValue

string (int64 format)

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

object (SkAdNetworkSourceApp)

應用程式：顯示帶來 iOS Store Kit Ad Network 安裝的廣告所在的應用程式。空值表示這個區隔不適用，例如非 iOS 廣告活動，或是 Apple 傳送的任何回傳中都沒有這個區隔。
skAdNetworkSourceDomain

string

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

string (int64 format)

iOS Store Kit Ad Network 回傳序列索引。
assetInteractionTarget

object (AssetInteractionTarget)

僅適用於 CustomerAsset、CampaignAsset 和 AdGroupAsset 指標。指出互動指標是發生在素材資源本身，還是其他素材資源或廣告單元。所有廣告放送部分 (例如廣告本身和網站連結等元件) 一起放送時，系統都會計算廣告的互動 (例如點擊)。如果 InteractOnThisAsset 為 true，表示互動只發生在這個特定資產上，而互動 OnThisAsset 為 false 時，表示互動不在這項特定素材資源上，而與放送此素材資源的其他部分互動。

AdDestinationType

列舉 Google Ads 目的地類型

列舉
UNSPECIFIED 不指定。
UNKNOWN 這個值在這個版本中未知。
NOT_APPLICABLE 但不打算讓使用者離開廣告前往其他到達網頁的廣告
WEBSITE 網站
APP_STORE iOS App Store 或 Play Store
PHONE_CALL 撥號程式
MAP_DIRECTIONS 地圖應用程式
LOCATION_LISTING 專屬地點頁面
MESSAGE 文字訊息
LEAD_FORM 潛在客戶開發表單
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS 轉換的廣告到達網頁 (鍵值不明)

AdNetworkType

列舉 Google Ads 聯播網類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 這個值在這個版本中未知。
SEARCH Google 搜尋。
SEARCH_PARTNERS 搜尋合作夥伴。
CONTENT 您廣告的位置
MIXED 跨聯播網。
YOUTUBE YouTube
GOOGLE_TV Google TV

BudgetCampaignAssociationStatus

預算廣告活動關聯狀態區隔。

JSON 表示法 
{
  "status": enum (BudgetCampaignAssociationStatus),
  "campaign": string
}
欄位
status

enum (BudgetCampaignAssociationStatus)

預算廣告活動關聯狀態。
campaign

string

廣告活動資源名稱。

BudgetCampaignAssociationStatus

預算與廣告活動之間關聯的可能狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
ENABLED 廣告活動目前正在使用預算。
REMOVED 廣告活動不再使用預算。

ClickType

列舉 Google Ads 點擊類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 這個值在這個版本中未知。
BREADCRUMBS 導覽標記。
BROADBAND_PLAN 寬頻方案。
CALL_TRACKING 手動撥打的電話。
CALLS 。
CLICK_ON_ENGAGEMENT_AD 點按互動廣告。
GET_DIRECTIONS 行車路線。
LOCATION_EXPANSION 取得地點詳細資料。
LOCATION_FORMAT_CALL 撥號。
LOCATION_FORMAT_DIRECTIONS 。
LOCATION_FORMAT_IMAGE 圖片。
LOCATION_FORMAT_LANDING_PAGE 前往到達網頁。
LOCATION_FORMAT_MAP 地圖。
LOCATION_FORMAT_STORE_INFO 前往商店資訊。
LOCATION_FORMAT_TEXT 文字。
MOBILE_CALL_TRACKING 行動通話。
OFFER_PRINTS 列印優惠。
OTHER 其他。
PRODUCT_EXTENSION_CLICKS 產品加號方塊優惠。
PRODUCT_LISTING_AD_CLICKS 購物 - 產品 - 線上。
STORE_LOCATOR 顯示附近門市
URL_CLICKS 廣告標題。
VIDEO_APP_STORE_CLICKS 應用程式商店。
VIDEO_CALL_TO_ACTION_CLICKS 行動號召重疊廣告。
VIDEO_CARD_ACTION_HEADLINE_CLICKS 資訊卡。
VIDEO_END_CAP_CLICKS 結尾展示畫面。
VIDEO_WEBSITE_CLICKS 網站。
WIRELESS_PLAN 無線網路方案。
PRODUCT_LISTING_AD_LOCAL 購物 - 產品 - 本地。
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL 購物 - 產品 - 多管道本地。
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE 購物 - 產品 - 多管道線上。
PRODUCT_LISTING_ADS_COUPON 購物 - 產品 - 優待券。
PRODUCT_LISTING_AD_TRANSACTABLE 購物 - 產品 - 在 Google 上銷售。
PROMOTION_EXTENSION 促銷額外資訊。
HOTEL_PRICE 飯店價格。
PRICE_EXTENSION 價格額外資訊。
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION 在 Google 上預訂的飯店房間選項。
SHOPPING_COMPARISON_LISTING 購物 - 比較商家資訊。
CROSS_NETWORK 跨聯播網。從最高成效廣告活動和探索廣告活動匯出

ConversionAttributionEventType

歸因於轉換事件的事件類型。

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

ConversionLagBucket

列舉代表曝光與轉換之間經過的天數。

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

ConversionOrAdjustmentLagBucket

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

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
CONVERSION_LESS_THAN_ONE_DAY 轉換時間差區間介於 0 到 1 天。包含 0 天，不包含 1 天。
CONVERSION_ONE_TO_TWO_DAYS 轉換時間差區間為 1 到 2 天。包括 1 天，但不包含 2 天。
CONVERSION_TWO_TO_THREE_DAYS 轉換時間差區間為 2 到 3 天。其中包括 2 天，但不包含 3 天。
CONVERSION_THREE_TO_FOUR_DAYS 轉換時間差區間為 3 到 4 天。3 天包含在內，4 天則不包含在內。
CONVERSION_FOUR_TO_FIVE_DAYS 轉換時間差區間為 4 到 5 天。這包含 4 天，但不包含 5 天。
CONVERSION_FIVE_TO_SIX_DAYS 轉換時間差區間介於 5 到 6 天。這包含 5 天，但不包括 6 天。
CONVERSION_SIX_TO_SEVEN_DAYS 轉換時間差區間介於 6 到 7 天。包含 6 天，但不含 7 天。
CONVERSION_SEVEN_TO_EIGHT_DAYS 轉換時間差區間介於 7 到 8 天。其中包括 7 天，但不包含 8 天。
CONVERSION_EIGHT_TO_NINE_DAYS 轉換時間差值區從 8 天變更為 9 天。8 天算在內，9 天則不算在內。
CONVERSION_NINE_TO_TEN_DAYS 轉換時間差桶從 9 天變更為 10 天。9 天算在內，10 天則不算在內。
CONVERSION_TEN_TO_ELEVEN_DAYS 轉換時間差桶從 10 天改為 11 天。包括 10 天，但不包含 11 天。
CONVERSION_ELEVEN_TO_TWELVE_DAYS 轉換時間差區間從 11 天到 12 天。11 天算在內，12 天則不算在內。
CONVERSION_TWELVE_TO_THIRTEEN_DAYS 轉換時間差區間為 12 天到 13 天。其中包括 12 天，但不包含 13 天。
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS 轉換時間差的桶值從 13 天改為 14 天。其中包括 13 天，但不包含 14 天。
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS 轉換時間差值區間從 14 天改為 21 天。其中包括 14 天，但不包含 21 天。
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS 轉換時間差區間為 21 到 30 天。21 天是包含在內的，30 天則不包含在內。
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS 轉換時間差桶從 30 天變更為 45 天。包含 30 天，但不包含 45 天。
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS 轉換時間差區間為 45 到 60 天。包含 45 天，但不包含 60 天。
CONVERSION_SIXTY_TO_NINETY_DAYS 轉換時間差區間介於 60 至 90 天。包含 60 天，但不包括 90 天。
ADJUSTMENT_LESS_THAN_ONE_DAY 轉換調整延遲時間從 0 到 1 天。0 天會納入計算，1 天則不會。
ADJUSTMENT_ONE_TO_TWO_DAYS 轉換調整時間差區間為 1 到 2 天。包括 1 天，但不包含 2 天。
ADJUSTMENT_TWO_TO_THREE_DAYS 轉換調整時間差從 2 天改為 3 天。其中包括 2 天，但不包含 3 天。
ADJUSTMENT_THREE_TO_FOUR_DAYS 轉換調整時間差區間為 3 天到 4 天。其中包括 3 天，但不包含 4 天。
ADJUSTMENT_FOUR_TO_FIVE_DAYS 轉換調整時間差區間為 4 到 5 天。這包含 4 天，但不包含 5 天。
ADJUSTMENT_FIVE_TO_SIX_DAYS 轉換調整延遲時間從 5 天改為 6 天。這包含 5 天，但不包括 6 天。
ADJUSTMENT_SIX_TO_SEVEN_DAYS 轉換調整時間差區間為 6 到 7 天。6 天算在內，7 天則不算在內。
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS 轉換調整時間差從 7 天改為 8 天。其中包括 7 天，但不包含 8 天。
ADJUSTMENT_EIGHT_TO_NINE_DAYS 轉換調整時間差區間為 8 到 9 天。包含 8 天，不含 9 天。
ADJUSTMENT_NINE_TO_TEN_DAYS 轉換調整時間差從 9 天改為 10 天。這包含 9 天，但 10 天不含 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 UI 中顯示為「Android 應用程式內動作」。
IOS_IN_APP 使用者在應用程式內執行動作 (例如在 iOS 應用程式中購物) 時發生的轉換；在 Google Ads UI 中顯示為「iOS 應用程式內動作」。
IOS_FIRST_OPEN 使用者首次開啟 iOS 應用程式時發生的轉換；在 Google Ads 使用者介面中顯示為「iOS 應用程式安裝 (初次開啟)」。
APP_UNSPECIFIED 未提供 AppPlatform 的舊版應用程式轉換；在 Google Ads 使用者介面中顯示為「行動應用程式」。
ANDROID_FIRST_OPEN 使用者首次開啟 Android 應用程式時發生的轉換。在 Google Ads UI 中顯示為「Android 應用程式安裝 (首次開啟)」。
UPLOAD_CALLS 透過 ConversionUploadService 上傳的來電轉換；在 Google Ads 使用者介面中顯示為「從來電匯入」。
FIREBASE 來自已連結 Firebase 事件的轉換，在 Google Ads UI 中顯示為「Firebase」。
CLICK_TO_CALL 使用者點按行動電話號碼時發生的轉換。在 Google Ads UI 中顯示為「電話號碼點擊」。
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 DV360 Floodlight 回報的轉換。

HotelRateType

列舉可能的飯店房價類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 這個版本無法辨識該值。
UNAVAILABLE 無法取得費率類型資訊。
PUBLIC_RATE 所有人都能享有費率。
QUALIFIED_RATE 提供會員方案費率，且符合基本規定，例如提供公開費率。使用者介面會將公開費率加上刪除線，並指出使用者可享折扣。如要進一步瞭解合格房價，請造訪 https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates
PRIVATE_RATE 符合特定資格條件的使用者所享有的費率，例如所有登入使用者、20% 的行動裝置使用者、加拿大的所有行動裝置使用者等。

HotelPriceBucket

說明可能的飯店價格區間的列舉。

列舉
UNSPECIFIED 不指定。
UNKNOWN 這個值在這個版本中未知。
LOWEST_UNIQUE 唯一最低價。合作夥伴的價格最低，且沒有其他合作夥伴的價格與該價格相差不多。
LOWEST_TIED 並列最低價。合作夥伴的價格低於最低價。
NOT_LOWEST 非最低價。合作夥伴價格未達最低價格。
ONLY_PARTNER_SHOWN 目前只有顯示合作夥伴。

關鍵字

關鍵字條件區隔。

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

object (KeywordInfo)

關鍵字資訊。
adGroupCriterion

string

AdGroupCriterion 資源名稱。

SearchEngineResultsPageType

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

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中的不明值。
ADS_ONLY 搜尋引擎結果網頁只包含廣告。
ORGANIC_ONLY 搜尋引擎結果網頁只納入隨機搜尋結果。
ADS_AND_ORGANIC 搜尋引擎結果網頁中包含廣告和自然搜尋結果。

SearchTermMatchType

觸發廣告的關鍵字可能使用的比對類型 (包括變體)。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中的不明值。
BROAD 廣泛比對。
EXACT 完全比對。
PHRASE 詞組比對。
NEAR_EXACT 完全比對 (近似變體)。
NEAR_PHRASE 詞組比對 (近似變體)。

運算單元

列舉廣告的可能位置。

列舉
UNSPECIFIED 不指定。
UNKNOWN 這個值在這個版本中未知。
SEARCH_SIDE Google 搜尋：側邊。
SEARCH_TOP Google 搜尋：頂端。
SEARCH_OTHER Google 搜尋：其他。
CONTENT 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

應用程式 ID，當中顯示帶來 iOS Store Kit Kit Network Network 安裝的廣告。

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 和 AdGroupAsset 指標使用。指出互動指標是發生在素材資源本身，還是其他素材資源或廣告單元。

ConvertingUserPriorEngagementTypeAndLtvBucket

列舉已轉換使用者先前的互動類型和生命週期價值值區

列舉
UNSPECIFIED 不指定。
UNKNOWN 這個值在這個版本中未知。
NEW 轉換使用者是廣告主的新客戶。
RETURNING 轉換使用者會返回廣告主。轉換類型之間的「回訪」定義不同，例如親臨門市和線上購物。
NEW_AND_HIGH_LTV 轉換使用者是廣告主的全新客群，且具有高生命週期價值。