CData Python Connector for Google Ads

Build 25.0.9454

Changelog

General Changes

DateBuild
Number
Change
Type
Description
11/05/20259440Google AdsAdded
  • Added a CustomerId column to the following views: CarrierConstant, CurrencyConstant, CustomerSearchTermInsight, GeoTargetConstant, HotelPerformanceView, KeywordThemeConstant, LanguageConstant, LifeEvent, MobileAppCategoryConstant, MobileDeviceConstant, OperatingSystemVersionConstant, ProductCategoryConstant, QualifyingQuestion, TopicConstant, TravelActivityPerformanceView, and UserInterest.
  • Added the following views: AiMaxSearchTermAdCombinationView, CampaignSearchTermView, DetailContentSuitabilityPlacementView, FinalUrlExpansionAssetView, GroupContentSuitabilityPlacementView, and LocationInterestView.
  • Added the AdGroupAiMaxAdGroupSettingDisableSearchTermMatching and AdGroupVideoAdGroupSettingsVideoAdSequenceStepId columns to the AdGroup view.
  • Added the Device column to the AdGroupAdAssetView view.
  • Added the AdGroupCriterionBrandListSharedSet, AdGroupCriterionExtendedDemographicExtendedDemographicId, AdGroupCriterionLifeEventLifeEventId, and AdGroupCriterionVideoLineupVideoLineupId columns to the AdGroupCriterion view.
  • Added the AssetPromotionAssetPromotionBarcodeInfoBarcodeContent, AssetPromotionAssetPromotionBarcodeInfoType, AssetPromotionAssetPromotionQrCodeInfoQrCodeContent, AssetPromotionAssetTermsAndConditionsText, AssetPromotionAssetTermsAndConditionsUri, and AssetYoutubeVideoListAssetYoutubeVideos columns to the Asset view.
  • Added the AllConversionsByConversionDate, AllConversionsValueByConversionDate, AllNewCustomerLifetimeValue, AllValueAdjustment, ConversionsByConversionDate, ConversionsValueByConversionDate, NewCustomerLifetimeValue, ValueAdjustment, ValuePerAllConversionsByConversionDate, ValuePerConversionsByConversionDate, AdNetworkType, ClickType, ConversionAction, ConversionActionCategory, ConversionActionName, ConversionAdjustment, ConversionAttributionEventType, ConversionLagBucket, ConversionOrAdjustmentLagBucket, Device, ExternalConversionSource, NewVersusReturningCustomers, and Slot columns to the AssetGroup view.
  • Added the AllConversions, AllConversionsFromInteractionsRate, AllConversionsFromInteractionsValuePerInteraction, AllConversionsValue, AllConversionsValuePerCost, AverageCost, AverageCpc, Clicks, ConversionsFromInteractionsRate, ConversionsFromInteractionsValuePerInteraction, ConversionsValuePerCost, CostMicros, CostPerAllConversions, CostPerConversion, CrossDeviceConversions, CrossDeviceConversionsValue, Ctr, EngagementRate, Engagements, Impressions, InteractionRate, Interactions, ValuePerAllConversions, ViewThroughConversions, and AdNetworkType columns to the AssetGroupAsset view.
  • Added the BiddingStrategyMaximizeConversionValueTargetRoasTolerancePercentMillis, BiddingStrategyTargetRoasTargetRoasTolerancePercentMillis, ClicksUniqueQueryClusters, ConversionsUniqueQueryClusters, and ImpressionsUniqueQueryClusters columns to the BiddingStrategy view.
  • Added the CampaignAiMaxSettingBundlingRequired, CampaignAiMaxSettingEnableAiMax, CampaignContainsEuPoliticalAdvertising, CampaignMaximizeConversionValueTargetRoasTolerancePercentMillis, CampaignThirdPartyIntegrationPartnersBrandLiftIntegrationPartners, CampaignThirdPartyIntegrationPartnersBrandSafetyIntegrationPartners, CampaignThirdPartyIntegrationPartnersReachIntegrationPartners, CampaignThirdPartyIntegrationPartnersViewabilityIntegrationPartners, CampaignVideoCampaignSettingsVideoAdFormatControlFormatRestriction, CampaignVideoCampaignSettingsVideoAdFormatControlNonSkippableInStreamRestrictionsMaxDuration, CampaignVideoCampaignSettingsVideoAdFormatControlNonSkippableInStreamRestrictionsMinDuration,CampaignVideoCampaignSettingsVideoAdInventoryControlAllowNonSkippableInStream, CampaignVideoCampaignSettingsVideoAdSequenceMinimumDuration, CampaignVideoCampaignSettingsVideoAdSequenceSteps, ClicksUniqueQueryClusters, ConversionsUniqueQueryClusters, CostConvertedCurrencyPerPlatformComparableConversion, CostPerPlatformComparableConversion, ImpressionsUniqueQueryClusters, PlatformComparableConversions, PlatformComparableConversionsByConversionDate, PlatformComparableConversionsFromInteractionsRate, PlatformComparableConversionsFromInteractionsValuePerInteraction, PlatformComparableConversionsValue, PlatformComparableConversionsValueByConversionDate, PlatformComparableConversionsValuePerCost, ValuePerPlatformComparableConversion, and ValuePerPlatformComparableConversionsByConversionDate columns to the Campaign view.
  • Added the AllConversions, AllConversionsFromInteractionsRate, AllConversionsFromInteractionsValuePerInteraction, AllConversionsValue, AllConversionsValuePerCost, AverageCost, AverageCpc, Clicks, ConversionsFromInteractionsRate, ConversionsFromInteractionsValuePerInteraction, ConversionsValuePerCost, CostMicros, CostPerAllConversions, CostPerConversion, CrossDeviceConversions, CrossDeviceConversionsValue, Ctr, EngagementRate, Engagements, InteractionRate, Interactions, ValuePerAllConversions, and ViewThroughConversions columns to the ChannelAggregateAssetView view.
  • Added the AllConversions, AllConversionsFromInteractionsRate, AllConversionsFromInteractionsValuePerInteraction, AllConversionsValue, AllConversionsValuePerCost, AverageCost, AverageCpc, Clicks, ConversionsFromInteractionsRate, ConversionsFromInteractionsValuePerInteraction, ConversionsValuePerCost, CostMicros, CostPerAllConversions, CostPerConversion, CrossDeviceConversions, CrossDeviceConversionsValue, Ctr, EngagementRate, Engagements, InteractionRate, Interactions, ValuePerAllConversions, and ViewThroughConversions to the CampaignAggregateAssetView view.
  • Added the CustomerVideoCustomerThirdPartyIntegrationPartnersBrandLiftIntegrationPartners, CustomerVideoCustomerThirdPartyIntegrationPartnersBrandSafetyIntegrationPartners, CustomerVideoCustomerThirdPartyIntegrationPartnersReachIntegrationPartners, CustomerVideoCustomerThirdPartyIntegrationPartnersViewabilityIntegrationPartners, ClicksUniqueQueryClusters, ConversionsUniqueQueryClusters, CostConvertedCurrencyPerPlatformComparableConversion, CostPerPlatformComparableConversion, ImpressionsUniqueQueryClusters, PlatformComparableConversions, PlatformComparableConversionsByConversionDate, PlatformComparableConversionsFromInteractionsRate, PlatformComparableConversionsFromInteractionsValuePerInteraction, PlatformComparableConversionsValue, PlatformComparableConversionsValueByConversionDate, PlatformComparableConversionsValuePerCost, ValuePerPlatformComparableConversion, and ValuePerPlatformComparableConversionsByConversionDate columns to the Customer view.
  • Added the CustomerNegativeCriterionPlacementListSharedSet column to the CustomerNegativeCriterion view.
  • Added the LandingPageSource column to the ExpandedLandingPageView view.
  • Added the MatchType column to the KeywordView view.
  • Added the LandingPageSource column to the LandingPageView view.
  • Added the SearchTermMatchSource column to the SearchTermView view.
  • Added the SharedCriterionWebpageConditions, SharedCriterionWebpageCoveragePercentage, SharedCriterionWebpageCriterionName, and SharedCriterionWebpageSampleSampleUrls columns to the SharedCriterion view.
  • Added the CampaignCriterionExtendedDemographicExtendedDemographicId, CampaignCriterionLifeEventLifeEventId, CampaignCriterionVideoLineupVideoLineupId, and CampaignCriterionWebpageListSharedSet columns to the CampaignCriterion view.
  • Added the ChangeStatusAssetSet and ChangeStatusCampaignAssetSet columns to the ChangeStatus view.
  • In the AdGroup view, added the RELATED_YOUTUBE_VIDEOS enum to the AdGroupExcludedParentAssetFieldTypes column and the PAUSE enum to the AdGroupPrimaryStatus view.
  • In the AdGroupAd view, added the PAUSE enum to the AdFormatType column.
  • In the AdGroupAdAssetView view, added the RELATED_YOUTUBE_VIDEOS enum to the AdGroupAdAssetViewFieldType column, the DESCRIPTION_PREFIX enum to the AdGroupAdAssetViewPinnedField column, and the PAUSE enum to the AdFormatType.
  • In the AdGroupAssset view, added the RELATED_YOUTUBE_VIDEOS enum to the AdGroupAssetFieldType column.
  • In the AdGroupCriterion view, added the PLACEMENT_LIST, VIDEO_LINEUP, and WEBPAGE_LIST enums to the AdGroupCriterionType column.
  • In the Asset view, added the YOUTUBE_VIDEO_LIST enum to the AssetType column.
  • In the AssetFieldTypeView view, added the RELATED_YOUTUBE_VIDEOS enum to the AssetFieldTypeViewFieldType column.
  • In the AssetGroupAsset view, added the RELATED_YOUTUBE_VIDEOS to the AssetGroupAssetFieldType column.
  • In the Campaign view, added the RELATED_YOUTUBE_VIDEOS enum to the CampaignExcludedParentAssetFieldTypes column, the MISSING_LOCATION_TARGETING enum to the CampaignPrimaryStatusReasons column, the PAUSE enum to the AdFormatType column, and the ENGAGED_VIEW enum to the ConversionAttributionEventType column.
  • In the CampaignAggregateAssetView view, added the RELATED_YOUTUBE_VIDEOS enum to the CampaignAggregateAssetViewFieldType column.
  • In the CampaignAsset view, added the RELATED_YOUTUBE_VIDEOS enums to the CampaignAssetFieldType column.
  • In the CampaignCriterion view, added the PLACEMENT_LIST, VIDEO_LINEUP, and the WEBPAGE_LIST enums to the CampaignCriterionType column.
  • In the ChannelAggregateAssetView view, added the RELATED_YOUTUBE_VIDEOS enum to the ChannelAggregateAssetViewFieldType column.
  • In the Customer view, added the PAUSE enum to the AdFormatType column.
  • In the CustomerNegativeCriterion view, added the PLACEMENT_LIST, VIDEO_LINEUP, and WEBPAGE_LIST enums to the CustomerNegativeCriterionType column.
  • In the SearchTermView view, added the AI_MAX and PERFORMANCE_MAX enums to the SearchTermMatchType column.
  • In the SharedCriterion view, added the PLACEMENT_LIST, VIDEO_LINEUP, and WEBPAGE_LIST enums to the SharedCriterionType column.
  • In the SharedSet view, added the WEBPAGES enum to the SharedSetType column.
  • In the UserLocationView, TravelActivityPerformanceView, and Video views, added the PAUSE enum to the AdNetworkType column.
  • The DISCOVER, GMAIL, and MAPS enums have been added to the AdNetworkType column in all views where this column is available.
  • The PRODUCT_ASSETS, VEHICLE_ASSETS, VIDEO_RELATED_VIDEOS_CLICK, and VIDEO_CHANNEL_CLICK enums have been added to the ClickType column in all views where this column is available.

