Google Tag Manager API - Overview

This document provides a high level overview of the Google Tag Manager API.


The Google Tag Manager API provides access to Google Tag Manager configuration data for an authorized user. With this API you can manage:

Getting Started

Want to get started right away? Read the Developer's Guide. Each application that uses the API will have to go through a couple of steps to register, authorize the user, and work with the API. The developer's guide will walk you through each step and in the end, you will have a working application that you can customize.

Conceptual Overview

The API exposes multiple Google Tag Manager configuration entities, organized hierarchically. Each user's Account can have one or more Containers, each of which can have one or more Workspaces. A Workspace allows multiple concurrent modifications to a container's Variables, Built-In Variables, Triggers, Folders, and Tags. Once you have made the desired modifications to your workspace, you can create, preview and publish a Version. A Permission resource allows you to manage user permissions at the Accounts level. The following diagram represents the parent-child relationships among the entities:

The hierarchy of Tag Manager entities.
Figure 1: The parent-child relationships of Google Tag Manager resources.

The Google Tag Manager API exposes each of the entities as a resource. A list of resources of a particular kind make up a collection. The API exposes each collection at a URI that can be queried to return the list of entities in it.

See the Tag Manager API Reference to get a detailed description of the methods in the API and the data they return.

Quota Policies

The Google Tag Manager API handles millions of operations. To protect the system from receiving more operations than it can handle, and to ensure an equitable distribution of system resources, it is necessary to employ a quota system. Read the Limits and Quotas guide for specific limits.

Next Steps

Resources to help you learn more about the API: