We periodically update the Google Analytics Management API in order to deliver new features and to repair defects discovered in previous versions. In most cases, these changes will be transparent to API developers. However, occasionally we need to make changes that require developers to modify their existing applications.
This page documents any changes made to the Google Analytics Management API that might affect your application. We recommend that API developers periodically check this list for any new announcements. You can also subscribe to changes via the feeds listed under the Subscribe section below.
Subscribe To Related Changelogs
Includes all Collection, Configuration, and Reporting APIs.
Includes Management API and Provisioning API.
Release 2018-07-17 (July 17, 2018)
hashClientId method added to the Management API
The hashClientId method provides the hash of the given Client ID, which can be found in certain exported data formats, such as in Google Analytics data exported to BigQuery.
Release 2018-05-11 (May 11, 2018)
User data retention settings in the Management API
It is now possible to programmatically configure the user data retention settings using new ‘dataRetentionTtl’ and ‘dataRetentionResetOnNewActivity’ fields added to the WebProperty resource.
Release 2018-02-22 (February 22, 2018)
Write operations in the Management API
Write operations in the Management API (e.g. create, update, delete, patch) for Web Property, View (Profile), and Goal resources no longer require whitelisting. The default daily limit for all Write operations in the Management API is 50 writes/day. See Limits and Quotas page for more information.
Release 2017-04-19 (April 19, 2017)
Remarketing Audience - Optimize support
This release adds support for Google Optimize, OPTIMIZE
as a linked ad account type. See the Remarketing Audience reference docs and the Remarketing Audience developer guide for details.
Release 2017-03-23 (March 23, 2017)
Remarketing Audience
This release adds the DELETE
verb to the Remarketing Audience resource. See the Remarketing Audience developer guide for details.
- Remarketing Audience: delete - deletes a remarketing audience.
Release 2017-02-09 (February 9, 2017)
Custom Metrics
This is a bug fix release; it fixes the issue where creating a Custom Metric of type TIME
failed when min_value
was not set. Requests without a min_value
now create a custom metric with a default min_value
of 0.
Release 2016-08-09 (August 9, 2016)
Currencies
This is a bug fix release; it fixes an issue where a subset of currencies were supported in the Analytics web interface but not in the API. This release adds support for the following currencies:
- UAH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF, LVL
For more information see: - The Views (profiles) reference. - The Currency reference help center article.
Release 2016-08-08 (August 8, 2016)
This release adds Remarketing Audiences to the Management API.
Remarketing Audieces
The Management API allows you to create
, get
, list
, update
and patch
remarketing audiences for a Google Analytics property. To learn more about how remarketing audiences work, see the About Remarketing Audiences in Analytics help center article.
Release 2016-03-11 (March 11, 2016)
Starring
This release adds the starred
property to Account Summaries, Accounts, Web Properties, and Views (Profiles).
Release 2016-02-25 (February 25, 2016)
Error rate limiting
It has always been our policy that developers should implement exponential backoff, when handling 500 or 503 responses. Today we are introducing a rate limit on 500 and 503 errors to enforce this policy.
- 50 failed write requests per hour.
Release 2016-02-01 (February 1, 2016)
Unsampled Reports
The unsampled reports API no longer has a 100 reports per day limit. The API uses the same per-property, per-day token system as when creating an unsampled report through the web interface.
Release 2016-01-26 (January 26, 2016)
Unsampled Reports
Unsampled reports that are not accessible to the current user will no longer have a download link inside the Management API response message. This behavior is now consistent with UI dashboard functionality where only report owners can see the download link for the generated document.
Release 2015-12-17 (December 17, 2015)
Views (Profiles)
This release adds the botFilteringEnabled
property to the view (profile) resource. This property indicates whether bot filtering is enabled for a view (profile). See the View (Profiles) Reference docs for details.
Unsampled Reports
This release add the delete
method to unsampled reports. See the Unsampled Reports Delete Reference docs for details.
Release 2015-11-17 (November 17, 2015)
Segments
This is a bug fix release. This release fixes an issue which would cause segments with currency values in the definition to appear incorrectly when calling the segments list method.
Release 2015-10-06 (October 6, 2015)
Segments
This is a bug fix release. This release fixes an issue which would cause users with private segments pinned to multiple views (profiles) to get a 500
error response when calling the segments list method.
Release 2015-09-03 (September 3, 2015)
Batching
With this release, in addition to general batching support, we have added special support for the User Permissions API. Batched User Permissions requests will see significant performance gains and reduced quota usage.
Release 2015-08-06 (August 6, 2015)
Views (Profiles)
With this release the View (Profile) currency
property will now default to USD if not set during an insert operation. Also get
and list
operations will return USD on Views (Profiles) that were previously created without a currency
property.
-
Please see the View (Profile) developer guide for details on using View (Profiles) in the Management API.
-
Please see the View (Profiles) reference for the complete list of parameters for the View (Profile) resource.
Release 2015-05-28 (May 28, 2015)
Filters
This release marks the final removal of the deprecated filter fields IS_MOBILE
and IS_TABLET
, which should be replaced with DEVICE_CATEGORY=mobile
and DEVICE_CATEGORY=tablet
. Insert, update and patch requests which set the filter fields to use IS_MOBILE
and IS_TABLET
will return an error.
-
Please see the Filter developer guide for details on using filters in the Management API.
-
Please see the Filters reference for the complete list of parameters for the Filter resource.
Release 2015-05-05 (May 5, 2015)
Filters
This release adds support to use a custom dimension for a filter field by adding a fieldIndex
property to all the filter details sections. For example it is now possible to set the filter expression with a "field": "CUSTOM_DIMENSION"
and the "fieldIndex": "1"
to have the filter work on the first custom dimension.
-
Please see the Filter developer guide for details on using filters in the Management API.
-
Please see the Filters reference for complete list of parameters for the Filter resource.
Goals
This release also fixes an issue when creating a goal with "comparisonValue": "0"
would fail.
-
Please see the Goal developer guide for details on using goals in the Management API.
-
Please see the Goals reference for complete list of parameters for the Goal resource.
Release 2015-03-13 (March 13, 2015)
This release marks the final turndown and removal of the dailyUpload
resouce. The dailyUpload
resource was officially deprecated on June 20, 2014; all cost data import should now be done using the uploads resource.
- Please see the Data Deprecation Policy for more details on the Google Analytics API’s deprecation process.
- See the Data Import Developer Guide for details on how to use to import data into Google Analytics.
Release 2015-01-23 (January 23, 2015)
This release adds two new collections to the Management API, Custom Dimensions and Custom Metrics.
Custom Dimensions and Metrics
It is now possible to create, list, get, patch, and update Custom Dimensions and Metrics with the Management API.
Release 2015-01-08 (January 8, 2015)
The list
method response for all collections now include an empty list for the items
property when the collection contains no resources. Previously the items
property would be omitted from the response. See the API Reference for complete details on queries and responses for Google Analytics configuration data.
Release 2014-12-16 (December 16, 2014)
Bug Fixes
- Fix for Issue 467 - The segments collection now returns segments that use the
dateOfSession
syntax.
Release 2014-11-20 (November 20, 2014)
This release introduces a new scope for the Google Analytics Management API. - analytics.manage.users.readonly
- View Google analytics user permissions.
Release 2014-11-05 (November 5, 2014)
A new DEVICE_CATEGORY
filters field has been added and IS_MOBILE
and IS_TABLET
are now deprecated. Use DEVICE_CATEGORY=mobile
and DEVICE_CATEGORY=tablet
.
Release 2014-10-29 (October 29, 2014)
The View (Profile) resource now includes an enhancedECommerceTracking
property that indicates whether Enhanced Ecommerce is enabled (true
) or disabled (false
).
Release 2014-06 (June 20, 2014)
This release includes new data import types and the deprecation of the dailyUpload
resource.
Data Import
See the Data Import Developer Guide for details how to use the Management API to import data to your Google Analytics account.
Uploads
- The
upload
resource now supports the following upload types:- Campaign Data
- Content Data
- Cost Data
- Product Data
- Refund Data
- User Data
- The
upload
resource has a newmigrateDataImport
method to migrate existing Cost DatacustomDataSources
.
Daily Uploads Deprecation
- The
dailyUpload
resource is now deprecated! see the Migration Guide for details on migrating to use the Data Import feature. - The
dailyUpload
resource will continue to work for six more months, at which point any remainingcustomDataSources
withuploadType
property set toanalytics#dailyUploads
will be automatically migrated and only work with theupload
resource. - Current users of the
dailyUpload
resource should update their code and migrate to use the Upload resource as soon as possible.
Release 2014-05 (May 28, 2014)
This release adds two new configuration APIs.
AdWords Links
-
AdWords Links in the Management API allows you to create, list, get, update, patch, and delete links between Google AdWords accounts and Google Analytics properties and manage which Views (Profiles) are linked to Adwords data.
Filters
-
Filters in the Management API allows you to create, list, get, update, patch, and delete filters for your Google Analytics account. Profile Filter Links allow you to create, list, get, update, patch, and delete links between Filters and Views (Profiles).
Release 2014-05-27 (May 27, 2014)
Unsampled Reports: Management API
A new resource is being added to the Management API called Unsampled Reports. Unsampled reports are Google Analytics (GA) reports that have been generated using unsampled data. Unsampled reports are currently only available to GA Premium users.
- See the Developer Guide
Release 2014-04-11 (April 11, 2014)
Segments: Management API v2.4 & v3.0
The following changes have been made to the Segments Collection:
- User and sequence segments are now supported in the API.
- The Segments Collection now returns all built-in and custom session level and user level segments.
- The
definition
property for segments will now use the new segments syntax. This includes definitions for existing session level segments which will change fromdefinition: "
to" definition: "sessions::condition::
." - A new
type
property has been added to the Segment resource to indicate whether a segment isCUSTOM
(i.e. created by a user in the web interface) orBUILT_IN
(i.e. provided by Google Analytics).
Experiments
The following AdSense metrics can now be used as optimization objectives:
ga:adsenseAdsClicks
— The number of times AdSense ads on your site were clicked.ga:adsenseAdsViewed
— The number of AdSense ads viewed. Multiple ads can be displayed within an Ad Unit.ga:adsenseRevenue
— The total revenue from AdSense ads.
Release 2014-03-25 (March 25, 2014)
New Account Summaries Collection
- The AccountSummaries collection has been added to the Management API. It provides a summary of information for each account, property, and view (profile) an authorized user has access to in a single and fast request. See the Account Summaries Developer Guide for details.
Release 2013-12-12 (December 12, 2013)
The following changes have been made to default segments due to the deprecation of the ga:isMobile
and ga:isTablet
dimensions:
- Segment
gaid::-11
has been renamed from Mobile Traffic to Mobile and Tablet Traffic. The definition for this segment has been changed fromga:isMobile==Yes
toga:deviceCategory==mobile,ga:deviceCategory==tablet
. Note thatga:isMobile
included tablet traffic, which is reflected in the new definition. If you only want mobile traffic, excluding tablet, then switch to the new Mobile Traffic segment (gaid::-14
). - Segment
gaid::-13
definition has changed fromga:isTablet==Yes
toga:deviceCategory==tablet
. This continues to represent Tablet Traffic. - Segment
gaid::-14
has been added. The name of the segment is Mobile Traffic and the definition isga:deviceCategory==mobile
.
Release 2013-10-28 (October 28, 2013)
Bug Fixes:
- Timezone information for views (profiles) has been fixed. Details: Before this fix, in certain cases when listing view (profiles) in the Management API, incorrect timezone information for a view (profile) was returned. Now timezone information for views (profiles) is consistent with what is set in the Google Analytics admin interface.
Release 2013-10-04 (October 4, 2013)
Uploads (Dimension Widening)
- The new Uploads resource enables uploading of Dimension Widening data. See the Data Import (Uploads) Developer Guide for details.
Release 2013-10-03 (October 3, 2013)
This release introduces write operations for Web Property, View (Profile), and Goal resources and a set of 3 new resources that enable User Permissions management.
Account Setup and Configuration APIs
- Views (Profiles) can now be created, updated, patched, and deleted. Review the View (Profiles) reference for details on the new methods.
- Web Properties and Goals can now be created, updated, and patched. Review the Web Properties reference and Goals reference for details on the new methods.
- A single Web Property, View (Profile), or Goal can now be requested with the
get
method. - These features are currently available as a developer preview in limited beta. If you’re interested is signing up, request access to the beta.
User Permissions in the Management API
- The new accountUserLinks resource enables the management of account permissions for users.
- The new webpropertyUserLinks resource enables the management of property permissions for users.
- The new profileUserLinks resource enables the management of view (profile) permissions for users.
- Permissions for an authorized user are now available as part of the Account, Web Property and View (Profile) resources.
- A new scope has been introduced and is required to manage user permissions.
https://www.googleapis.com/auth/analytics.manage.users
. - See the User Permissions Dev Guide for additional details.
Release 2013-07-15 (July 16, 2013)
As part of the new segments launch, we will be rolling out the following changes to the Segments Collection:
- All Segment IDs will be changed from positive integers to alphanumeric strings. If you have saved users’ Segment IDs, we recommend you update them to use the new IDs.
- The Segments Collection will only return the existing visit level segments. The new visitor, cohort, and sequence segments are currently not supported in the API.
- The Segments Collection will continue to return the existing default segments with the same negative numeric IDs, however, the new default segments are currently not supported.
Release 2013-06-05 (June 5, 2013)
This release adds 2 new properties to the Webproperty resource:
profileCount
- Returns profile count for a property. This allows you to filter properties that don’t have any profiles (i.e., profileCount = 0).industryVertical
- Returns the industry vertical/category selected for a property.
Bug Fixes:
- The
eCommerceTracking
property of the Profile resource is now consistent with Ecommerce settings in the admin section of the web interface. Returnstrue
when Ecommerce tracking is enabled, andfalse
if not.
Release 2013-05-08 (May 8, 2013)
- The Webproperty resource now includes a
level
property to indicate whether the web property isPREMIUM
orSTANDARD
.
Release 2013-04-04 (April 4, 2013)
- A new endpoint has been added to the Management API v3 to access and modify Experiments resources.
Release 2013-01-14 (January 14, 2013)
- The Profile resource now includes a
type
property to identify whether a profile is configured for a Web site or App. The two possible values are:WEB
orAPP
.
Release 2012-01 (January 26, 2012)
This release adds helpful error responses to the Management API.
- New error codes, reasons, and descriptions have been added to the body of API error responses. All the codes have been documented for both the versions - Version 2.4 and Version 3.0 - of the Management API.
Release 2011-12 (December 5, 2011)
This release adds data, changes existing functionality and fixes a bug.
New Data
- The Advanced Segment collection now contains a
segmentId
field that can be used in the Data Export API segment parameter.
Changes
-
The data type for
max-results
has been changed tointeger
. -
The default and maximum value for
max-results
has been changed to 1000.
Bug Fixes
- Accounts, web properties, and profiles for Google Website Optimizer experiments are no longer included in their corresponding collections.
Release 2011-08 (August 29, 2011)
This release adds two new versions of the API with many new features, and it deprecates the old version. The changes impact the way you request and handle data from the API.
Version 3.0
-
This is the latest major version of our API and is not backwards compatible. All future development of the API will be done on this version.
-
New data
- Full representation of event goals
- An internal web property ID that can be used to deep link into the GA user interface
- Profile configurations for the default page and site search query parameters
-
Changes
- A new quota policy
- Integration with the Google APIs Console to manage API access and request more quota
- Support for OAuth 2.0 as the new, recommended way to authorize users
- New URL to make requests:
https://www.googleapis.com/analytics/v3/management/…
- More compact API response using JSON
- New Google API client libraries that support many more languages
- Support for the Google Discovery API
Version 2.4
-
This is a minor version upgrade that is mostly backwards compatible with the existing Version 2.3.
-
Changes
- A new quota policy
- Integration with the Google APIs Console to manage API access and request more quota
- Continued support for existing authorization mechanisms and OAuth 2.0
- New URL to make requests:
https://www.googleapis.com/analytics/v2.4/management/…
- Responses in XML only
- No support for the Google Data JavaScript client library
- XML output consistent with version 2.3, so the other existing Google Data client libraries will continue to work.
Deprecation
- We are announcing the deprecation of the legacy version 2.3 of the Management API. It will continue to work for two months, after which all v2.3 requests will return a v2.4 response.
Release 2010-08 (August 18, 2010)
This is the beta release of the Google Analytics Management API!
New Feeds
-
Five new feeds have been created to simplify accessing Google Analytics account configuration data:
Updated Client Libraries
- The Management API is being released in the same library as the Google Analytics Data Export API. Both Google Data Java and JavaScript libraries have been updated. Each feed can be accessed by specifying the appropriate feed URI to the libraries
getManagementFeed()
method.
New Documentation
- A new section of the Google Analytics developer docs has been created to describe how the new Management API works.