Changed
  • Updated the default API version from v19 to v21.
10/06/20259410GeneralAdded
  • Support for parsing datetime formats using ".S" and ",S" for milliseconds and nanoseconds.
09/16/20259390Google AdsChanged
  • When you run SELECT * queries, NULL segment columns are no longer included in the result set.
09/12/20259386GeneralAdded
  • Added the IsInsertable, IsUpdateable, and IsDeleteable columns to the sys_tables table.
09/10/20259384GeneralChanged
  • All columns in statically defined Views are now reported as read-only.
09/03/20259377GeneralChanged
  • Corrected the behavior when IN criteria with NULL values are used in the projection part. It now returns NULL instead of 0. For example, "NULL IN (1,2)" returns "NULL".
09/01/20259375GeneralAdded
  • Added support for using the CAST function with infinity values. This function can cast "inf" and "-inf" to DOUBLE, FLOAT, or REAL.
08/21/20259364GeneralChanged
  • Report behavior change:
    • Fixed inconsistent string value comparisons in non-table queries.
    • For example, "SELECT 'A' = 'a'" previously returned false, but it now returns true.
08/13/20259356GeneralChanged
  • Changed the maximum number of pages held in memory from 15 to 5 for the page providers to decrease heap usage.
07/08/20259320Google AdsChanged
  • The following fields are now filtered using Date values (yyyy-mm-dd) instead of DateTime values (yyyy-mm-ddthh:mm:ssz):
    • AccountBudgetProposal view: AccountBudgetProposalApprovalDateTime and AccountBudgetProposalCreationDateTime
    • CallView view: CallViewEndCallDateTime and CallViewStartCallDateTime
    • ChangeEvent view: ChangeEventChangeDateTime
    • ChangeStatus view: ChangeStatusLastChangeDateTime
    • ConversionAction view: ConversionLastReceivedRequestDateTime
07/07/20259319PythonRemoved
  • Removed the 32-bit version of Windows Python.
07/02/20259314PythonRemoved
  • Removed support for Python 3.9.
06/25/20259307GeneralRemoved
  • Removed the "ADLS Gen 1" value from the ConnectionType property.
06/25/20259307PythonAdded
  • Added support for Python 3.13 in Windows, Linux, and Mac editions.

Removed
  • Removed support for Python 3.8 as it is no longer supported.
06/20/20259302GeneralAdded
  • Created the following functions:
    • TEXT_ENCODE: encodes a string into a different charset (UTF8 → UTF7 and returns a binary array as the result).
    • TEXT_DECODE: takes a binary array and decodes it back into a string when provided the charset.
    • BASE64_ENCODE: takes a binary array and encodes it as a base64 string (varchar).
    • BASE64_DECODE: takes a base 64-encoded string and decodes it into a binary array.
06/18/20259300GeneralChanged
  • The internal code for exception handling has been refactored. Exception messages returned during certain error conditions may now have different wording or formatting.
06/10/20259292Google AdsAdded
  • Added 3 columns to the Ad view.
  • Added 9 columns to the AdGroup view.
  • Added 3 columns to the AdGroupAd view.
  • Added 7 columns to the Asset view.
  • Added 1 column to the AssetGroup view.
  • Added 10 columns to the AssetGroupAsset view.
  • Added 11 columns to the Campaign view.
  • Added 3 columns to the CampaignAggregateAssetView view.
  • Added 1 column to the ChangeStatus view.
  • Added 3 columns to the ChannelAggregateAssetView view.
  • Added 1 column to the CustomerLifecycleGoal view.
  • Added 1 column to the LocalServicesLead view.
  • Added value YOUTUBE_AUDIO_AD:
    • In the Ad view's AdType column.
    • In the AdGroupAd view's AdGroupAdType column.
  • Added value YOUTUBE_AUDIO:
    • In the AdGroup view's AdGroupType column.
  • Added values BUSINESS_MESSAGE and TALL_PORTRAIT_MARKETING_IMAGE:
    • In the AdGroup view's AdGroupCpcBidMicros column.
    • In the AdGroupAdAssetView view's AdGroupAdAssetViewFieldType column.
    • In the AdGroupAsset view's AdGroupAssetFieldType column.
    • In the AssetFieldTypeView's AssetFieldTypeViewFieldType column.
    • In the AssetGroupAsset view's AssetGroupAssetFieldType column.
    • In the CampaignAsset view's CampaignAssetFieldType column.
    • In the CustomerAsset view's CustomerAssetFieldType column.
    • In the CampaignAggregateAssetView view's CampaignAggregateAssetViewFieldType column.
    • In the ChannelAggregateAssetView view's ChannelAggregateAssetViewFieldType column.
  • Added values APP_DEEP_LINK and BUSINESS_MESSAGE:
    • In the Asset view's AssetType column.
  • Added value MONTHLY:
    • In the Campaign view's CampaignFixedCpmTargetFrequencyInfoTimeUnit column.
  • Added values ASSET_SET, CAMPAIGN_ASSET_SET, and CAMPAIGN_BUDGET:
    • In the ChangeStatus view's ChangeStatusResourceType column.

Changed
  • Updated the default API version from v18 to v19.

