Changelog

For official Google Analytics API announcements, please subscribe to Google Analytics API Notify Group .

2025-08-20Added GetReportingIdentitySettings method

Added the GetReportingIdentitySettings method to the Admin API v1alpha, which lets you retrieve the ReportingIdentitySettings for a property.

2025-08-20Removed legacy Universal Analytics methods

The following legacy Universal Analytics (UA) methods have been removed from the Admin API v1alpha: SetAutomatedGa4ConfigurationOptOut , FetchAutomatedGa4ConfigurationOptOut , CreateConnectedSiteTag , DeleteConnectedSiteTag , ListConnectedSiteTags , and FetchConnectedGa4Property .

2025-06-12Added subproperty sync configuration management methods

Added GetSubpropertySyncConfig , ListSubpropertySyncConfig , and UpdateSubpropertySyncConfig methods for managing SubpropertySyncConfig resources with the Admin API v1alpha.

2025-04-16Added Reporting Data Annotation management methods

Added CreateReportingDataAnnotation , GetReportingDataAnnotation , ListReportingDataAnnotations , UpdateReportingDataAnnotation and DeleteReportingDataAnnotation methods for managing ReportingDataAnnotation resources with the Admin API v1alpha.

Annotations allow users to add notes directly to Google Analytics reports, making it easier to record events, explain changes in data, or highlight key observations for yourself and your team.

2025-03-07Deprecating the sharingWithGoogleAnySalesEnabled parameter

The sharingWithGoogleAnySalesEnabled parameter of the getDataSharingSettings method is now deprecated and will always return false . The field will be removed from the Google Analytics Admin API v1beta in June, 2025.

2025-01-20Added user data retention to DataRetentionSettings

Added the userDataRetention field to DataRetentionSettings in the Admin API v1alpha and v1beta. Use this field to retrieve or modify retention settings for user data.

2024-09-09Access Reports survey form

The documentation for the runAccessReport method has been updated to include a link to the Google Analytics Access Reports feedback form. We value your input and encourage you to share your thoughts on this API to help us improve it further.

2024-08-01Added BigQuery link management

Added CreateBigQueryLink , UpdateBigQueryLink , and DeleteBigQueryLink methods for managing BigQueryLink resources with the Admin API v1alpha.

Added the dataset_location field to the BigQueryLink resource.

Added BigQuery link changes to change history under the new BIGQUERY_LINK value in ChangeHistoryResourceType .

2024-08-01Breaking change to the createSubproperty method

Renamed the createSubproperty custom method to provisionSubproperty in the Admin API v1alpha to align with custom method guidelines .

2024-08-01Added event edit rule management

GetEventEditRule , CreateEventEditRule , DeleteEventEditRule , ListEventEditRules , UpdateEventEditRules , ReorderEventEditRules , methods added to the Admin API v1alpha.

An EventEditRule defines conditions that will trigger the creation of an entirely new event based upon matched criteria of a source event. In addition, an EventEditRule can define modifications of the parameters from the source event.

2024-08-01Miscellaneous changes

Added create_time to the Audience resource.

Added primary to the ChannelGroup resource to indicate if the channel group is the default channel group for reports. Only one channel group can have primary set to true at any given time. Setting primary to true for a channel group automatically sets primary to false for the previous primary channel group.

Added gmp_organization to the Account resource, which contains the URI for a Google Marketing Platform organization resource if the account is connected to a GMP organization.

2024-05-06Added key events management methods

Resources and methods for key events are now available.

Modify your API integration to use KeyEvent instead of ConversionEvent . ConversionEvent is deprecated.

2023-12-15Data access reports are now available for all Google Analytics properties.

Certain fields of the Data access reports feature are now available for all Google Analytics properties, both Standard and Google Analytics 360 customers.

See the schema documentation for more information.

2023-12-15The accessDateHour dimension added to the Data access report schema.

The accessDateHour dimension added to the Data access report schema . It contains the date hour of the GA user that accessed GA reporting data.

2023-10-05Properties with first-click, linear, time-decay and position-based attribution models default to cross-channel DDA.

Starting in mid-October 2023, the first-click , linear , time-decay and position-based attribution models will be unavailable to use with the UpdateAttributionSettings method for all properties.

