Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Neste documento, veremos uma visão geral da API Google Tag Manager.
Introdução
A API Google Tag Manager proporciona a um usuário autorizado acesso aos dados de configuração do Gerenciador de tags do Google. Com ela, você pode gerenciar:
Quer começar imediatamente? Leia o Guia do desenvolvedor. Cada aplicativo que usa a API precisa passar por duas etapas para concluir o registro, autorizar o usuário e trabalhar com a API. O Guia do desenvolvedor explica cada etapa. Após terminar, você terá um aplicativo personalizável em funcionamento.
Visão geral conceitual
A API expõe várias entidades de configuração do Gerenciador de tags do Google, organizadas hierarquicamente. A conta de cada usuário pode ter um ou mais contêineres, cada com um ou mais espaços de trabalho. No espaço de trabalho, é possível fazer várias modificações simultâneas nas variáveis, variáveis incorporadas, acionadores, pastas e tags de um contêiner. Depois que você fizer as modificações desejadas no espaço de trabalho, poderá criar, visualizar e publicar uma versão. Com um recurso de permissão, você pode gerenciar permissões do usuário no nível da conta. Este diagrama representa as relações pai-filho entre as entidades:
Figura 1: as relações pai-filho entre os recursos do Gerenciador de tags do Google.
A API Google Tag Manager expõe cada uma das entidades como um recurso. Uma lista de recursos de um tipo específico compõe um conjunto. A API expõe cada conjunto em um URI que pode ser consultado para retornar a lista de entidades contidas nele.
Consulte a referência da API Tag Manager para ver uma descrição detalhada dos métodos na API e os dados que eles retornam.
Políticas de cotas
A API Google Tag Manager processa milhões de operações. Para impedir que o sistema receba mais operações do que pode processar e garantir uma distribuição equitativa dos respectivos recursos, é necessário empregar um sistema de cotas. Consulte o guia Limites e cotas para ver os limites específicos.
[null,null,["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eThe Google Tag Manager API grants authorized users access to Google Tag Manager configuration data, allowing management of accounts, containers, workspaces, tags, triggers, and other related entities.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, developers need to register their application, authorize the user, and understand the workflow as detailed in the Developer's Guide.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Tag Manager resources are organized hierarchically, with accounts containing containers, containers containing workspaces, and workspaces containing various elements like tags, triggers, and variables.\u003c/p\u003e\n"],["\u003cp\u003eThe API utilizes a quota system to ensure equitable resource distribution and protect the system from overload, with specific limits outlined in the Limits and Quotas guide.\u003c/p\u003e\n"],["\u003cp\u003eFurther information and guidance on working with the API can be found in the Developer's Guide and the Tag Manager API Reference.\u003c/p\u003e\n"]]],["The Google Tag Manager API allows authorized users to manage configuration data. Key actions include managing accounts, containers, destinations, workspaces, tags, triggers, folders, variables, versions, and user permissions. Users can modify variables, built-in variables, triggers, folders, and tags within workspaces. The API's resources are organized hierarchically, enabling the creation, preview, and publishing of versions, as well as the management of user permissions at the account level. Quotas are used to protect system resources.\n"],null,["# Google Tag Manager API - Overview\n\nThis document provides a high level overview of the Google Tag Manager API.\n\nIntroduction\n------------\n\nThe Google Tag Manager API provides access to Google Tag Manager\nconfiguration data for an authorized user. With this API you can manage:\n\n- [Accounts](/tag-platform/tag-manager/api/reference/rest/v2/accounts)\n- [Containers](/tag-platform/tag-manager/api/reference/rest/v2/accounts.containers)\n- [Destinations](/tag-platform/tag-manager/api/reference/rest/v2/accounts.containers.destinations)\n- [Workspaces](/tag-platform/tag-manager/api/reference/rest/v2/accounts.containers.workspaces)\n- [Google Tag Config](/tag-platform/tag-manager/api/reference/rest/v2/accounts.containers.workspaces.gtag_config)\n- [Tags](/tag-platform/tag-manager/api/reference/rest/v2/accounts.containers.workspaces.tags)\n- [Triggers](/tag-platform/tag-manager/api/reference/rest/v2/accounts.containers.workspaces.triggers)\n- [Folders](/tag-platform/tag-manager/api/reference/rest/v2/accounts.containers.workspaces.folders)\n- [Built-In Variables](/tag-platform/tag-manager/api/reference/rest/v2/accounts.containers.workspaces.built_in_variables)\n- [Clients](/tag-platform/tag-manager/api/reference/rest/v2/accounts.containers.workspaces.clients)\n- [Variables](/tag-platform/tag-manager/api/reference/rest/v2/accounts.containers.workspaces.variables)\n- [Container Versions](/tag-platform/tag-manager/api/reference/rest/v2/accounts.containers.versions)\n- [Container Version Headers](/tag-platform/tag-manager/api/reference/rest/v2/accounts.containers.version_headers)\n- [User\n Permissions](/tag-platform/tag-manager/api/reference/rest/v2/accounts.user_permissions)\n- [Environments](/tag-platform/tag-manager/api/reference/rest/v2/accounts.containers.environments)\n\nGetting Started\n---------------\n\nWant to get started right away? Read the [Developer's Guide](/tag-platform/tag-manager/api/v2/devguide). Each application\nthat uses the API will have to go through a couple of steps\nto register, authorize the user, and work with the API. The developer's guide\nwill walk you through each step and in the end, you will have a working\napplication that you can customize.\n\nConceptual Overview\n-------------------\n\nThe API exposes multiple Google Tag Manager configuration\nentities, organized hierarchically. Each user's Account can have one\nor more Containers, each of which can have one or more Workspaces. A Workspace allows multiple\nconcurrent modifications to a container's Variables, Built-In Variables,\nTriggers, Folders, and Tags. Once you have made the desired modifications to your workspace, you can\ncreate, preview and publish a Version. A Permission resource allows you to\nmanage user permissions at the Accounts level. The following diagram represents\nthe parent-child relationships among the entities:\n**Figure 1**: The parent-child relationships of Google Tag Manager resources.\n\nThe Google Tag Manager API exposes each of the entities as a\nresource. A list of resources of a particular kind\nmake up a collection. The API exposes each collection\nat a URI that can be queried to return the list of entities in it.\n\nSee the [Tag Manager API\nReference](/tag-platform/tag-manager/api/v2/reference) to get a detailed description of the methods in the API and\nthe data they return.\n\nQuota Policies\n--------------\n\nThe Google Tag Manager API handles millions of operations. To protect the\nsystem from receiving more operations than it can handle, and to ensure an\nequitable distribution of system resources, it is necessary to employ a quota\nsystem. Read the [Limits and\nQuotas](/tag-platform/tag-manager/api/v2/limits-quotas) guide for specific limits.\n\nNext Steps\n----------\n\nResources to help you learn more about the API:\n\n- Read the [Developer's Guide](/tag-platform/tag-manager/api/v2/devguide) to learn how to work with the API.\n- Review the [Tag Manager API\n Reference](/tag-platform/tag-manager/api/v2/reference) to familiarize yourself with Tag Manager resources and available operations.\n\n\u003cbr /\u003e"]]