Removed
  • Removed the following views: AdGroupExtensionSetting, AdGroupFeed, CampaignExtensionSetting, CampaignFeed, CustomerExtensionSetting, CustomerFeed, ExtensionFeedItem, Feed, FeedItem, FeedItemSet, FeedItemSetLink, FeedItemTarget, FeedMapping, and FeedPlaceholderView.
  • Removed 1 column in Campaign view: CampaignDynamicSearchAdsSettingFeeds.
  • Removed 1 column in CampaignCriterion view: CampaignCriterionLocationGroupFeed.
  • Removed 2 columns in ChangeEvent view: ChangeEventFeed and ChangeEventFeedItem.
  • Removed 4 columns in ChangeStatus view: ChangeStatusAdGroupFeed, ChangeStatusCampaignFeed, ChangeStatusFeed, and ChangeStatusFeedItem.
  • Removed the following enum values:
    • In the Ad view's AdType column, removed value: VIDEO_OUTSTREAM_AD.
    • In the AdGroup view's AdGroupType column, removed value: VIDEO_OUTSTREAM.
05/29/20259280Google AdsRemoved
  • Removed the PageSize connection property, which has been deprecated in GoogleAds.
05/27/20259278GeneralRemoved
  • Removed the "Proprietary" enum option from ProxyAuthscheme.
05/12/20259263PythonChanged
  • Updated embedded JRE to jre-17.0.15+6 (Linux x64 / MacOS x64) and jre-17.0.15+6 (MacOS aarch64).
02/17/20259179Google AdsAdded
  • Three new views: ContentCriterionView, Datalink, and PerformanceMaxPlacementView.
  • New columns in AdGroup: AdGroupExcludeDemographicExpansion, TravelDestinationCity, TravelDestinationRegion, TravelDestinationCountry.
  • New columns in AdGroupAd: AdGroupAdAdGroupAdAssetAutomationSettings
  • New columns in Campaign: StoreVisitsLastClickModelAttributedConversions, VideoViewRateInFeed, VideoViewRateInStream, VideoViewRateShorts, ResultsConversionsPurchase, GeneralInvalidClickRate, GeneralInvalidClicks
  • New columns in ConversionValueRule: ConversionValueRuleItineraryConditionAdvanceBookingWindowMaxDays, ConversionValueRuleItineraryConditionAdvanceBookingWindowMinDays, ConversionValueRuleItineraryConditionTravelLengthMaxNights, ConversionValueRuleItineraryConditionTravelLengthMinNights, ConversionValueRuleItineraryConditionTravelStartDayFriday, ConversionValueRuleItineraryConditionTravelStartDayMonday, ConversionValueRuleItineraryConditionTravelStartDaySaturday, ConversionValueRuleItineraryConditionTravelStartDaySunday, ConversionValueRuleItineraryConditionTravelStartDayThursday, ConversionValueRuleItineraryConditionTravelStartDayTuesday, ConversionValueRuleItineraryConditionTravelStartDayWednesday.
02/15/20259177GeneralAdded
  • Added support for converting unsigned integer types to the nearest signed data type that has enough precision to hold the unsigned value.This is done for JDBC only because it does not have support for unsigned data types.
11/27/20249097GeneralAdded
  • Added ThreadId to LogModule output. Logfile lines now include the Thread ID associated with the action being performed.
10/17/20249056Google AdsAdded
  • Added support for Workload Identity Federation using AWS accounts.
10/14/20249053Google AdsAdded
  • Added a new view, ShoppingProduct.

Removed
  • In the AdGroup, Campaign, Custom, and KeywordView views, removed 6 columns:
    • AuctionInsightSearchAbsoluteTopImpressionPercentage
    • AuctionInsightSearchImpressionShare
    • AuctionInsightSearchOutrankingShare
    • AuctionInsightSearchOverlapRate
    • AuctionInsightSearchPositionAboveRate
    • AuctionInsightSearchTopImpressionPercentage
08/20/20248998Google AdsAdded
  • Added support for V17 of the Google Ads API. This is now the default value for the APIVersion connection property.
  • Added the Ad, CampaignAggregateAssetView, ChannelAggregateAssetView, OfflineConversionUploadConversionActionSummary, and UserListCustomerType views.
  • For all views with a ClickType column, the value AD_IMAGE has been added to them.
  • In the AdGroup view, added the AdGroupFixedCpmMicros, AdGroupTargetCpvMicros, and AdFormatType columns.
  • In the AdGroupAd view, added the column AdFormatType.
  • In the AdGroupAdAssetView view, added the AdFormatType column.
  • In the AdGroupCriterion view, added the AdGroupCriterionPrimaryStatus and AdGroupCriterionPrimaryStatusReasons columns.
  • In the BiddingDataExclusion view's BiddingDataExclusionAdvertisingChannelTypes column, added the value DEMAND_GEN.
  • In the BiddingSeasonalityAdjustment view's BiddingSeasonalityAdjustmentAdvertisingChannelTypes column, added the value DEMAND_GEN.
  • In the Campaign view, added the CampaignFixedCpmGoal, CampaignFixedCpmTargetFrequencyInfoTargetCount, CampaignFixedCpmTargetFrequencyInfoTimeUnit, CampaignKeywordMatchType, CampaignTargetCpv, CampaignVideoCampaignSettingsVideoAdInventoryControlAllowInFeed, CampaignVideoCampaignSettingsVideoAdInventoryControlAllowInStream, CampaignVideoCampaignSettingsVideoAdInventoryControlAllowShorts, AdFormatType, SkAdNetworkRedistributedFineConversionValue and SkAdNetworkVersion columns.
  • In the Campaign view's CampaignAdvertisingChannelType column, added the value DEMAND_GEN.
  • In the ChangeStatus view, added the ChangeStatusAssetGroup column.
  • In the Customer view, added the AdFormatType, SkAdNetworkRedistributedFineConversionValue, and SkAdNetworkVersion columns.
  • In the CustomerClientLink view, added the CustomerId column.
  • In the CustomerNegativeCriterion's CustomerNegativeCriterionContentLabelType column, added the BRAND_SUITABILITY_CONTENT_FOR_FAMILIES,BRAND_SUITABILITY_GAMES_FIGHTING,BRAND_SUITABILITY_GAMES_MATURE,BRAND_SUITABILITY_HEALTH_SENSITIVE,BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED,BRAND_SUITABILITY_NEWS_RECENT,BRAND_SUITABILITY_NEWS_SENSITIVE,BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED,BRAND_SUITABILITY_POLITICS, and BRAND_SUITABILITY_RELIGION values.
  • In the GenderView view, added the SearchImpressionShare column.
  • In the KeywordView view, added the PhoneCalls column.
  • In the LocalServicesLeadConversation view's LocalServicesLeadConversationConversationChannel column, added the WHATSAPP value.
  • In the LocalServicesVerificationArtifact view, added the LocalServicesVerificationArtifactLicenseVerificationArtifactExpirationDateTime and LocalServicesVerificationArtifactInsuranceVerificationArtifactExpirationDateTime columns.
  • In the OfflineConversionUploadClientSummary view, added the OfflineConversionUploadClientSummaryPendingEventCount and OfflineConversionUploadClientSummaryPendingRate columns.
  • In the PerStoreView view, added the Date and Period columns.
  • In the Video view, added the AdFormatType column.

Removed
  • In the AdGroupAd view's AdGroupAdAdType column, removed the DISCOVERY_CAROUSEL_AD value.
  • In the BiddingDataExclusion view's BiddingDataExclusionAdvertisingChannelTypes column, removed the value DISCOVERY.
  • In the BiddingSeasonalityAdjustment view's BiddingSeasonalityAdjustmentAdvertisingChannelTypes column, removed the value DISCOVERY.
  • In the Campaign view's CampaignAdvertisingChannelType column, removed the value DISCOVERY.
  • Removed the CustomerClientLink view's LinkedManagerId column and CustomerId pseudocolumn.
  • Removed the CustomerLifecycleGoal's CustomerLifecycleGoalLifecycleGoalCustomerDefinitionSettingsExistingUserLists and CustomerLifecycleGoalLifecycleGoalCustomerDefinitionSettingsHighLifetimeValueUserLists columns.

