Changelog

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

2023-05-31 Added 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-31 Added 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-31 Added 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-31 Added 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-31 Added 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-31 Added 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-31 Added 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-24 Added 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-24 Access 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-24 Deprecation 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-24 Added 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-15 Added 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-15 Added 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-15 Added 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-15 Breaking 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-15 Miscellaneous 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-11 Admin 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-12 EnhancedMeasurementSettings 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-05 Features 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-05 Breaking 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-28 Pagination support added for ListFirebaseLinks operation.

2021-01-28 Breaking 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-20 Added support for account summaries.

Added support for account summaries method.

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

2020-08-15 Management 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.