Google Analytics

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. Goals
  6. Segments
  7. Account User Links
  8. Webproperty User Links
  9. Profile User Links
  10. Custom Data Sources
  11. Uploads
  12. Daily Uploads
  13. Experiments

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. Web properties are visible in the Google Analytics interface only if they have at least one profile.
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).

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 advanced 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.
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).

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.

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.

Daily Uploads

For Daily Uploads 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/customDataSources/customDataSourceId/dailyUploads/date Delete uploaded data for the given date.

Required query parameters: type

list GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/dailyUploads List daily uploads to which the user has access.

Required query parameters: end-date, start-date

upload POST
https://www.googleapis.com/upload/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/dailyUploads/date/uploads
Update/Overwrite data for a custom data source.

Required query parameters: appendNumber, type

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.

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.