Changed
  • In the AdGroup view's AdGroupExcludedParentAssetFieldTypes column, renamed the value DISCOVERY_CAROUSEL_CARD to DEMAND_GEN_CAROUSEL_CARD.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryCarouselAdBusinessName column to AdGroupAdAdDemandGenCarouselAdBusinessName.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryCarouselAdCallToActionText column to AdGroupAdAdDemandGenCarouselAdCallToActionText.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryCarouselAdCarouselCards column to AdGroupAdAdDemandGenCarouselAdCarouselCards.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryCarouselAdDescription column to AdGroupAdAdDemandGenCarouselAdDescription.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryCarouselAdHeadline column to AdGroupAdAdDemandGenCarouselAdHeadline.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryCarouselAdLogoImage column to AdGroupAdAdDemandGenCarouselAdLogoImage.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryMultiAssetAdBusinessName column to AdGroupAdAdDemandGenMultiAssetAdBusinessName.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryMultiAssetAdCallToActionText column to AdGroupAdAdDemandGenMultiAssetAdCallToActionText.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryMultiAssetAdDescriptions column to AdGroupAdAdDemandGenMultiAssetAdDescriptions.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryMultiAssetAdHeadlines column to AdGroupAdAdDemandGenMultiAssetAdHeadlines.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryMultiAssetAdLeadFormOnly column to AdGroupAdAdDemandGenMultiAssetAdLeadFormOnly.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryMultiAssetAdLogoImages column to AdGroupAdAdDemandGenMultiAssetAdLogoImages.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryMultiAssetAdMarketingImages column to AdGroupAdAdDemandGenMultiAssetAdMarketingImages.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryMultiAssetAdPortraitMarketingImages column to AdGroupAdAdDemandGenMultiAssetAdPortraitMarketingImages.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryMultiAssetAdSquareMarketingImages column to AdGroupAdAdDemandGenMultiAssetAdSquareMarketingImages.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryVideoResponsiveAdBreadcrumb1 column to AdGroupAdAdDemandGenVideoResponsiveAdBreadcrumb1.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryVideoResponsiveAdBreadcrumb2 column to AdGroupAdAdDemandGenVideoResponsiveAdBreadcrumb2.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryVideoResponsiveAdBusinessName column to AdGroupAdAdDemandGenVideoResponsiveAdBusinessName.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryVideoResponsiveAdCallToActions column to AdGroupAdAdDemandGenVideoResponsiveAdCallToActions.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryVideoResponsiveAdDescriptions column to AdGroupAdAdDemandGenVideoResponsiveAdDescriptions.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryVideoResponsiveAdHeadlines column to AdGroupAdAdDemandGenVideoResponsiveAdHeadlines.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryVideoResponsiveAdLogoImages column to AdGroupAdAdDemandGenVideoResponsiveAdLogoImages.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryVideoResponsiveAdLongHeadlines column to AdGroupAdAdDemandGenVideoResponsiveAdLongHeadlines.
  • Renamed the AdGroupAd view's AdGroupAdAdDiscoveryVideoResponsiveAdVideos column to AdGroupAdAdDemandGenVideoResponsiveAdVideos.
  • In the AdGroupAd view's AdGroupAdAdType column, renamed the value DISCOVERY_MULTI_ASSET_AD to DEMAND_GEN_MULTI_ASSET_AD.
  • In the AdGroupAd view's AdGroupAdAdType column, renamed the value DISCOVERY_VIDEO_RESPONSIVE_AD to DEMAND_GEN_VIDEO_RESPONSIVE_AD.
  • Renamed the Asset view's AssetDiscoveryCarouselCardAssetCallToActionText column to AssetDemandGenCarouselCardAssetCallToActionText.
  • Renamed the Asset view's AssetDiscoveryCarouselCardAssetHeadline column to AssetDemandGenCarouselCardAssetHeadline.
  • Renamed the Asset view's AssetDiscoveryCarouselCardAssetMarketingImageAsset column to AssetDemandGenCarouselCardAssetMarketingImageAsset.
  • Renamed the Asset view's AssetDiscoveryCarouselCardAssetPortraitMarketingImageAsset column to AssetDemandGenCarouselCardAssetPortraitMarketingImageAsset.
  • Renamed the Asset view's AssetDiscoveryCarouselCardAssetSquareMarketingImageAsset column to AssetDemandGenCarouselCardAssetSquareMarketingImageAsset.
  • In the AssetGroupAsset view's AssetGroupAssetFieldType column, renamed the value DISCOVERY_CAROUSEL_CARD to DEMAND_GEN_CAROUSEL_CARD.
  • Renamed the Campaign view's CampaignDiscoveryCampaignSettingsUpgradedTargeting column to CampaignDemandGenCampaignSettingsUpgradedTargeting.
  • Renamed the Campaign view's SkAdNetworkConversionValue column to SkAdNetworkFineConversionValue.
  • In the Campaign view's CampaignExcludedParentAssetFieldTypes column, renamed the value DISCOVERY_CAROUSEL_CARD to DEMAND_GEN_CAROUSEL_CARD.
  • Renamed the Customer view's SkAdNetworkConversionValue column to SkAdNetworkFineConversionValue.
  • Renamed the CustomerClientLink view's ClientCustomerId column to CustomerClientLinkClientCustomer.
  • Renamed the CustomerClientLink view's Hidden column to CustomerClientLinkHidden.
  • Renamed the CustomerClientLink view's ManagerLinkId column to CustomerClientLinkManagerLinkId.
  • Renamed the CustomerClientLink view's ResourceName column to CustomerClientLinkResourceName.
  • Renamed the CustomerClientLink view's Status column to CustomerClientLinkStatus.
07/12/20248959Google AdsAdded
  • Added a new "ServerTimeZone" connection property. When you set a timezone in this property, the driver assumes that datetime values from the server are in the specified timezone.
07/04/20248951Google AdsRemoved
  • Removed the ProductBiddingCategoryConstant view since it has been deprecated from the API.
06/14/20248931Google AdsAdded
  • Added support for V16 of the Google Ads API. This is now the default value for the APIVersion connection property.
  • Added LocalServicesEmployee view.
  • Added columns to various views.

Removed
  • Removed columns from various views.
06/05/20248922PythonAdded
  • Added support for Python 3.12.
05/09/20248895GeneralChanged
  • The ROUND function previously did not accept negative precision values. That feature has now been restored.
03/15/20248840GeneralAdded
  • Created a new SQL function called STRING_COMPARE that provides java's String.compare() ability to SQL queries. Returns a number representative of the compared value of two strings
12/11/20238745Google AdsChanged
  • Updated the GoogleAds schema to be compatible with Google Ads API v15.
11/29/20238733GeneralChanged
  • The ROUND function doesn't accept the negative precision values anymore.

Changed
  • The returning types of the FDMonth, FDQuarter, FDWeek, LDMonth, LDQuarter, LDWeek functions are changed from Timestamp to Date.
  • The return type of the ABS function will be consistent with the parameter value type.
11/28/20238732GeneralAdded
  • Added the HMACSHA256 formatter to allow for secrets to be decoded if it is in base64 format
