As of January 1, 2020 this library no longer supports Python 2 on the latest released version. Library versions released prior to that date will continue to be available. For more information please visit Python 2 support on Google Cloud.

Changelog

0.23.2 (2024-10-31)

Bug Fixes

  • disable universe-domain validation (85c7512)

0.23.1 (2024-10-24)

Features

0.23.0 (2024-08-08)

⚠ BREAKING CHANGES

  • Rename custom method CreateSubpropertyRequest to ProvisionSubpropertyRequest

Features

  • add CreateBigQueryLink, UpdateBigQueryLink, and DeleteBigQueryLink methods (9033800)

  • add GetEventEditRule, CreateEventEditRule, ListEventEditRules, UpdateEventEditRule, DeleteEventEditRule, and ReorderEventEditRules methods to the Admin API v1 alpha (9033800)

  • add GetKeyEvent, CreateKeyEvent, ListKeyEvents, UpdateKeyEvent, and DeleteKeyEvent methods (9033800)

  • add the BIGQUERY_LINK option to the ChangeHistoryResourceType enum (9033800)

  • add the create_time field to the Audience resource (9033800)

  • add the dataset_location field to the BigQueryLink resource (9033800)

  • add the gmp_organization field to the Account resource (9033800)

  • add the primary field to the ChannelGroup resource (9033800)

  • mark GetConversionEvent, CreateConversionEvent, ListConversionEvents, UpdateConversionEvent, and DeleteConversionEvent methods as deprecated (9033800)

Bug Fixes

  • Rename custom method CreateSubpropertyRequest to ProvisionSubpropertyRequest (9033800)

Documentation

  • add deprecation comment to GetConversionEvent, CreateConversionEvent, ListConversionEvents, UpdateConversionEvent, and DeleteConversionEvent methods (9033800)

  • improve comment formatting of account and property fields in SearchChangeHistoryEventsRequest (9033800)

  • improve comment formatting of the name field in DeleteFirebaseLinkRequest, GetGlobalSiteTagRequest, and GetDataSharingSettingsRequest (9033800)

  • improve comment formatting of the parent field in CreateFirebaseLinkRequest and ListFirebaseLinksRequest (9033800)

0.22.9 (2024-07-30)

Features

  • [google-analytics-admin] add GetKeyEvent, CreateKeyEvent, ListKeyEvents, UpdateKeyEvent, DeleteKeyEvent methods to the Admin API v1beta (7b156ee)

  • add the default_conversion_value field to the ConversionEvent resource in the Admin API v1beta (7b156ee)

  • add the gmp_organization field to the Account resource in the Admin API v1beta (7b156ee)

  • add the include_all_users and expand_groups fields to the RunAccessReportRequest resource in the Admin API v1beta (7b156ee)

  • mark GetConversionEvent, CreateConversionEvent, ListConversionEvents, UpdateConversionEvent, DeleteConversionEvent methods as deprecated in the Admin API v1beta (7b156ee)

Bug Fixes

  • Retry and timeout values do not propagate in requests during pagination (c6eeae0)

Documentation

  • change comment for field property_type in message Property (7b156ee)

  • change comment for methods DeleteAccount, DeleteProperty, and RunAccessReport in service AnalyticsAdminService (7b156ee)

  • change comment in fields account and property in message SearchChangeHistoryEventsRequest (7b156ee)

0.22.8 (2024-07-08)

Bug Fixes

0.22.7 (2024-03-05)

Bug Fixes

0.22.6 (2024-02-22)

