是否要立即開始使用?閱讀開發人員指南。每個使用該 API 的應用程式都必須完成幾個步驟,才能註冊、授權使用者,以及使用 API。開發人員指南將引導您逐步完成每個步驟,最後也會提供可自訂的有效應用程式。
概念總覽
這個 API 會公開階層式的多個 Google 代碼管理工具設定實體。每位使用者的帳戶可以有一或多個容器,每個容器可包含一或多個工作區。工作區可對容器的變數、內建變數、觸發條件、資料夾和標記進行多項並行修改。對工作區進行所需的修改後,您可以建立、預覽及發布版本。您可以運用權限資源在帳戶層級管理使用者權限。下圖代表實體之間的父項與子項關係:
圖 1:Google 代碼管理工具資源的父項-子項關係。
Google 代碼管理工具 API 會將每個實體顯示為資源。特定種類的資源清單,構成了集合。API 會在 URI 中公開每個集合,可供查詢以傳回當中的實體清單。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\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"]]