10/20/20238693Google AdsAdded
  • Added all missing metrics and the following column for Customer view: CustomerCustomerAgreementSettingAcceptedLeadFormTerms.
  • Added columns AllNewCustomerLifetimeValue, NewCustomerLifetimeValue, NewVersusReturningCustomers to AdGroup, AdGroupAd, Campaign views.
  • Added column NewVersusReturningCustomers to KeywordView, LocationView views.
  • Added columns RecommendationImprovePerformanceMaxAdStrengthRecommendation, RecommendationMigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation, RecommendationPerformanceMaxOptInRecommendation to Recommendation view.
  • Added columns AdGroupAdAdDiscoveryVideoResponsiveAdBreadcrumb1, AdGroupAdAdDiscoveryVideoResponsiveAdBreadcrumb2, AdGroupAdAdDiscoveryVideoResponsiveAdBusinessName, AdGroupAdAdDiscoveryVideoResponsiveAdCallToActions, AdGroupAdAdDiscoveryVideoResponsiveAdDescriptions, AdGroupAdAdDiscoveryVideoResponsiveAdHeadlines, AdGroupAdAdDiscoveryVideoResponsiveAdLogoImages, AdGroupAdAdDiscoveryVideoResponsiveAdLongHeadlines, AdGroupAdAdDiscoveryVideoResponsiveAdVideos to AdGroupAd view.
  • Added columns AdGroupCriterionLanguageLanguageConstant, AdGroupCriterionListingGroupPath, AdGroupCriterionLocationGeoTargetConstant to AdGroupCriterion view.
  • Added columns AssetGroupPrimaryStatus, AssetGroupPrimaryStatusReasons to AssetGroup view.
  • Added columns AssetGroupAssetPrimaryStatus, AssetGroupAssetPrimaryStatusDetails, AssetGroupAssetPrimaryStatusReasons to AssetGroupAsset view.
  • Added column AssetGroupListingGroupFilterPath to AssetGroupListingGroupFilter view.
  • Added columns CampaignDiscoveryCampaignSettingsUpgradedTargeting, CampaignShoppingSettingAdvertisingPartnerIds to Campaign view.
  • Added the following value to AdGroupAd.AdGroupAdAdType: DISCOVERY_VIDEO_RESPONSIVE_AD
  • Added the following values to Asset.AssetCallToActionAssetCallToAction: BUY_NOW, DONATE_NOW, ORDER_NOW, PLAY_NOW, SEE_MORE, START_NOW, VISIT_SITE, WATCH_NOW.
  • Added the following values to Campaign.CampaignPrimaryStatusReasons: HAS_ASSET_GROUPS_DISAPPROVED, HAS_ASSET_GROUPS_LIMITED_BY_POLICY, MOST_ASSET_GROUPS_UNDER_REVIEW.
  • Added the following values to Campaign.RecommendationType: IMPROVE_PERFORMANCE_MAX_AD_STRENGTH, MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX, PERFORMANCE_MAX_OPT_IN.
  • Added the following values to Recommendation.RecommendationType: IMPROVE_PERFORMANCE_MAX_AD_STRENGTH, MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX, PERFORMANCE_MAX_OPT_IN.
  • Added views CampaignSearchTermInsight, CustomerSearchTermInsight.
08/29/20238641PythonAdded
  • Added support for SQLAlchemy 2.0.
08/03/20238615Google AdsChanged
  • Renamed the following pre-defined views, AccountStats to AccountStatsReport, AccountHourlyStats to AccountHourlyStatsReport, AdGroupStats to AdGroupStatsReport, AdGroupHourlyStats to AdGroupHourlyStatsReport, AdStats to AdStatsReport, AudienceStats to AudienceStatsReport, CampaignStats to CampaignStatsReport, CampaignHourlyStats to CampaignHourlyStatsReport, KeywordStats to KeywordStats Report.
08/02/20238614Google AdsChanged
  • Updated the GoogleAds schema to be compatible with Google Ads API v14.
06/23/20238574Google AdsAdded
  • Added ClickViewFiltredReport view. Using this view, filtered operator in DATE column for getting data in multiple days are supported.
06/20/20238571GeneralAdded
  • Added the new sys_lastresultinfo system table.
05/19/20238539PythonAdded
  • Added support for Python 3.11 on Windows, Linux and Mac.
05/16/20238536PythonRemoved
  • Removed support for Python 3.7 on Windows and Linux
04/25/20238515GeneralRemoved
  • Removed support for the SELECT INTO CSV statement. The core code doesn't support it anymore.
03/23/20238482Google AdsAdded
  • Added the following pre-defined views, AccountStats, AccountHourlyStats, AdGroupStats, AdGroupHourlyStats, AdStats, AudienceStats, CampaignStats, CampaignHourlyStats, KeywordStats.
01/25/20238425Google AdsAdded
  • Added support for PKCE using the OAuthPKCE auth scheme
01/16/20238416Google AdsChanged
  • Changed FeedItemSet.FeedItemSetDynamicAffiliateLocationSetFilterChainIds's xs:type attribute from 'long' to 'string'.
  • Changed Feed.FeedAffiliateLocationFeedDataChainIds's xs:type attribute from 'long' to 'string'.
  • Changed AssetSet.AssetSetLocationSetBusinessProfileLocationSetListingIdFilters's xs:type attribute from 'long' to 'string'.
12/14/20228383GeneralChanged
  • Added the Default column to the sys_procedureparameters table.
12/06/20228375Google AdsAdded
  • Added WriteToFile as an input for CreateReportSchema. If set to True, the schema file will be written to the directory specified by the Location connection property. If set to False, the schema data will either be written to the FileStream or be output as BASE64 encoded data. Defaults to True.

Removed
  • Removed OutputFolder from the CreateReportSchema stored procedure. If WriteToFile is set to true, all schema files will be written to the directory specified by the Location connection property.
11/15/20228354PythonChanged
  • Updated embedded JRE to jre8u345-b01(Linux x64 / MacOS x64) and jre-17.0.5+8(MacOS aarch64).
11/11/20228350Google AdsAdded
  • Updated the driver to be compliant with the v12 release of GoogleAds.
  • Added the following tables PerStoreView, CustomerAssetSet, AssetSetTypeView and AdGroupAssetSet.
  • Added the following column to the AccountLink table, AccountLinkAdvertisingPartnerCustomer.
  • Added the following column to the BiddingStrategy table, BiddingStrategyAlignedCampaignBudgetId.
  • Added the following column to the CampaignBudget table, CampaignBudgetAlignedBiddingStrategyId.
  • Added the following column to the CampaignCriterion table, CampaignCriterionLocationGroupEnableCustomerLevelLocationAssetSet.
  • Added the following column to the LeadFormSubmissionData table, LeadFormSubmissionDataCustomLeadFormSubmissionFields.
  • Added the following column to the AdGroup table, AdGroupExcludedParentAssetSetTypes.
  • Added the following columns to the AdGroupAdAssetView table, AdGroupAdAssetViewPinnedField, ConversionAction.
  • Added the following columns to the Asset table, AssetLocationAssetBusinessProfileLocations, AssetLocationAssetLocationOwnershipType, AssetLocationAssetPlaceId.
  • Added the following columns to the AssetSet table, AssetSetBusinessProfileLocationGroupDynamicBusinessProfileLocationGroupFilterBusinessNameFilterBusinessName, AssetSetBusinessProfileLocationGroupDynamicBusinessProfileLocationGroupFilterBusinessNameFilterFilterType, AssetSetBusinessProfileLocationGroupDynamicBusinessProfileLocationGroupFilterLabelFilters, AssetSetLocationSetBusinessProfileLocationSetBusinessNameFilter, AssetSetLocationSetBusinessProfileLocationSetLabelFilters, AssetSetLocationSetBusinessProfileLocationSetListingIdFilters, AssetSetLocationSetChainLocationSetRelationshipType, AssetSetLocationSetLocationOwnershipType.
  • Added the following columns to the AssetSetAsset table, AbsoluteTopImpressionPercentage, AllConversions, AllConversionsFromInteractionsRate, AllConversionsValue, AverageCost, AverageCpc, AverageCpm, Clicks, Conversions, ConversionsFromInteractionsRate, ConversionsValue, CostMicros, CostPerAllConversions, CostPerConversion, CrossDeviceConversions, Ctr, EngagementRate, Engagements, Impressions, InteractionEventTypes, InteractionRate, Interactions, PhoneCalls, PhoneImpressions, PhoneThroughRate, TopImpressionPercentage, ValuePerAllConversions, ValuePerConversion, AdNetworkType, AssetInteractionTargetAsset, AssetInteractionTargetInteractionOnThisAsset, ClickType, ConversionAction, ConversionActionCategory, ConversionActionName, Date, DayOfWeek, Device, ExternalConversionSource, Month, MonthOfYear, Period, Quarter, Slot, Week, Year.
  • Added the following columns to the Campaign table, CampaignExcludedParentAssetSetTypes, CampaignPrimaryStatus, CampaignPrimaryStatusReasons, AllConversionsFromLocationAssetClickToCall, AllConversionsFromLocationAssetDirections, AllConversionsFromLocationAssetMenu, AllConversionsFromLocationAssetOrder, AllConversionsFromLocationAssetOtherEngagement, AllConversionsFromLocationAssetStoreVisits, AllConversionsFromLocationAssetWebsite, EligibleImpressionsFromLocationAssetStoreReach, PublisherOrganicClicks, PublisherPurchasedClicks, PublisherUnknownClicks, ViewThroughConversionsFromLocationAssetClickToCall, ViewThroughConversionsFromLocationAssetDirections, ViewThroughConversionsFromLocationAssetMenu, ViewThroughConversionsFromLocationAssetOrder, ViewThroughConversionsFromLocationAssetOtherEngagement, ViewThroughConversionsFromLocationAssetStoreVisits, ViewThroughConversionsFromLocationAssetWebsite.
  • Added the following value to AccountLink.AccountLinkType: ADVERTISING_PARTNER.
  • Added the following value to AdGroup.AdGroupExcludedParentAssetFieldTypes: AD_IMAGE.
  • Added the following value to AdGroupAdAssetView.AdGroupAdAssetViewFieldType: AD_IMAGE.
  • Added the following value to AdGroupAsset.AdGroupAssetFieldType: AD_IMAGE.
  • Added the following value to Asset.AssetType: LOCATION.
  • Added the following value to AssetFieldTypeView.AssetFieldTypeViewFieldType: AD_IMAGE.
  • Added the following value to AssetGroupAsset.AssetGroupAssetFieldType: AD_IMAGE.
  • Added the following value to Campaign.CampaignExcludedParentAssetFieldTypes: AD_IMAGE.
  • Added the following value to Campaign.RecommendationType: FORECASTING_SET_TARGET_ROAS, RAISE_TARGET_CPA_BID_TOO_LOW.
  • Added the following value to CampaignAsset.CampaignAssetFieldType: AD_IMAGE.
  • Added the following value to CustomerAsset.CustomerAssetFieldType: AD_IMAGE.
  • Added the following value to Recommendation.RecommendationType: FORECASTING_SET_TARGET_ROAS, RAISE_TARGET_CPA_BID_TOO_LOW.
  • Added the following values to AssetSet.AssetSetType: BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, LOCATION_SYNC, STATIC_LOCATION_GROUP.
  • Added the following values to OfflineUserDataJob.OfflineUserDataJobFailureReason: HIGH_AVERAGE_TRANSACTION_VALUE, LOW_AVERAGE_TRANSACTION_VALUE, NEWLY_OBSERVED_CURRENCY_CODE.