If your property is currently configured to use one of these models, it will be changed to cross-channel data-driven attribution . You will still have the options to use Cross-channel last click or Ads-preferred last click instead.

2023-09-01Added SKAdNetwork conversion value schema configuration methods.

GetSKAdNetworkConversionValueSchema , CreateSKAdNetworkConversionValueSchema , DeleteSKAdNetworkConversionValueSchema , UpdateSKAdNetworkConversionValueSchema , ListSKAdNetworkConversionValueSchemas methods added to the Admin API v1alpha.

This functionality allows managing the SKAdNetwork conversion value schema configuration for an iOS stream.

2023-09-01Added UpdateConversionEvent method.

UpdateConversionEvent method added to the Admin API v1beta.

2023-09-01 BigQueryLink.enterprise_export_enabled field renamed to fresh_daily_export_enabled .

The enterprise_export_enabled field of the BigQueryLink resource renamed to fresh_daily_export_enabled .

2023-07-14Breaking changes to properties.updateAttributionSettings , properties.getAttributionSettings methods.

Starting July 24th, 2023, breaking changes will be made to the Admin API v1 alpha which will affect the functionality of properties.getAttributionSettings , properties.updateAttributionSettings methods.

Members of the ReportingAttributionModel enum will be renamed as follows:

Old name	New name
CROSS_CHANNEL_DATA_DRIVEN	PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN
CROSS_CHANNEL_LAST_CLICK	PAID_AND_ORGANIC_CHANNELS_LAST_CLICK
CROSS_CHANNEL_FIRST_CLICK	PAID_AND_ORGANIC_CHANNELS_FIRST_CLICK
CROSS_CHANNEL_LINEAR	PAID_AND_ORGANIC_CHANNELS_LINEAR
CROSS_CHANNEL_POSITION_BASED	PAID_AND_ORGANIC_CHANNELS_POSITION_BASED
CROSS_CHANNEL_TIME_DECAY	PAID_AND_ORGANIC_CHANNELS_TIME_DECAY
ADS_PREFERRED_LAST_CLICK	GOOGLE_PAID_CHANNELS_LAST_CLICK

Members of the AdsWebConversionDataExportScope enum will be renamed as follows:

Old name	New name
CROSS_CHANNEL	PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED	GOOGLE_PAID_CHANNELS

2023-07-10Added the ads_web_conversion_data_export_scope field to the AttributionSettings type

Added the ads_web_conversion_data_export_scope field to the AttributionSettings type which can be modified using the UpdateAttributionSettings method.

2023-06-05Deprecation of first-click, linear, time-decay and position-based attribution models.

Starting June 2023, the UpdateAttributionSettings method cannot be used to configure GA4 properties with first-click , linear , time-decay and position-based attribution models. Starting in September 2023, these models will become unavailable for all properties.

Refer to the Google Analytics product announcement for more information.

2023-05-31Added AdSense links management methods.

GetAdSenseLink , CreateAdSenseLink , DeleteAdSenseLink , ListAdSenseLinks methods added to the Admin API v1alpha.

This functionality allows managing AdSense to Analytics links for a GA4 property.

2023-05-31Added a method to lookup a connected GA4 property.

The FetchConnectedGa4Property method added to the Admin API v1alpha

This functionality allows to obtain information about a GA4 property linked your Universal Analytics property during the GA4 migration process.

2023-05-31Added method to manage event creation rules.

The CreateEventCreateRule , UpdateEventCreateRule , DeleteEventCreateRule , ListEventCreateRules , GetEventCreateRule methods added to the Admin API v1alpha.

This functionality allows to manage event creation rules which can trigger the creation of an entirely new event based upon matched criteria of a source event.

2023-05-31Added methods to manage custom channel groups.

Added GetChannelGroup , ListChannelGroups , CreateChannelGroup , UpdateChannelGroup , DeleteChannelGroup methods to the Admin API v1alpha.

This functionality allows to manage custom channel groups for your website's traffic sources.

Once created, custom channel groups can be queried using the Google Analytics Data API v1 .

2023-03-31Added Enhanced Measurement Settings management methods.