Bug Fixes

  • [Many APIs] fix ValueError in test__validate_universe_domain (#12280) (2d75d0e)

  • deps: [Many APIs] Require google-api-core>=1.34.1 (#12303) (fbb80c3)

0.22.5 (2024-02-06)

Bug Fixes

  • Add google-auth as a direct dependency (780c5f1)

  • Add staticmethod decorator to _get_client_cert_source and _get_api_endpoint (780c5f1)

  • Resolve AttributeError ‘Credentials’ object has no attribute ‘universe_domain’ (780c5f1)

0.22.4 (2024-02-01)

Features

  • Allow users to explicitly configure universe domain (a0392ee)

0.22.3 (2024-01-26)

Features

  • Add GetCalculatedMetric, CreateCalculatedMetric, ListCalculatedMetrics, UpdateCalculatedMetric, DeleteCalculatedMetric methods to the Admin API v1alpha (dea3367)

  • Add the calculated_metric field to the ChangeHistoryResource.resource oneof field (dea3367)

  • Add the CALCULATED_METRIC option to the ChangeHistoryResourceType enum (dea3367)

  • Add the CalculatedMetric resource (dea3367)

0.22.2 (2024-01-04)

Features

  • v1alpha: Add GetSubpropertyEventFilter, ListSubpropertyEventFilters methods to the Admin API v1 alpha (fd30dff)

  • v1alpha: Add the default_conversion_value field to the ConversionEvent type (fd30dff)

Documentation

  • v1alpha: Update the documentation for grouping_rule, system_defined fields of the ChannelGroup type (fd30dff)

  • v1alpha: Update the documentation for the RunAccessReport method (fd30dff)

0.22.1 (2023-12-07)

Features

  • Add support for python 3.12 (ea6cfc2)

  • Introduce compatibility with native namespace packages (ea6cfc2)

Bug Fixes

  • Require proto-plus >= 1.22.3 (ea6cfc2)

  • Use retry_async instead of retry in async client (ea6cfc2)

0.22.0 (2023-10-19)

Features

  • Add DataRedactionSettings, RollupPropertySourceLink, SubpropertyEventFilterCondition, SubpropertyEventFilterExpression, SubpropertyEventFilterExpressionList, SubpropertyEventFilterClause, SubpropertyEventFilter types (49d0449)

  • Add include_all_users, expand_groups fields to RunAccessReportRequest (49d0449)

  • Add UpdateDataRedactionSettings, CreateRollupProperty, GetRollupPropertySourceLink, ListRollupPropertySourceLinks, CreateRollupPropertySourceLink, DeleteRollupPropertySourceLink, CreateSubproperty, CreateSubpropertyEventFilter, CreateSubpropertyEventFilter, ListSubpropertyEventFilters, UpdateSubpropertyEventFilter, DeleteSubpropertyEventFilter methods to the Admin API v1 alpha (49d0449)

  • Add the data_redaction_settings field to the ChangeHistoryResource.resource oneof field (49d0449)

  • Add the DATA_REDACTION_SETTINGS option to the ChangeHistoryResourceType enum (49d0449)

Bug Fixes

  • Delete BatchDeleteUserLinks, DeleteUserLink, BatchUpdateUserLinks, UpdateUserLink, BatchCreateUserLinks, CreateUserLink, AuditUserLinks, ListUserLinks, BatchGetUserLinks, GetUserLink from the Admin API v1 alpha as per the announcement in https://bit.ly/46yBIDt (49d0449)

0.21.0 (2023-10-10)

⚠ BREAKING CHANGES

  • rename the enterprise_daily_export_enabled field to fresh_daily_export_enabled in the BigQueryLink resource

Features

  • Add CoarseValue, ConversionValues, EventMapping, SKAdNetworkConversionValueSchema types (cabcb1f)

  • Add GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas methods to the Admin API v1 alpha (cabcb1f)

  • Add UpdateConversionEvent method to the Admin API v1 beta (7c8f27f)

  • Add the ConversionCountingMethod enum (7c8f27f)

  • Add the counting_method field to the ConversionEvent type (7c8f27f)

  • Add the ITEM option to the DimensionScope enum (7c8f27f)

  • Add the skadnetwork_conversion_value_schema field to the ChangeHistoryResource.resource oneof type (cabcb1f)

  • Add the SKADNETWORK_CONVERSION_VALUE_SCHEMA option to the ChangeHistoryResourceType enum (cabcb1f)

  • Make the field default_uri of WebStreamData mutable (7c8f27f)

Bug Fixes

  • Add the missing REQUIRED annotation to the update_mask field of UpdateMeasurementProtocolSecretRequest (7c8f27f)

  • Rename the enterprise_daily_export_enabled field to fresh_daily_export_enabled in the BigQueryLink resource (cabcb1f)

Documentation

0.20.0 (2023-08-10)

Features

  • v1alpha: Add UpdateConversionEvent method to the Admin API v1 alpha (7685881)

  • v1alpha: Add the ConversionCountingMethod enum (7685881)

  • v1alpha: Add the counting_method field to the ConversionEvent type (7685881)

Bug Fixes

  • v1alpha: Rename the intraday_export_enabled field to enterprise_export_enabled in the BigQueryLink resource (7685881)

0.19.0 (2023-07-27)

Bug Fixes

  • v1alpha: Rename enum from ADS_PREFERRED_LAST_CLICK to GOOGLE_PAID_CHANNELS_LAST_CLICK (9a644b5)

  • v1alpha: Rename enum from ADS_PREFERRED to GOOGLE_PAID_CHANNELS (9a644b5)

  • v1alpha: Rename enum from CROSS_CHANNEL_DATA_DRIVEN to PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN (9a644b5)

  • v1alpha: Rename enum from CROSS_CHANNEL_FIRST_CLICK to PAID_AND_ORGANIC_CHANNELS_FIRST_CLICK (9a644b5)

  • v1alpha: Rename enum from CROSS_CHANNEL_LAST_CLICK to PAID_AND_ORGANIC_CHANNELS_LAST_CLICK (9a644b5)

  • v1alpha: Rename enum from CROSS_CHANNEL_LINEAR to PAID_AND_ORGANIC_CHANNELS_LINEAR (9a644b5)

  • v1alpha: Rename enum from CROSS_CHANNEL_POSITION_BASED to PAID_AND_ORGANIC_CHANNELS_POSITION_BASED (9a644b5)

  • v1alpha: Rename enum from CROSS_CHANNEL_TIME_DECAY to PAID_AND_ORGANIC_CHANNELS_TIME_DECAY (9a644b5)

  • v1alpha: Rename enum from CROSS_CHANNEL to PAID_AND_ORGANIC_CHANNELS (9a644b5)

0.18.1 (2023-07-04)

Bug Fixes

  • Add async context manager return types (#355) (2dfee7b)

0.18.0 (2023-06-21)

Features

  • Add AdsWebConversionDataExportScope enum (d3aeb71)

  • Add the ads_web_conversion_data_export_scope field to the ReportingAttributionModel type (d3aeb71)

  • Update the default_uri field of the WebStreamData type to be mutable (d3aeb71)

Documentation

  • Announce the deprecation of first-click, linear, time-decay and position-based attribution models (d3aeb71)

0.17.0 (2023-05-31)

Features

  • v1alpha: Add AdSenseLink type (e3b5b03)

  • v1alpha: Add audience, event_create_rule fields to the ChangeHistoryResource.resource oneof field (e3b5b03)

  • v1alpha: Add AUDIENCE, EVENT_CREATE_RULE options to the ChangeHistoryResourceType enum (e3b5b03)

  • v1alpha: Add ChannelGroupFilter, ChannelGroupFilterExpression, ChannelGroupFilterExpressionList, GroupingRule, ChannelGroup types (2ef0b67)

  • v1alpha: Add CreateEventCreateRule, UpdateEventCreateRule,DeleteEventCreateRule, ListEventCreateRules methods (e3b5b03)

  • v1alpha: Add EventCreateRule, MatchingCondition types (e3b5b03)

  • v1alpha: Add FetchConnectedGa4Property method (e3b5b03)

  • v1alpha: Add GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks methods (e3b5b03)

  • v1alpha: Add GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup methods (2ef0b67)

  • v1alpha: Add FetchConnectedGa4Property method (2ef0b67)

0.16.0 (2023-03-24)

Features

  • v1alpha: Add enhanced_measurement_settings option to the ChangeHistoryResource.resource oneof field (49c9f02)

  • v1alpha: Add ENHANCED_MEASUREMENT_SETTINGS option to the ChangeHistoryResourceType enum (49c9f02)

  • v1alpha: Add intraday_export_enabled field to the BigQueryLink resource (49c9f02)

  • v1alpha: Add account-level binding for the RunAccessReport method (49c9f02)

  • v1beta: Add AccessDimension, AccessMetric, AccessDateRange, AccessFilterExpression, AccessFilterExpressionList, AccessFilter, AccessStringFilter, AccessInListFilter, AccessNumericFilter, AccessBetweenFilter, NumericValue, AccessOrderBy, AccessDimensionHeader, AccessMetricHeader, AccessRow, AccessDimensionValue, AccessMetricValue, AccessQuota, AccessQuotaStatus types (c397e0a)

  • v1beta: Add RunAccessReport method (with bindings for account and property resources) (c397e0a)

Documentation

  • Fix formatting of request arg in docstring (#335) (5c24a33)

0.15.0 (2023-02-28)

Features

  • Add BigQueryLink, SearchAds360Link resource types to the Admin API v1alpha (efd4b20)

  • Add EXPANDED_DATA_SET, CHANNEL_GROUP values to ChangeHistoryResourceType enum (efd4b20)

  • Add GetBigQueryLink, ListBigQueryLinks methods to the Admin API v1alpha (efd4b20)

  • Add search_ads_360_link, expanded_data_set, bigquery_link values to ChangeHistoryResource.resource oneof field (efd4b20)

  • Add SetAutomatedGa4ConfigurationOptOut, FetchAutomatedGa4ConfigurationOptOut methods to the Admin API v1alpha (efd4b20)

  • Add tokens_per_project_per_hour field to AccessQuota type (efd4b20)

  • Add GetSearchAds360Link, ListSearchAds360Links, CreateSearchAds360Link, DeleteSearchAds360Link, UpdateSearchAds360Link methods to the Admin API v1alpha (efd4b20)

  • v1alpha: Add AccessBinding, ExpandedDataSet, ExpandedDataSetFilter, ExpandedDataSetFilterExpression, ExpandedDataSetFilterExpressionList resource types (1d2897e)

  • v1alpha: Add CreateAccessBinding, GetAccessBinding, UpdateAccessBinding, DeleteAccessBinding, ListAccessBindings, BatchCreateAccessBindings, BatchGetAccessBindings, BatchUpdateAccessBindings, BatchDeleteAccessBindings methods (1d2897e)

  • v1alpha: Add GetExpandedDataSet, ListExpandedDataSets, CreateExpandedDataSet, UpdateExpandedDataSet, DeleteExpandedDataSet methods (1d2897e)

Bug Fixes

  • Remove LESS_THAN_OR_EQUAL, GREATER_THAN_OR_EQUAL values from NumericFilter.Operation enum (efd4b20)

  • Remove PARTIAL_REGEXP value from StringFilter.MatchType enum (efd4b20)

0.14.1 (2023-01-20)

Bug Fixes

  • Add context manager return types (b43c855)

Documentation

  • Add documentation for enums (b43c855)

0.14.0 (2023-01-10)

Features

0.13.0 (2022-12-14)

Features

  • Add typing to proto.Message based class attributes (6fb3129)

Bug Fixes

  • deps: Require google-api-core >=1.34.0, >=2.11.0 (28dc93b)

  • Drop usage of pkg_resources (28dc93b)

  • Fix timeout default values (28dc93b)

Documentation

  • samples: Snippetgen handling of repeated enum field (6fb3129)

  • samples: Snippetgen should call await on the operation coroutine before calling result (28dc93b)

  • Updates the properties_run_access_report sample to return aggregated data instead of individual data access records (#298) (86568d1)

0.12.0 (2022-11-07)

Features

  • add support for google.analytics.admin.__version__ (380b426)

Bug Fixes

  • Add dict typing for client_options (380b426)

Documentation

  • Add a sample for runAccessReport method (#289) (6aa8f8c)

0.11.2 (2022-10-10)

Bug Fixes

  • deps: Allow protobuf 3.19.5 (#283) (e686492)

  • deps: require google-api-core>=1.33.2 (e686492)

0.11.1 (2022-10-03)

Bug Fixes

0.11.0 (2022-09-12)

Features

Bug Fixes

  • deps: require google-api-core>=1.33.0,>=2.8.0 (c220210)

  • deps: require protobuf >= 3.20.1 (c220210)

0.10.1 (2022-08-11)

Bug Fixes

  • deps: allow protobuf < 5.0.0 (#250) (84a8df1)

  • deps: require proto-plus >= 1.22.0 (84a8df1)

0.10.0 (2022-08-05)

Features

  • v1alpha: add GetAttributionSettings, UpdateAttributionSettings methods (6e6b741)

  • v1alpha: add GetAudience, ‘ListAudience’, ‘CreateAudience’, ‘UpdateAudience’, ‘ArchiveAudience’ methods (6e6b741)

  • v1alpha: add RunAccessReport method (#246) (6e6b741)

0.9.0 (2022-07-20)

Features

  • add audience parameter (dc6107c)

  • release the Google Analytics Admin API V1 Beta (dc6107c)

Bug Fixes

0.8.2 (2022-06-03)

Bug Fixes

Documentation

  • fix changelog header to consistent size (#228) (2385b9b)

0.8.1 (2022-05-13)

Bug Fixes

  • CustomDimension and CustomMetric resource configuration (#222) (79470bd)

0.8.0 (2022-03-07)

Features

  • add CreateDataStream, DeleteDataStream, UpdateDataStream, ListDataStreams operations to support the new DataStream resource (03abb54)

  • add DISPLAY_VIDEO_360_ADVERTISER_LINK, DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL fields to ChangeHistoryResourceType enum (03abb54)

  • add restricted_metric_type field to the CustomMetric resource (aeb64bf)

  • add api key support (#185) (2ec0a0b)

  • add the account field to the Property type (03abb54)

  • add the AcknowledgeUserDataCollection operation (03abb54)

  • add the new resource type DataStream, which is planned to eventually replace WebDataStream, IosAppDataStream, AndroidAppDataStream resources (03abb54)

  • move the GlobalSiteTag resource from the property level to the data stream level (aeb64bf)

  • remove WebDataStream, IosAppDataStream, AndroidAppDataStream resources (#195) (aeb64bf), closes #184

Bug Fixes

  • deps: require google-api-core>=1.31.5, >=2.3.2 (#194) (f2b9bc3)

  • deps: require proto-plus>=1.15.0 (f2b9bc3)

  • remove GetEnhancedMeasurementSettings, UpdateEnhancedMeasurementSettingsRequest, UpdateEnhancedMeasurementSettingsRequest operations from the API (03abb54)

  • resolve DuplicateCredentialArgs error when using credentials_file (49c8857)

Documentation

  • add autogenerated code snippets (323815a)

  • update the documentation with a new list of valid values for UserLink.direct_roles field (03abb54)

0.7.2 (2021-11-01)

Bug Fixes

  • deps: drop packaging dependency (be96ebc)

  • deps: require google-api-core >= 1.28.0 (be96ebc)

Documentation

  • list oneofs in docstring (be96ebc)

0.7.1 (2021-10-19)

Documentation

  • samples: add samples for Measurement Protocol Secrets management methods (#152) (e264571)

  • samples: add samples for Conversion Event management methods (#153) (126f271)

0.7.0 (2021-10-12)

Features

0.6.0 (2021-10-08)

Features

  • add context manager support in client (#146) (f1559b6)

0.5.2 (2021-10-07)

Bug Fixes

  • improper types in pagers generation (aa076a9)

Documentation

  • add samples for accounts.search_change_history_events() method (#137) (c299b37)

0.5.1 (2021-09-24)

Bug Fixes

  • add ‘dict’ annotation type to ‘request’ (256c880)

0.5.0 (2021-08-25)

Features

  • add CancelDisplayVideo360AdvertiserLinkProposal method to the API (2a1c5a0)

  • add CreateDisplayVideo360AdvertiserLink, DeleteDisplayVideo360AdvertiserLink methods to the API (2a1c5a0)

  • add custom output only field to ConversionEvent type (2a1c5a0)

  • add data_retention_settings fields to ChangeHistoryChange.resource oneof field. (2a1c5a0)

  • add DeleteDisplayVideo360AdvertiserLinkProposal method to the API (2a1c5a0)

  • add display_video_360_advertiser_link_proposal fields to ChangeHistoryChange.resource oneof field. (2a1c5a0)

  • add display_video_360_advertiser_link fields to ChangeHistoryChange.resource oneof field. (2a1c5a0)

  • add DisplayVideo360AdvertiserLink, LinkProposalState types to the API (2a1c5a0)

  • add GetDataRetentionSettings, UpdateDataRetentionSettings methods to the API (#119) (2a1c5a0)

  • add GetDisplayVideo360AdvertiserLink, ListDisplayVideo360AdvertiserLinks methods to the API (2a1c5a0)

  • add GetDisplayVideo360AdvertiserLinkProposal, ListDisplayVideo360AdvertiserLinkProposals methods to the API (2a1c5a0)

  • add LinkProposalInitiatingProduct, ServiceLevel, DataRetentionSettings types to the API (2a1c5a0)

  • add LinkProposalStatusDetails, DisplayVideo360AdvertiserLinkProposal types to the API (2a1c5a0)

  • add service_level field to Property type (2a1c5a0)

  • change measurement_unit field to mutable in CustomMetric type (2a1c5a0)

Bug Fixes

  • remove maximum_user_access field from FirebaseLink type (2a1c5a0)

  • remove MaximumUserAccess enum from the API (2a1c5a0)

  • remove UpdateFirebaseLink method from the API (2a1c5a0)

  • rename email_address field of GoogleAdsLink type to creator_email_address (2a1c5a0)

  • rename is_deletable field of ConversionEvent type to deletable (2a1c5a0)

0.4.3 (2021-07-27)

Bug Fixes

Documentation

  • add Samples section to CONTRIBUTING.rst (#102) (99d607c)

Miscellaneous Chores

0.4.2 (2021-07-20)

Bug Fixes

  • deps: pin ‘google-{api,cloud}-core’, ‘google-auth’ to allow 2.x versions (#101) (cde3379)

0.4.1 (2021-06-30)

Bug Fixes

  • disable always_use_jwt_access (5e3df32)

  • disable always_use_jwt_access (#95) (5e3df32)

0.4.0 (2021-06-23)

Features

Documentation

0.3.2 (2021-06-16)

Bug Fixes

0.3.1 (2021-06-16)

Bug Fixes

  • exclude docs and tests from package (#78) (680a695)

0.3.0 (2021-06-09)

Features

  • add ConversionEvent methods to the API (ab703de)

  • add ConversionEvent type (ab703de)

  • add CustomDimension methods to the API (ab703de)

  • add CustomDimension type (ab703de)

  • add CustomMetric methods to the API (ab703de)

  • add CustomMetric type (ab703de)

  • add GetGoogleSignalsSettings, UpdateGoogleSignalsSettings methods to the API (ab703de)

  • add GoogleSignalsSettings type (ab703de)

  • add GoogleSignalsState, GoogleSignalsConsent types (ab703de)

  • add MeasurementProtocolSecret type (ab703de)

  • add MeasurementProtocolSecret methods to the API (#71) (ab703de)

  • extend ChangeHistoryResourceType enum (ab703de)

Bug Fixes

  • label email_address field of UserLink type as immutable (ab703de)

  • label name field of UserLink type as output only (ab703de)

Documentation

  • add Admin API samples for account management methods (#58) (2ecc350)

  • add Admin API samples for account management methods (#65) (a3fecc4)

  • add Admin API samples for property stream management methods (#68) (27da97e)

  • add Admin API samples for property user link management methods (#67) (aa55627)

  • add samples for Google Analytics property management methods (#74) (bdb85be)

Miscellaneous Chores

0.2.0 (2021-01-20)

⚠ BREAKING CHANGES

  • update_mask field is required for all Update operations

  • rename country_code field to region_code in Account

  • rename url_query_parameter field to uri_query_parameter in EnhancedMeasurementSettings

  • remove parent field from GoogleAdsLink

  • remove unused fields from EnhancedMeasurementSettings (#29)

Features

  • add ListAccountSummaries (#20) (04d05d7)

  • add pagination support for ListFirebaseLinks operation (bc756a9)

Bug Fixes

  • update_mask field is required for all Update operations (bc756a9)

  • remove parent field from GoogleAdsLink (bc756a9)

  • remove unused fields from EnhancedMeasurementSettings (#29) (bc756a9)

  • rename country_code field to region_code in Account (bc756a9)

  • rename url_query_parameter field to uri_query_parameter in EnhancedMeasurementSettings (bc756a9)

Documentation

0.1.0 (2020-07-23)

Features