Changed
  • Updated the schema to be compatible with Google Ads API v12. The default APIVersion is now v12. Google has sunset V9. v10 will sunset on January 2023. v11 will sunset on March/April 2023.
  • Renamed ExperimentArm.ExperimentArmTrial to ExperimentArm.ExperimentArmExperiment.

Removed
  • Removed the following columns from the AdGroupAd table, AdGroupAdAdGmailAdHeaderImage, AdGroupAdAdGmailAdMarketingImage, AdGroupAdAdGmailAdMarketingImageDescription,AdGroupAdAdGmailAdMarketingImageDisplayCallToActionText, AdGroupAdAdGmailAdMarketingImageDisplayCallToActionTextColor, AdGroupAdAdGmailAdMarketingImageDisplayCallToActionUrlCollectionId,AdGroupAdAdGmailAdMarketingImageHeadline, AdGroupAdAdGmailAdProductImages, AdGroupAdAdGmailAdProductVideos, AdGroupAdAdGmailAdTeaserBusinessName, AdGroupAdAdGmailAdTeaserDescription,AdGroupAdAdGmailAdTeaserHeadline, AdGroupAdAdGmailAdTeaserLogoImage.
  • Removed the following value from AdGroupAd.AdGroupAdAdType: GMAIL_AD.

Deprecated
  • Deprecated CampaignExperiment. This table can only be used with APIVersion v11 or older.
10/13/20228321Google AdsDeprecated
  • The ClientCustomerId field now has support for multiple ids in addition to All, which will use all currently active ids.
  • SELECT CustomerID FROM Customer can now be used to retrieve all the client's ids.
09/30/20228308GeneralChanged
  • Added the IsPath column to the sys_procedureparameters table.