The properties.dataStreams.updateEnhancedMeasurementSettings , properties.dataStreams.getEnhancedMeasurementSettings methods added to the Admin API v1alpha.

This functionality allows managing Enhanced Measurement Settings for a Web Data Stream of a GA4 property.

2023-03-31Added Connected Site Tag management methods.

The properties.createConnectedSiteTag , properties.deleteConnectedSiteTag , properties.listConnectedSiteTags methods added to the Admin API v1alpha.

This functionality allows managing Connected Site Tags and is useful for forwarding traffic from a Universal Analytics property to a Google Analytics 4 property.

2023-03-31Added account and property-level runAccessReport methods to Admin API v1beta.

The properties.runAccessReport and accounts.runAccessReport methods added to the v1beta version of the Admin API. Methods return a customized report of data access records .

2023-02-24Added Expanded Data Sets management methods.

The ExpandedDataSet resource has been added to the v1alpha version of the API, along with the corresponding properties.expandedDataSets.create , properties.expandedDataSets.delete , properties.expandedDataSets.patch , properties.expandedDataSets.list , properties.expandedDataSets.get operations. This functionality can be used for managing Expanded Data Sets in Google Analytics 360.

2023-02-24Access Bindings are replacing User Links for user permissions management.

The AccessBinding resource has been added to the v1alpha version of the API, along with the following operations:

• accounts.accessBindings.create
• accounts.accessBindings.delete
• accounts.accessBindings.patch
• accounts.accessBindings.list
• accounts.accessBindings.get
• accounts.accessBindings.batchCreate
• accounts.accessBindings.batchDelete
• accounts.accessBindings.batchUpdate
• accounts.accessBindings.batchGet
• properties.accessBindings.create
• properties.accessBindings.delete
• properties.accessBindings.patch
• properties.accessBindings.list
• properties.accessBindings.get
• properties.accessBindings.batchCreate
• properties.accessBindings.batchDelete
• properties.accessBindings.batchUpdate
• properties.accessBindings.batchGet

This functionality allows managing user permissions for a GA4 account or property and should be used instead of User Links .

User Links functionality will be removed from the Admin API v1 alpha on 6/1/23

2023-02-24Deprecation of the user permissions audit methods.

The following methods are deprecated and will be removed from the Admin API v1 alpha on 6/1/23:

• accounts.userLinks.audit
• properties.userLinks.audit

2023-02-24Added Audience management methods.

The Audience resource has been added to the v1alpha version of the API, along with the corresponding properties.audience.create , properties.audience.archive , properties.audience.patch , properties.audience.list , properties.audience.get operations.

This functionality allows managing audiences for a GA4 property.

2023-02-15Added automated GA4 setup process opt-out methods.

properties.setAutomatedGa4ConfigurationOptOut , properties.fetchAutomatedGa4ConfigurationOptOut operations have been added to the v1alpha version of the API.

This functionality allows managing the opt out status for the automated GA4 setup process for a UA property.

2023-02-15Added BigQuery links management methods.

The BigQueryLink resource has been added to the v1alpha version of the API, along with the corresponding properties.bigQueryLinks.get , properties.bigQueryLinks.list operations.

This functionality allows retrieving information about links between a GA4 Property and a BigQuery project .

2023-02-15Added Search Ads 360 links management methods.

The SearchAds360Link resource has been added to the v1alpha version of the API, along with the corresponding properties.searchAds360Links.create , properties.searchAds360Links.delete , properties.searchAds360Links.patch , properties.searchAds360Links.list , properties.searchAds360Links.get operations.

This functionality allows managing links between a GA4 property and a Search Ads 360 entity.

2023-02-15Breaking changes.

• LESS_THAN_OR_EQUAL , GREATER_THAN_OR_EQUAL values removed from the NumericFilter.Operation enum.

• PARTIAL_REGEXP value removed from the StringFilter.MatchType enum.

2023-02-15Miscellaneous changes.

• tokensPerProjectPerHour field added to the AccessQuota type.
• EXPANDED_DATA_SET , CHANNEL_GROUP values added to the ChangeHistoryResourceType enum.
• searchAds360Link , expandedDataSet , bigqueryLink values added to ChangeHistoryResource .

