Google Analytics

Management API - Web Property Developer Guide

This document explains how to use the Management API to access Web Property data.

  1. Introduction
  2. Before You Begin
  1. Using A Test Account
  2. Web Property Limits and Behavior
  3. Code Examples
  1. Sample Application

Introduction

A Google Analytics web property is at the second level in the account hierarchy; each Webproperty has a single account resource as its parent and can have a child that is a collection of one or more view (profile) resources.

  • Read the entity overview in the Management API overview guide to understand how web properties relate to other Management API entities.
  • Read the Accounts & Views (Profiles) conceptual guide for general information about web properties.

A Google Analytics web property is important because all data collection happens at this level. For example when you add tracking code to a web site or mobile application, you must include an ID that looks like UA-xxxxx-y. This ID is called a web property ID and distinguishes in which Google Analytics account data is stored.

Before You Begin

This guide demonstrates how to access the Google Analytics API using the following programming languages:
  • Java
  • Python
  • PHP

  • Read the client libraries page for a complete list of programming language specific client libraries that work with the Management API.
  • Read the Reference Guide to access the API without a client library

Each client library provides a single Analytics service object to access all Management API data. To create the service object you generally have to go through the following steps:

  1. Register your application in the Google Developers Console.
  2. Authorize access to Google Analytics data.
  3. Create an Analytics service object.

If you haven't completed these steps, please stop and read the Hello Google Analytics API Tutorial. This tutorial will walk you through the initial steps of building a Google Analytics API application. Once complete, you will be able to use this guide to perform real-world tasks.

The following code snippet continues from step 3: Create an Analytics service object and contains a variable to store an authorized service object.

Java

Analytics analytics = // Read Hello Analytics Tutorial for details.

Python

analytics = # Read Hello Analytics Tutorial for details.

PHP

$client = // Read Hello Analytics Tutorial for details.

// Return results as objects.
$client->setUseObjects(true);

$analytics = new apiAnalyticsService($client);

The PHP library will return all the API results as an associative array. To return real objects instead, you can call the client useObject method as demonstrated in the example above.

Once you create an Analytics service object, you are ready to make requests to the Management API.

Note: The same Analytics service object can also be used to access the Core Reporting API.

Using A Test Account

If you intend to use the Management API to create and/or configure Properties, it's recommended that you implement and verify your code with a test account. Using a test account will help prevent you from making accidental changes to an active Property. Once you've tested and confirmed that your code is working as expected using the test account and Property, then you can start using the implementation with your real accounts.

You can create a test account in the Admin section of the Google Analytics web interface.

Web Property Limits and Behavior

The following limits and behaviors are applicable to the Web Property resource:

  • There is an upper bound of 20 properties per account. Once this limit is reached, additional properties cannot be created through the API. However, existing properties can be updated and reused. See Limits and Quotas to learn about general limits.
  • Properties cannot be deleted using the Mangement API.
  • A property becomes visible in the Google Analytics web interface only after it has at least one view (profile) associated with it. See the Conceptual Overview to understand how web properties relate to other Management API entities.

Code Examples

The Management API allows you to list, get, insert, update, and patch properties for an authorized user. To use any of these methods, you first need to create an Analytics service object, as described in the Before You Begin section.

For code examples that show you how to work with the Web Property resource, visit the following method references:

  • list — Lists web properties to which the user has access.
  • get — Gets a web property to which the user has access.
  • insert — Create a new web property.
  • patch — Updates an existing web property. This method supports patch semantics.
  • update — Updates an existing web property.

Sample Application

See the Management API Reference Sample for a working example of how to traverse and access all the data in the Management API.

Java


Google Analytics API Java client library Sample

Python


Google Analytics API Python client library Sample

PHP


Google Analytics API PHP client library Sample




Authentication required

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

Signing you in...

Google Developers needs your permission to do that.