09/01/20228279Google AdsAdded
  • Updated the driver to be compliant with the v11 release of GoogleAds.
  • Added the following tables, LeadFormSubmissionData and CampaignGroup.
  • Added the following columns to the AccountLink table, AccountLinkHotelCenterHotelCenterId.
  • Added the following columns to the AdGroup table, AssetInteractionTargetAsset, AssetInteractionTargetInteractionOnThisAsset, AuctionInsightDomain.
  • Added the following columns to the AdGroupAd table, AdGroupAdAdDiscoveryCarouselAdBusinessName, AdGroupAdAdDiscoveryCarouselAdCallToActionText, AdGroupAdAdDiscoveryCarouselAdCarouselCards, AdGroupAdAdDiscoveryCarouselAdDescription, AdGroupAdAdDiscoveryCarouselAdHeadline, AdGroupAdAdDiscoveryCarouselAdLogoImage, AdGroupAdAdDiscoveryMultiAssetAdBusinessName, AdGroupAdAdDiscoveryMultiAssetAdCallToActionText, AdGroupAdAdDiscoveryMultiAssetAdDescriptions, AdGroupAdAdDiscoveryMultiAssetAdHeadlines, AdGroupAdAdDiscoveryMultiAssetAdLeadFormOnly, AdGroupAdAdDiscoveryMultiAssetAdLogoImages, AdGroupAdAdDiscoveryMultiAssetAdMarketingImages, AdGroupAdAdDiscoveryMultiAssetAdPortraitMarketingImages, AdGroupAdAdDiscoveryMultiAssetAdSquareMarketingImages, AdGroupAdAdVideoResponsiveAdBreadcrumb1, AdGroupAdAdVideoResponsiveAdBreadcrumb2.
  • Added the following columns to the AdGroupAdAssetCombinationView table, AdGroupAdAssetCombinationViewEnabled.
  • Added the following columns to the AdGroupAsset table, AdGroupAssetSource.
  • Added the following columns to the AdGroupAudienceView table, AbsoluteTopImpressionPercentage, TopImpressionPercentage.
  • Added the following columns to the Asset table, AssetDiscoveryCarouselCardAssetCallToActionText, AssetDiscoveryCarouselCardAssetHeadline, AssetDiscoveryCarouselCardAssetMarketingImageAsset, AssetDiscoveryCarouselCardAssetPortraitMarketingImageAsset, AssetDiscoveryCarouselCardAssetSquareMarketingImageAsset, AssetDynamicCustomAssetAndroidAppLink, AssetDynamicCustomAssetContextualKeywords, AssetDynamicCustomAssetFormattedPrice, AssetDynamicCustomAssetFormattedSalePrice, AssetDynamicCustomAssetId, AssetDynamicCustomAssetId2, AssetDynamicCustomAssetImageUrl, AssetDynamicCustomAssetIosAppLink, AssetDynamicCustomAssetIosAppStoreId, AssetDynamicCustomAssetItemAddress, AssetDynamicCustomAssetItemCategory, AssetDynamicCustomAssetItemDescription, AssetDynamicCustomAssetItemSubtitle, AssetDynamicCustomAssetItemTitle, AssetDynamicCustomAssetPrice, AssetDynamicCustomAssetSalePrice, AssetDynamicCustomAssetSimilarIds, AssetDynamicFlightsAssetAndroidAppLink, AssetDynamicFlightsAssetCustomMapping, AssetDynamicFlightsAssetDestinationId, AssetDynamicFlightsAssetDestinationName, AssetDynamicFlightsAssetFlightDescription, AssetDynamicFlightsAssetFlightPrice, AssetDynamicFlightsAssetFlightSalePrice, AssetDynamicFlightsAssetFormattedPrice, AssetDynamicFlightsAssetFormattedSalePrice, AssetDynamicFlightsAssetImageUrl, AssetDynamicFlightsAssetIosAppLink, AssetDynamicFlightsAssetIosAppStoreId, AssetDynamicFlightsAssetOriginId, AssetDynamicFlightsAssetOriginName, AssetDynamicFlightsAssetSimilarDestinationIds, AssetDynamicHotelsAndRentalsAssetAddress, AssetDynamicHotelsAndRentalsAssetAndroidAppLink, AssetDynamicHotelsAndRentalsAssetCategory, AssetDynamicHotelsAndRentalsAssetContextualKeywords, AssetDynamicHotelsAndRentalsAssetDescription, AssetDynamicHotelsAndRentalsAssetDestinationName, AssetDynamicHotelsAndRentalsAssetFormattedPrice, AssetDynamicHotelsAndRentalsAssetFormattedSalePrice, AssetDynamicHotelsAndRentalsAssetImageUrl, AssetDynamicHotelsAndRentalsAssetIosAppLink, AssetDynamicHotelsAndRentalsAssetIosAppStoreId, AssetDynamicHotelsAndRentalsAssetPrice, AssetDynamicHotelsAndRentalsAssetPropertyId, AssetDynamicHotelsAndRentalsAssetPropertyName, AssetDynamicHotelsAndRentalsAssetSalePrice, AssetDynamicHotelsAndRentalsAssetSimilarPropertyIds, AssetDynamicHotelsAndRentalsAssetStarRating, AssetDynamicJobsAssetAddress, AssetDynamicJobsAssetAndroidAppLink, AssetDynamicJobsAssetContextualKeywords, AssetDynamicJobsAssetDescription, AssetDynamicJobsAssetImageUrl, AssetDynamicJobsAssetIosAppLink, AssetDynamicJobsAssetIosAppStoreId, AssetDynamicJobsAssetJobCategory, AssetDynamicJobsAssetJobId, AssetDynamicJobsAssetJobSubtitle, AssetDynamicJobsAssetJobTitle, AssetDynamicJobsAssetLocationId, AssetDynamicJobsAssetSalary, AssetDynamicJobsAssetSimilarJobIds, AssetDynamicLocalAssetAddress, AssetDynamicLocalAssetAndroidAppLink, AssetDynamicLocalAssetCategory, AssetDynamicLocalAssetContextualKeywords, AssetDynamicLocalAssetDealId, AssetDynamicLocalAssetDealName, AssetDynamicLocalAssetDescription, AssetDynamicLocalAssetFormattedPrice, AssetDynamicLocalAssetFormattedSalePrice, AssetDynamicLocalAssetImageUrl, AssetDynamicLocalAssetIosAppLink, AssetDynamicLocalAssetIosAppStoreId, AssetDynamicLocalAssetPrice, AssetDynamicLocalAssetSalePrice, AssetDynamicLocalAssetSimilarDealIds, AssetDynamicLocalAssetSubtitle, AssetDynamicRealEstateAssetAddress, AssetDynamicRealEstateAssetAndroidAppLink, AssetDynamicRealEstateAssetCityName, AssetDynamicRealEstateAssetContextualKeywords, AssetDynamicRealEstateAssetDescription, AssetDynamicRealEstateAssetFormattedPrice, AssetDynamicRealEstateAssetImageUrl, AssetDynamicRealEstateAssetIosAppLink, AssetDynamicRealEstateAssetIosAppStoreId, AssetDynamicRealEstateAssetListingId, AssetDynamicRealEstateAssetListingName, AssetDynamicRealEstateAssetListingType, AssetDynamicRealEstateAssetPrice, AssetDynamicRealEstateAssetPropertyType, AssetDynamicRealEstateAssetSimilarListingIds, AssetDynamicTravelAssetAndroidAppLink, AssetDynamicTravelAssetCategory, AssetDynamicTravelAssetContextualKeywords, AssetDynamicTravelAssetDestinationAddress, AssetDynamicTravelAssetDestinationId, AssetDynamicTravelAssetDestinationName, AssetDynamicTravelAssetFormattedPrice, AssetDynamicTravelAssetFormattedSalePrice, AssetDynamicTravelAssetImageUrl, AssetDynamicTravelAssetIosAppLink, AssetDynamicTravelAssetIosAppStoreId, AssetDynamicTravelAssetOriginId, AssetDynamicTravelAssetOriginName, AssetDynamicTravelAssetPrice, AssetDynamicTravelAssetSalePrice, AssetDynamicTravelAssetSimilarDestinationIds, AssetDynamicTravelAssetTitle, AssetLeadFormAssetCustomQuestionFields, AssetSource.
  • Added the following columns to the AssetGroup table, AssetGroupAdStrength.
  • Added the following columns to the AssetSet table, AssetSetId.
  • Added the following columns to the Campaign table, CampaignBiddingStrategySystemStatus, CampaignCampaignGroup, CampaignLocalServicesCampaignSettingsCategoryBids, CampaignManualCpa, CampaignPerformanceMaxUpgradePerformanceMaxCampaign, CampaignPerformanceMaxUpgradePreUpgradeCampaign, CampaignPerformanceMaxUpgradeStatus, CampaignShoppingSettingFeedLabel, AllConversionsFromClickToCall, AllConversionsFromDirections, AllConversionsFromMenu, AllConversionsFromOrder, AllConversionsFromOtherEngagement, AllConversionsFromStoreVisit, AllConversionsFromStoreWebsite, AssetInteractionTargetAsset, AssetInteractionTargetInteractionOnThisAsset, AuctionInsightDomain, SkAdNetworkAttributionCredit.
  • Added the following columns to the CampaignAsset table, CampaignAssetSource.
  • Added the following columns to the CampaignAudienceView table, AbsoluteTopImpressionPercentage, TopImpressionPercentage.
  • Added the following columns to the ConversionAction table, ConversionActionFirebaseSettingsPropertyId, ConversionActionFirebaseSettingsPropertyName, AllConversions, AllConversionsValue, Date, Month, Period, Quarter, Week.
  • Added the following columns to the Customer table, CustomerConversionTrackingSettingGoogleAdsConversionCustomer.
  • Added the following columns to the CustomerAsset table, CustomerAssetSource.
  • Added the following columns to the KeywordView table, AuctionInsightDomain.
  • Added the following columns to the Recommendation table, RecommendationDisplayExpansionOptInRecommendation, RecommendationResponsiveSearchAdImproveAdStrengthRecommendation, RecommendationUpgradeLocalCampaignToPerformanceMaxRecommendation, RecommendationUpgradeSmartShoppingCampaignToPerformanceMaxRecommendation.
  • Added the following columns to the SmartCampaignSetting table, SmartCampaignSettingAdOptimizedBusinessProfileSettingIncludeLeadForm, SmartCampaignSettingBusinessProfileLocation.
  • Added the following columns to the UserList table, UserListRuleBasedUserListFlexibleRuleUserListExclusiveOperands, UserListRuleBasedUserListFlexibleRuleUserListInclusiveOperands, UserListRuleBasedUserListFlexibleRuleUserListInclusiveRuleOperator.

Changed
  • Updated the schema to be compatible with Google Ads API v11. The default APIVersion is now v11. Google has sunset v7 and v8. V9 will sunset on September 2022.
  • Renamed AccessibleBiddingStrategy.AccessibleBiddingStrategyMaximizeConversionsTargetCpa to AccessibleBiddingStrategy.AccessibleBiddingStrategyMaximizeConversionsTargetCpaMicros.
  • Renamed BiddingStrategy.BiddingStrategyMaximizeConversionsTargetCpa to BiddingStrategy.BiddingStrategyMaximizeConversionsTargetCpaMicros.
  • Renamed Campaign.CampaignMaximizeConversionsTargetCpa to Campaign.CampaignMaximizeConversionsTargetCpaMicros.
  • Removed SmartCampaignSettings.SmartCampaignSettingBusinessLocationId.
  • Removed UserList.UserListRuleBasedUserListDateSpecificRuleUserListEndDate.
  • Removed UserList.UserListRuleBasedUserListDateSpecificRuleUserListRuleRuleItemGroups.
  • Removed UserList.UserListRuleBasedUserListDateSpecificRuleUserListRuleRuleType.
  • Removed UserList.UserListRuleBasedUserListDateSpecificRuleUserListStartDate.
  • Removed 'SMART_DISPLAY' value for ExperimentType column (Experiment table).
07/01/20228217Google AdsAdded
  • Added support for Google Ads Native Queries with Query Passthrough.
06/23/20228209Google AdsAdded
  • Added back embedded credentials.
05/18/20228173PythonAdded
  • Added support for Python 3.10 on Windows, Linux, and Mac
  • Added support for Python 3.9 on Mac
  • Added support for Mac M1

Removed
  • Removed support for Python 3.6 on Windows and Linux
04/22/20228147Google AdsRemoved
  • Removed the AdWords schema as it has been sunset.
03/23/20228117Google AdsAdded
  • Added support for using predefined date ranges by introducing the Period column to many tables.
03/04/20228098Google AdsAdded
  • Added the tables AdGroupAdAssetCombinationView, AssetGroupSignal, Audience, Experiment, ExperimentArm
  • Added the following columns to the AdGroup table: AdGroupAudienceSettingUseAudienceGrouped, AdGroupEffectiveCpcBidMicros
  • Added the following columns to the AdGroupAdAssetView table: BiddableAppInstallConversions, BiddableAppPostInstallConversions
  • Added the following columns to the AdGroupCriterion table: AdGroupCriterionAudienceAudience
  • Added the following columns to the Campaign table: CampaignAudienceSettingUseAudienceGrouped, CampaignShoppingSettingUseVehicleInventory, SkAdNetworkAdEventType, SkAdNetworkSourceAppSkAdNetworkSourceAppId, SkAdNetworkUserType
  • Added the following columns to the ConversionValueRuleSet table: ConversionValueRuleSetConversionActionCategories
  • Added the following columns to the Customer table: CustomerConversionTrackingSettingAcceptedCustomerDataTerms, CustomerConversionTrackingSettingConversionTrackingStatus, CustomerConversionTrackingSettingEnhancedConversionsForLeadsEnabled, CustomerStatus
  • Added the following columns to the CustomerClient table: CustomerClientStatus
  • Added the following columns to the GeographicView table: AbsoluteTopImpressionPercentage, TopImpressionPercentage
  • Added the following columns to the HotelReconciliation table: HotelReconciliationCampaign, HotelCommissionRateMicros, HotelExpectedCommissionCost
  • Added the following columns to the Recommendation table: RecommendationResponsiveSearchAdAssetRecommendation, RecommendationUseBroadMatchKeywordRecommendation