2022-08-11 runAccessReport method added to Admin API v1alpha.

The properties.runAccessReport method added to the v1alpha version of the Admin API. It returns a customized report of data access records. The report provides records of each time a user reads Google Analytics reporting data. Data Access Reports are available to Administrators of Google Analytics 360 properties.

2022-07-11Admin API v1beta version released.

The v1beta version of the Google Analytics Admin API has been released.

Both Alpha and Beta channels of the API continue to be supported for the Admin API. Beta channel contains a subset of the features available in Alpha which are considered stable and not expected to undergo a significant change in the future. New features will be added to Beta once they mature.

2021-10-12EnhancedMeasurementSettings methods removed from the API.

• properties.webDataStreams.getEnhancedMeasurementSettings , properties.webDataStreams.updateEnhancedMeasurementSettings methods are removed from the API, but Enhanced Measurement settings will again be modifiable via API soon.
• The directRoles field of the UserLink resource no longer supports predefinedRoles/manage-users role. The new predefinedRoles/admin role should be used instead, which is equivalent to the combination of the old predefinedRoles/edit and predefinedRoles/manage-users roles. This change affects the behavior of accounts.userLinks , properties.userLinks methods and is in line with the Access and data-restriction management changes introduced in the Google Analytics.

2021-06-05Features added.

The following features are added to the API:

• accounts.searchChangeHistoryEvents method was added to the API. This method searches through all changes to an account or its children given the specified set of filters. Common causes would be updates made in the Google Analytics UI, changes from customer support, or automatic Google Analytics system changes.
• Measurement protocol secrets management methods added under properties.webDataStreams.measurementProtocolSecrets :
  • create Creates a measurement protocol secret.
  • delete Deletes target measurement protocol secret.
  • get Lookup for a single measurement protocol secret.
  • list Returns child measurement protocol secrets under the specified parent Property.
  • patch Updates a measurement protocol secret.
• Conversion events management methods added under properties.conversionEvents :
  • create Creates a conversion event with the specified attributes.
  • delete Deletes a conversion event in a property.
  • get Retrieve a single conversion event.
  • list Returns a list of conversion events in the specified parent property.
• Custom dimensions management methods added under properties.customDimensions :
  • archive Archives a custom dimension on a property.
  • create Creates a custom dimension.
  • get Lookup for a single custom dimension.
  • list Lists custom dimensions on a property.
  • patch Updates a custom dimension on a property.
• Custom metrics management methods added under properties.customMetrics :
  • archive Archives a custom metric on a property.
  • create reates a custom metric.
  • get Lookup for a single custom metric.
  • list Lists custom metrics on a property.
  • patch Updates a custom metric on a property.
• Added properties.getGoogleSignalsSettings , properties.updateGoogleSignalsSettings methods that allow to control the Google Signals setting for a Google Analytics 4 property.
• delete_time , expire_time output only fields added to the Property type.

2021-06-05Breaking changes.

The following breaking changes were introduced:

• properties.iosAppDataStreams.create , properties.androidAppDataStreams.create methods were removed from the API. Please use Firebase to create application streams in a Google Analytics 4 property.
• properties.delete method now returns the deleted property data as Property type instead of returning an empty response.
• time_zone field of the Property type is now required.
• deleted field removed from the Property type.
• email_address field of the UserLink type is now immutable.
• name field of the UserLink type is now output only.

2021-01-28Pagination support added for ListFirebaseLinks operation.

2021-01-28Breaking changes.

Breaking changes: - update_mask field is required for all Update operations.

• country_code field renamed to region_code in Account .

• url_query_parameter field renamed to uri_query_parameter in EnhancedMeasurementSettings .

• parent field removed from GoogleAdsLink .

2020-10-20Added support for account summaries.

Added support for account summaries method.

2020-10-13App + Web properties renamed to Google Analytics 4 (GA4).

2020-08-15Management App + Web API renamed to Admin API.

Google Analytics Management App + Web API has been renamed to the Google Analytics Admin API. As a result, the API endpoint has changed to analyticsadmin.googleapis.com. Existing code written against the previous version of the API endpoint url and client libraries needs to be updated accordingly.