Click here to see your recently viewed pages and most viewed pages.
Hide

API Reference

This is the reference guide for the Management API Version 3.0. It provides complete details on queries and responses for Google Analytics configuration data. For a guide to concepts and structure of configuration data, see the Version 3.0 Overview.

Each section in this guide defines the request method and response for one kind of entity in the configuration data for an authenticated user.  Requests are all shown in REST format.  At the end of the page for each method, you can try out the request interactively in the APIs Explorer by using the "Try it!" link.

Resource types

  1. Account Summaries
  2. Accounts
  3. Web Properties
  4. Views (Profiles)
  5. Filters
  6. Goals
  7. Segments
  8. Account User Links
  9. Webproperty User Links
  10. Profile User Links
  11. Profile Filter Links
  12. AdWords Links
  13. Custom Data Sources
  14. Custom Metrics
  15. Custom Dimensions
  16. Uploads
  17. Experiments
  18. Unsampled Reports

Account Summaries

For Account Summaries Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
list GET  /management/accountSummaries Lists account summaries (lightweight tree comprised of accounts/properties/profiles) to which the user has access.

Accounts

For Accounts Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
list GET  /management/accounts Lists all accounts to which the user has access.

Web Properties

For Web Properties Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
get GET  /management/accounts/accountId/webproperties/webPropertyId Gets a web property to which the user has access.
insert POST  /management/accounts/accountId/webproperties Create a new property if the account has fewer than 20 properties.
list GET  /management/accounts/accountId/webproperties Lists web properties to which the user has access.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId Updates an existing web property. This method supports patch semantics.
update PUT  /management/accounts/accountId/webproperties/webPropertyId Updates an existing web property.

Views (Profiles)

For Views (Profiles) Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
delete DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Deletes a view (profile).
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Gets a view (profile) to which the user has access.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles Create a new view (profile).
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles Lists views (profiles) to which the user has access.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Updates an existing view (profile). This method supports patch semantics.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Updates an existing view (profile).

Filters

For Filters Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
delete DELETE  /management/accounts/accountId/filters/filterId Delete a filter.
get GET  /management/accounts/accountId/filters/filterId Returns a filters to which the user has access.
insert POST  /management/accounts/accountId/filters Create a new filter.
list GET  /management/accounts/accountId/filters Lists all filters for an account
patch PATCH  /management/accounts/accountId/filters/filterId Updates an existing filter. This method supports patch semantics.
update PUT  /management/accounts/accountId/filters/filterId Updates an existing filter.

Goals

For Goals Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId Gets a goal to which the user has access.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals Create a new goal.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals Lists goals to which the user has access.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId Updates an existing view (profile). This method supports patch semantics.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId Updates an existing view (profile).

Segments

For Segments Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
list GET  /management/segments Lists segments to which the user has access.

For Account User Links Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
delete DELETE  /management/accounts/accountId/entityUserLinks/linkId Removes a user from the given account.
insert POST  /management/accounts/accountId/entityUserLinks Adds a new user to the given account if the user has fewer than 100 accounts.
list GET  /management/accounts/accountId/entityUserLinks Lists account-user links for a given account.
update PUT  /management/accounts/accountId/entityUserLinks/linkId Updates permissions for an existing user on the given account.

For Webproperty User Links Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
delete DELETE  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId Removes a user from the given web property.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks Adds a new user to the given web property.
list GET  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks Lists webProperty-user links for a given web property.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId Updates permissions for an existing user on the given web property.

For Profile User Links Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
delete DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId Removes a user from the given view (profile).
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks Adds a new user to the given view (profile).
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks Lists profile-user links for a given view (profile).
update PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId Updates permissions for an existing user on the given view (profile).

For Profile Filter Links Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
delete DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Delete a profile filter link.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Returns a single profile filter link.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks Create a new profile filter link.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks Lists all profile filter links for a profile.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Update an existing profile filter link. This method supports patch semantics.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Update an existing profile filter link.

For AdWords Links Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
delete DELETE  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Deletes a web property-AdWords link.
get GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Returns a web property-AdWords link to which the user has access.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks Creates a webProperty-AdWords link.
list GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks Lists webProperty-AdWords links for a given web property.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Updates an existing webProperty-AdWords link. This method supports patch semantics.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Updates an existing webProperty-AdWords link.

Custom Data Sources

For Custom Data Sources Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources List custom data sources to which the user has access.

Custom Metrics

For Custom Metrics Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
get GET  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId Get a custom metric to which the user has access.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/customMetrics Create a new custom metric.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customMetrics Lists custom metrics to which the user has access.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId Updates an existing custom metric. This method supports patch semantics.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId Updates an existing custom metric.

Custom Dimensions

For Custom Dimensions Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
get GET  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId Get a custom dimension to which the user has access.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/customDimensions Create a new custom dimension.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDimensions Lists custom dimensions to which the user has access.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId Updates an existing custom dimension. This method supports patch semantics.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId Updates an existing custom dimension.

Uploads

For Uploads Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
deleteUploadData POST  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/deleteUploadData Delete data associated with a previous upload.
get GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads/uploadId List uploads to which the user has access.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads List uploads to which the user has access.
uploadData POST
https://www.googleapis.com/upload/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads
Upload data for a custom data source.

Experiments

For Experiments Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
delete DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Delete an experiment.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Returns an experiment to which the user has access.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments Create a new experiment.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments Lists experiments to which the user has access.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Update an existing experiment. This method supports patch semantics.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Update an existing experiment.

Unsampled Reports

For Unsampled Reports Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/analytics/v3, unless otherwise noted
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId Returns a single unsampled report.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports Create a new unsampled report.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports Lists unsampled reports to which the user has access.