Changed
  • Updated the GoogleAds schema to be compatible with Google Ads API v10.
  • Renamed AdGroupAd.AdGroupAdAdVideoAdDiscoveryDescription1 to AdGroupAd.AdGroupAdAdVideoAdInFeedDescription1
  • Renamed AdGroupAd.AdGroupAdAdVideoAdDiscoveryDescription2 to AdGroupAd.AdGroupAdAdVideoAdInFeedDescription2
  • Renamed AdGroupAd.AdGroupAdAdVideoAdDiscoveryHeadline to AdGroupAd.AdGroupAdAdVideoAdInFeedHeadline
  • Renamed AdGroupAd.AdGroupAdAdVideoAdDiscoveryThumbnail to AdGroupAd.AdGroupAdAdVideoAdInFeedThumbnail
02/09/20228075Google AdsAdded
  • Added support for using CustomerId in a query. For example, let's say you have a lot of accounts from which you want to get data. Instead of opening multiple connections, each with their own ClientCustomerId connection property, you can now specify the customer ids in a list: SELECT * FROM AdGroupAd WHERE CustomerId IN ('1111111111', '2222222222'). You can also specify just one CustomerId: SELECT * FROM AdGroupAd WHERE CustomerId='3333333333'

Changed
  • ClientCustomerId is no longer a required connection property.

Removed
  • Removed unsupported columns from the tables: AdGroup, AdGroupAd, BiddingStrategy, Campaign, KeywordView. The unsupported columns can not be selected if the table is specified in the FROM clause of the query.
11/12/20217986Google AdsAdded
  • Added the tables: AdGroupCriterionCustomizer, AdGroupCustomizer, AssetGroup, AssetGroupAsset, AssetGroupListingGroupFilter, AssetSet, AssetSetAsset, CampaignAssetSet, CampaignConversionGoal, CampaignCustomizer, ConversionGoalCampaignConfig, CustomConversionGoal, CustomerConversionGoal, CustomerCustomizer, CustomizerAttribute, HotelReconciliation.

Changed
  • The view Resources now shows the resource name, attribute resources and segmenting resources. They are needed when executing the stored procedure CreateReportSchema.

Removed
  • Removed CustomerId from the following tables where it is not available: CarrierConstant, CurrencyConstant, GeoTargetConstant, KeywordThemeConstant, LanguageConstant, LifeEvent, HotelPerformanceView, MobileAppCategoryConstant, MobileDeviceConstant, OperatingSystemVersionConstant, ProductBiddingCategoryConstant, TopicConstant, UserInterest
11/04/20217978Google AdsAdded
  • Added the following columns to the Asset table: AssetCallAssetAdScheduleTargets, AssetCallAssetCallConversionAction, AssetCallAssetCallConversionReportingState, AssetCallAssetCountryCode, AssetCallAssetPhoneNumber, AssetCallToActionAssetCallToAction, AssetHotelCalloutAssetLanguageCode, AssetHotelCalloutAssetText, AssetMobileAppAssetAppId, AssetMobileAppAssetAppStore, AssetMobileAppAssetEndDate, AssetMobileAppAssetLinkText, AssetMobileAppAssetStartDate, AssetPriceAssetLanguageCode, AssetPriceAssetPriceOfferings, AssetPriceAssetPriceQualifier, AssetPriceAssetType.
  • Added the following columns to the BiddingStrategy table: BiddingStrategyMaximizeConversionValueCpcBidCeilingMicros, BiddingStrategyMaximizeConversionValueCpcBidFloorMicros, BiddingStrategyMaximizeConversionValueTargetRoas, BiddingStrategyMaximizeConversionsCpcBidCeilingMicros, BiddingStrategyMaximizeConversionsCpcBidFloorMicros, BiddingStrategyMaximizeConversionsTargetCpa.

Changed
  • Updated the GoogleAds schema to be compatible with Google Ads API v9.
09/02/20217915GeneralAdded
  • Added support for the STRING_SPLIT table-valued function in the CROSS APPLY clause.
08/07/20217889GeneralChanged
  • Added the KeySeq column to the sys_foreignkeys table.
08/06/20217888GeneralChanged
  • Added the new sys_primarykeys system table.
07/23/20217874GeneralChanged
  • Updated the Literal Function Names for relative date/datetime functions. Previously, relative date/datetime functions resolved to a different value when used in the projection as opposed to the predicate. For example: SELECT LAST_MONTH() AS lm, Col FROM Table WHERE Col > LAST_MONTH(). Formerly, the two LAST_MONTH() methods would resolve to different datetimes. Now, they will match.
  • As a replacement for the previous behavior, the relative date/datetime functions in the criteria may have an 'L' appended to them. For example: WHERE col > L_LAST_MONTH(). This will continue to resolve to the same values that were previously calculated in the criteria. Note that the "L_" prefix will only work in the predicate - it not available for the projection.
07/21/20217872Google AdsRemoved
  • Removed the embedded credentials since they are no longer working for other Developer Keys.
06/21/20217842Google AdsAdded
  • Added the connection property APIVersion, which defaults to v8. This connection property controls the Google Ads API version.

Changed
  • Updated the GoogleAds schema to be compatible with Google Ads API v8.
  • Renamed the v201809 schema to AdWords, and the googleadsv6 schema to GoogleAds.
06/18/20217839Google AdsAdded
  • Added support for the GOOGLEJSONBLOB JWT certificate type. This works like the existing GOOGLEJSON certificate type except that the certificate is provided as JSON text instead of as a file path.
04/23/20217783GeneralChanged
  • Updated how display sizes are determined for varchar primary key and foreign key columns so they will match the reported length of the column.
04/16/20217776GeneralChanged
  • Reduced the length to 255 for varchar primary key and foreign key columns.

Changed
  • Updated index naming convention to avoid duplicates.
04/16/20217776GeneralChanged
  • Updated implicit and metadata caching to improve performance and support for multiple connections. Old metadata caches are not compatible - you need to generate new metadata caches if you are currently using CacheMetadata.
11/15/20207624Google AdsAdded
  • Added schema GoogleAdsV6 which uses the Google Ads API V6 to connect to Google Ads data. Added the corresponding 'Data Model' subsection in the Help Documentation.
  • Removed deprecated columns (GoogleAdsV3 and GoogleAdsV6 schemas): HotelPerformanceView.CustomerId and BiddingStrategyTargetOutrankShareCompetitorDomain, BiddingStrategyTargetOutrankShareCpcBidCeilingMicros, BiddingStrategyTargetOutrankShareOnlyRaiseCpcBids, BiddingStrategyTargetOutrankShareRaiseCpcBidWhenQualityScoreIsLow, BiddingStrategyTargetOutrankShareTargetOutrankShareMicros from the BiddingStrategy View.
  • The aggregate column AdGroupAdPolicySummary in the AdGroupAd and AdGroupAdAssetView views of the GoogleAdsV6 schema has been expanded to AdGroupAdPolicySummaryApprovalStatus, AdGroupAdPolicySummaryPolicyTopicEntries, AdGroupAdPolicySummaryReviewStatus.
  • Added new columns (GoogleAdsV6 schema): Customer.CustomerOptimizationScore, AdGroupCriterion.AdGroupCriterionDisapprovalReasons, HotelGroupView.HotelEligibleImpressions, HotelPerformanceView.HotelEligibleImpressions, BiddingStrategy.BiddingStrategyEffectiveCurrencyCode, ClickView.ClickViewCampaignLocationTarget, ClickView.ClickViewUserList, CampaignCriterion.CampaignCriterionCustomAudience, AdGroupCriterion. AdGroupCriterionCustomAudience, Customer.CustomerOptimizationScoreWeight.

Copyright (c) 2025 CData Software, Inc. - All rights reserved.
Build 25.0.9454