{ "discoveryVersion": "v1", "resources": { "accounts": { "methods": { "list": { "id": "tagmanager.accounts.list", "path": "tagmanager/v1/accounts", "flatPath": "tagmanager/v1/accounts", "httpMethod": "GET", "parameters": {}, "parameterOrder": [], "response": { "$ref": "ListAccountsResponse" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.manage.accounts", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "Lists all GTM Accounts that a user has access to." }, "get": { "id": "tagmanager.accounts.get", "path": "tagmanager/v1/accounts/{accountId}", "flatPath": "tagmanager/v1/accounts/{accountId}", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId" ], "response": { "$ref": "Account" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.manage.accounts", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "Gets a GTM Account." }, "update": { "id": "tagmanager.accounts.update", "path": "tagmanager/v1/accounts/{accountId}", "flatPath": "tagmanager/v1/accounts/{accountId}", "httpMethod": "PUT", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "fingerprint": { "description": "When provided, this fingerprint must match the fingerprint of the account in storage.", "location": "query", "type": "string" } }, "parameterOrder": [ "accountId" ], "request": { "$ref": "Account" }, "response": { "$ref": "Account" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.manage.accounts" ], "description": "Updates a GTM Account." } }, "resources": { "permissions": { "methods": { "create": { "id": "tagmanager.accounts.permissions.create", "path": "tagmanager/v1/accounts/{accountId}/permissions", "flatPath": "tagmanager/v1/accounts/{accountId}/permissions", "httpMethod": "POST", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId" ], "request": { "$ref": "UserAccess" }, "response": { "$ref": "UserAccess" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.manage.users" ], "description": "Creates a user's Account & Container Permissions." }, "list": { "id": "tagmanager.accounts.permissions.list", "path": "tagmanager/v1/accounts/{accountId}/permissions", "flatPath": "tagmanager/v1/accounts/{accountId}/permissions", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId" ], "response": { "$ref": "ListAccountUsersResponse" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.manage.users" ], "description": "List all users that have access to the account along with Account and Container Permissions granted to each of them." }, "get": { "id": "tagmanager.accounts.permissions.get", "path": "tagmanager/v1/accounts/{accountId}/permissions/{permissionId}", "flatPath": "tagmanager/v1/accounts/{accountId}/permissions/{permissionId}", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "permissionId": { "description": "The GTM User ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "permissionId" ], "response": { "$ref": "UserAccess" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.manage.users" ], "description": "Gets a user's Account & Container Permissions." }, "update": { "id": "tagmanager.accounts.permissions.update", "path": "tagmanager/v1/accounts/{accountId}/permissions/{permissionId}", "flatPath": "tagmanager/v1/accounts/{accountId}/permissions/{permissionId}", "httpMethod": "PUT", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "permissionId": { "description": "The GTM User ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "permissionId" ], "request": { "$ref": "UserAccess" }, "response": { "$ref": "UserAccess" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.manage.users" ], "description": "Updates a user's Account & Container Permissions." }, "delete": { "id": "tagmanager.accounts.permissions.delete", "path": "tagmanager/v1/accounts/{accountId}/permissions/{permissionId}", "flatPath": "tagmanager/v1/accounts/{accountId}/permissions/{permissionId}", "httpMethod": "DELETE", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "permissionId": { "description": "The GTM User ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "permissionId" ], "scopes": [ "https://www.googleapis.com/auth/tagmanager.manage.users" ], "description": "Removes a user from the account, revoking access to it and all of its containers." } } }, "containers": { "methods": { "create": { "id": "tagmanager.accounts.containers.create", "path": "tagmanager/v1/accounts/{accountId}/containers", "flatPath": "tagmanager/v1/accounts/{accountId}/containers", "httpMethod": "POST", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId" ], "request": { "$ref": "Container" }, "response": { "$ref": "Container" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Creates a Container." }, "list": { "id": "tagmanager.accounts.containers.list", "path": "tagmanager/v1/accounts/{accountId}/containers", "flatPath": "tagmanager/v1/accounts/{accountId}/containers", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId" ], "response": { "$ref": "ListContainersResponse" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "Lists all Containers that belongs to a GTM Account." }, "get": { "id": "tagmanager.accounts.containers.get", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId" ], "response": { "$ref": "Container" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "Gets a Container." }, "update": { "id": "tagmanager.accounts.containers.update", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}", "httpMethod": "PUT", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "fingerprint": { "description": "When provided, this fingerprint must match the fingerprint of the container in storage.", "location": "query", "type": "string" } }, "parameterOrder": [ "accountId", "containerId" ], "request": { "$ref": "Container" }, "response": { "$ref": "Container" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Updates a Container." }, "delete": { "id": "tagmanager.accounts.containers.delete", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}", "httpMethod": "DELETE", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId" ], "scopes": [ "https://www.googleapis.com/auth/tagmanager.delete.containers" ], "description": "Deletes a Container." } }, "resources": { "versions": { "methods": { "create": { "id": "tagmanager.accounts.containers.versions.create", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/versions", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/versions", "httpMethod": "POST", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId" ], "request": { "$ref": "CreateContainerVersionRequestVersionOptions" }, "response": { "$ref": "CreateContainerVersionResponse" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containerversions" ], "description": "Creates a Container Version." }, "get": { "id": "tagmanager.accounts.containers.versions.get", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/versions/{containerVersionId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/versions/{containerVersionId}", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "containerVersionId": { "description": "The GTM Container Version ID. Specify published to retrieve the currently published version.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "containerVersionId" ], "response": { "$ref": "ContainerVersion" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.edit.containerversions", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "Gets a Container Version." }, "update": { "id": "tagmanager.accounts.containers.versions.update", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/versions/{containerVersionId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/versions/{containerVersionId}", "httpMethod": "PUT", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "containerVersionId": { "description": "The GTM Container Version ID.", "location": "path", "required": true, "type": "string" }, "fingerprint": { "description": "When provided, this fingerprint must match the fingerprint of the container version in storage.", "location": "query", "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "containerVersionId" ], "request": { "$ref": "ContainerVersion" }, "response": { "$ref": "ContainerVersion" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containerversions" ], "description": "Updates a Container Version." }, "delete": { "id": "tagmanager.accounts.containers.versions.delete", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/versions/{containerVersionId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/versions/{containerVersionId}", "httpMethod": "DELETE", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "containerVersionId": { "description": "The GTM Container Version ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "containerVersionId" ], "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containerversions" ], "description": "Deletes a Container Version." }, "undelete": { "id": "tagmanager.accounts.containers.versions.undelete", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/versions/{containerVersionId}/undelete", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/versions/{containerVersionId}/undelete", "httpMethod": "POST", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "containerVersionId": { "description": "The GTM Container Version ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "containerVersionId" ], "response": { "$ref": "ContainerVersion" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containerversions" ], "description": "Undeletes a Container Version." }, "publish": { "id": "tagmanager.accounts.containers.versions.publish", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/versions/{containerVersionId}/publish", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/versions/{containerVersionId}/publish", "httpMethod": "POST", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "containerVersionId": { "description": "The GTM Container Version ID.", "location": "path", "required": true, "type": "string" }, "fingerprint": { "description": "When provided, this fingerprint must match the fingerprint of the container version in storage.", "location": "query", "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "containerVersionId" ], "response": { "$ref": "PublishContainerVersionResponse" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.publish" ], "description": "Publishes a Container Version." }, "restore": { "id": "tagmanager.accounts.containers.versions.restore", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/versions/{containerVersionId}/restore", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/versions/{containerVersionId}/restore", "httpMethod": "POST", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "containerVersionId": { "description": "The GTM Container Version ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "containerVersionId" ], "response": { "$ref": "ContainerVersion" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Restores a Container Version. This will overwrite the container's current configuration (including its variables, triggers and tags). The operation will not have any effect on the version that is being served (i.e. the published version)." }, "list": { "id": "tagmanager.accounts.containers.versions.list", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/versions", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/versions", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "headers": { "description": "Retrieve headers only when true.", "default": "false", "location": "query", "type": "boolean" }, "includeDeleted": { "description": "Also retrieve deleted (archived) versions when true.", "default": "false", "location": "query", "type": "boolean" } }, "parameterOrder": [ "accountId", "containerId" ], "response": { "$ref": "ListContainerVersionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.edit.containerversions", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "Lists all Container Versions of a GTM Container." } } }, "variables": { "methods": { "create": { "id": "tagmanager.accounts.containers.variables.create", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/variables", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/variables", "httpMethod": "POST", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId" ], "request": { "$ref": "Variable" }, "response": { "$ref": "Variable" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Creates a GTM Variable." }, "list": { "id": "tagmanager.accounts.containers.variables.list", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/variables", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/variables", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId" ], "response": { "$ref": "ListVariablesResponse" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "Lists all GTM Variables of a Container." }, "get": { "id": "tagmanager.accounts.containers.variables.get", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/variables/{variableId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/variables/{variableId}", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "variableId": { "description": "The GTM Variable ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "variableId" ], "response": { "$ref": "Variable" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "Gets a GTM Variable." }, "update": { "id": "tagmanager.accounts.containers.variables.update", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/variables/{variableId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/variables/{variableId}", "httpMethod": "PUT", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "variableId": { "description": "The GTM Variable ID.", "location": "path", "required": true, "type": "string" }, "fingerprint": { "description": "When provided, this fingerprint must match the fingerprint of the variable in storage.", "location": "query", "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "variableId" ], "request": { "$ref": "Variable" }, "response": { "$ref": "Variable" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Updates a GTM Variable." }, "delete": { "id": "tagmanager.accounts.containers.variables.delete", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/variables/{variableId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/variables/{variableId}", "httpMethod": "DELETE", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "variableId": { "description": "The GTM Variable ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "variableId" ], "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Deletes a GTM Variable." } } }, "triggers": { "methods": { "create": { "id": "tagmanager.accounts.containers.triggers.create", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/triggers", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/triggers", "httpMethod": "POST", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId" ], "request": { "$ref": "Trigger" }, "response": { "$ref": "Trigger" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Creates a GTM Trigger." }, "list": { "id": "tagmanager.accounts.containers.triggers.list", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/triggers", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/triggers", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId" ], "response": { "$ref": "ListTriggersResponse" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "Lists all GTM Triggers of a Container." }, "get": { "id": "tagmanager.accounts.containers.triggers.get", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/triggers/{triggerId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/triggers/{triggerId}", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "triggerId": { "description": "The GTM Trigger ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "triggerId" ], "response": { "$ref": "Trigger" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "Gets a GTM Trigger." }, "update": { "id": "tagmanager.accounts.containers.triggers.update", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/triggers/{triggerId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/triggers/{triggerId}", "httpMethod": "PUT", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "triggerId": { "description": "The GTM Trigger ID.", "location": "path", "required": true, "type": "string" }, "fingerprint": { "description": "When provided, this fingerprint must match the fingerprint of the trigger in storage.", "location": "query", "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "triggerId" ], "request": { "$ref": "Trigger" }, "response": { "$ref": "Trigger" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Updates a GTM Trigger." }, "delete": { "id": "tagmanager.accounts.containers.triggers.delete", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/triggers/{triggerId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/triggers/{triggerId}", "httpMethod": "DELETE", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "triggerId": { "description": "The GTM Trigger ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "triggerId" ], "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Deletes a GTM Trigger." } } }, "tags": { "methods": { "create": { "id": "tagmanager.accounts.containers.tags.create", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/tags", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/tags", "httpMethod": "POST", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId" ], "request": { "$ref": "Tag" }, "response": { "$ref": "Tag" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Creates a GTM Tag." }, "list": { "id": "tagmanager.accounts.containers.tags.list", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/tags", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/tags", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId" ], "response": { "$ref": "ListTagsResponse" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "Lists all GTM Tags of a Container." }, "get": { "id": "tagmanager.accounts.containers.tags.get", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/tags/{tagId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/tags/{tagId}", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "tagId": { "description": "The GTM Tag ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "tagId" ], "response": { "$ref": "Tag" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "Gets a GTM Tag." }, "update": { "id": "tagmanager.accounts.containers.tags.update", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/tags/{tagId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/tags/{tagId}", "httpMethod": "PUT", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "tagId": { "description": "The GTM Tag ID.", "location": "path", "required": true, "type": "string" }, "fingerprint": { "description": "When provided, this fingerprint must match the fingerprint of the tag in storage.", "location": "query", "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "tagId" ], "request": { "$ref": "Tag" }, "response": { "$ref": "Tag" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Updates a GTM Tag." }, "delete": { "id": "tagmanager.accounts.containers.tags.delete", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/tags/{tagId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/tags/{tagId}", "httpMethod": "DELETE", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "tagId": { "description": "The GTM Tag ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "tagId" ], "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Deletes a GTM Tag." } } }, "folders": { "methods": { "create": { "id": "tagmanager.accounts.containers.folders.create", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/folders", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/folders", "httpMethod": "POST", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId" ], "request": { "$ref": "Folder" }, "response": { "$ref": "Folder" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Creates a GTM Folder." }, "list": { "id": "tagmanager.accounts.containers.folders.list", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/folders", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/folders", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId" ], "response": { "$ref": "ListFoldersResponse" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "Lists all GTM Folders of a Container." }, "get": { "id": "tagmanager.accounts.containers.folders.get", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/folders/{folderId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/folders/{folderId}", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "folderId": { "description": "The GTM Folder ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "folderId" ], "response": { "$ref": "Folder" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "Gets a GTM Folder." }, "update": { "id": "tagmanager.accounts.containers.folders.update", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/folders/{folderId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/folders/{folderId}", "httpMethod": "PUT", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "folderId": { "description": "The GTM Folder ID.", "location": "path", "required": true, "type": "string" }, "fingerprint": { "description": "When provided, this fingerprint must match the fingerprint of the folder in storage.", "location": "query", "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "folderId" ], "request": { "$ref": "Folder" }, "response": { "$ref": "Folder" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Updates a GTM Folder." }, "delete": { "id": "tagmanager.accounts.containers.folders.delete", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/folders/{folderId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/folders/{folderId}", "httpMethod": "DELETE", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "folderId": { "description": "The GTM Folder ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "folderId" ], "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Deletes a GTM Folder." } }, "resources": { "entities": { "methods": { "list": { "id": "tagmanager.accounts.containers.folders.entities.list", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/folders/{folderId}/entities", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/folders/{folderId}/entities", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "folderId": { "description": "The GTM Folder ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "folderId" ], "response": { "$ref": "FolderEntities" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "List all entities in a GTM Folder." } } } } }, "move_folders": { "methods": { "update": { "id": "tagmanager.accounts.containers.move_folders.update", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/move_folders/{folderId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/move_folders/{folderId}", "httpMethod": "PUT", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "folderId": { "description": "The GTM Folder ID.", "location": "path", "required": true, "type": "string" }, "tagId": { "description": "The tags to be moved to the folder.", "location": "query", "repeated": true, "type": "string" }, "variableId": { "description": "The variables to be moved to the folder.", "location": "query", "repeated": true, "type": "string" }, "triggerId": { "description": "The triggers to be moved to the folder.", "location": "query", "repeated": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "folderId" ], "request": { "$ref": "Folder" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Moves entities to a GTM Folder." } } }, "environments": { "methods": { "create": { "id": "tagmanager.accounts.containers.environments.create", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/environments", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/environments", "httpMethod": "POST", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId" ], "request": { "$ref": "Environment" }, "response": { "$ref": "Environment" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Creates a GTM Environment." }, "list": { "id": "tagmanager.accounts.containers.environments.list", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/environments", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/environments", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId" ], "response": { "$ref": "ListEnvironmentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "Lists all GTM Environments of a GTM Container." }, "get": { "id": "tagmanager.accounts.containers.environments.get", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/environments/{environmentId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/environments/{environmentId}", "httpMethod": "GET", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "environmentId": { "description": "The GTM Environment ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "environmentId" ], "response": { "$ref": "Environment" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers", "https://www.googleapis.com/auth/tagmanager.readonly" ], "description": "Gets a GTM Environment." }, "update": { "id": "tagmanager.accounts.containers.environments.update", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/environments/{environmentId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/environments/{environmentId}", "httpMethod": "PUT", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "environmentId": { "description": "The GTM Environment ID.", "location": "path", "required": true, "type": "string" }, "fingerprint": { "description": "When provided, this fingerprint must match the fingerprint of the environment in storage.", "location": "query", "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "environmentId" ], "request": { "$ref": "Environment" }, "response": { "$ref": "Environment" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Updates a GTM Environment." }, "delete": { "id": "tagmanager.accounts.containers.environments.delete", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/environments/{environmentId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/environments/{environmentId}", "httpMethod": "DELETE", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "environmentId": { "description": "The GTM Environment ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "environmentId" ], "scopes": [ "https://www.googleapis.com/auth/tagmanager.edit.containers" ], "description": "Deletes a GTM Environment." } } }, "reauthorize_environments": { "methods": { "update": { "id": "tagmanager.accounts.containers.reauthorize_environments.update", "path": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/reauthorize_environments/{environmentId}", "flatPath": "tagmanager/v1/accounts/{accountId}/containers/{containerId}/reauthorize_environments/{environmentId}", "httpMethod": "PUT", "parameters": { "accountId": { "description": "The GTM Account ID.", "location": "path", "required": true, "type": "string" }, "containerId": { "description": "The GTM Container ID.", "location": "path", "required": true, "type": "string" }, "environmentId": { "description": "The GTM Environment ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountId", "containerId", "environmentId" ], "request": { "$ref": "Environment" }, "response": { "$ref": "Environment" }, "scopes": [ "https://www.googleapis.com/auth/tagmanager.publish" ], "description": "Re-generates the authorization code for a GTM Environment." } } } } } } } }, "documentationLink": "https://developers.google.com/tag-manager", "schemas": { "ListAccountsResponse": { "id": "ListAccountsResponse", "description": "List Accounts Response.", "type": "object", "properties": { "accounts": { "description": "List of GTM Accounts that a user has access to.", "type": "array", "items": { "$ref": "Account" } } } }, "Account": { "id": "Account", "description": "Represents a Google Tag Manager Account.", "type": "object", "properties": { "accountId": { "description": "The Account ID uniquely identifies the GTM Account.", "type": "string" }, "name": { "description": "Account display name.", "type": "string" }, "shareData": { "description": "Whether the account shares data anonymously with Google and others.", "type": "boolean" }, "fingerprint": { "description": "The fingerprint of the GTM Account as computed at storage time. This value is recomputed whenever the account is modified.", "type": "string" } } }, "UserAccess": { "id": "UserAccess", "description": "Represents a user's permissions to an account and its container.", "type": "object", "properties": { "accountId": { "description": "GTM Account ID.", "type": "string" }, "permissionId": { "description": "Account Permission ID.", "type": "string" }, "emailAddress": { "description": "User's email address.", "type": "string" }, "accountAccess": { "description": "GTM Account access permissions.", "$ref": "AccountAccess" }, "containerAccess": { "description": "GTM Container access permissions.", "type": "array", "items": { "$ref": "ContainerAccess" } } } }, "AccountAccess": { "id": "AccountAccess", "description": "Defines the Google Tag Manager Account access permissions.", "type": "object", "properties": { "permission": { "description": "List of Account permissions. Valid account permissions are read and manage.", "type": "array", "items": { "type": "string", "enumDescriptions": [ "", "", "", "", "", "" ], "enum": [ "read", "edit", "publish", "delete", "manage", "editWorkspace" ] } } } }, "ContainerAccess": { "id": "ContainerAccess", "description": "Defines the Google Tag Manager Container access permissions.", "type": "object", "properties": { "containerId": { "description": "GTM Container ID.", "type": "string" }, "permission": { "description": "List of Container permissions. Valid container permissions are: read, edit, delete, publish.", "type": "array", "items": { "type": "string", "enumDescriptions": [ "", "", "", "", "", "" ], "enum": [ "read", "edit", "publish", "delete", "manage", "editWorkspace" ] } } } }, "ListAccountUsersResponse": { "id": "ListAccountUsersResponse", "description": "List AccountUsers Response.", "type": "object", "properties": { "userAccess": { "description": "All GTM AccountUsers of a GTM Account.", "type": "array", "items": { "$ref": "UserAccess" } } } }, "Container": { "id": "Container", "description": "Represents a Google Tag Manager Container.", "type": "object", "properties": { "accountId": { "description": "GTM Account ID.", "type": "string" }, "containerId": { "description": "The Container ID uniquely identifies the GTM Container.", "type": "string" }, "name": { "description": "Container display name.", "type": "string" }, "domainName": { "description": "Optional list of domain names associated with the Container.", "type": "array", "items": { "type": "string" } }, "publicId": { "description": "Container Public ID.", "type": "string" }, "timeZoneCountryId": { "description": "Container Country ID.", "type": "string" }, "timeZoneId": { "description": "Container Time Zone ID.", "type": "string" }, "notes": { "description": "Container Notes.", "type": "string" }, "usageContext": { "description": "List of Usage Contexts for the Container. Valid values include: web, android, ios.", "type": "array", "items": { "type": "string", "enumDescriptions": [ "", "", "", "", "", "" ], "enum": [ "web", "android", "ios", "androidSdk5", "iosSdk5", "amp" ] } }, "enabledBuiltInVariable": { "description": "List of enabled built-in variables. Valid values include: pageUrl, pageHostname, pagePath, referrer, event, clickElement, clickClasses, clickId, clickTarget, clickUrl, clickText, formElement, formClasses, formId, formTarget, formUrl, formText, errorMessage, errorUrl, errorLine, newHistoryFragment, oldHistoryFragment, newHistoryState, oldHistoryState, historySource, containerVersion, debugMode, randomNumber, containerId.", "type": "array", "items": { "type": "string", "enumDescriptions": [ "", "", "", "", "For web or mobile.", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "For web or mobile.", "", "For web or mobile.", "For web or mobile.", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ], "enum": [ "pageUrl", "pageHostname", "pagePath", "referrer", "event", "clickElement", "clickClasses", "clickId", "clickTarget", "clickUrl", "clickText", "firstPartyServingUrl", "formElement", "formClasses", "formId", "formTarget", "formUrl", "formText", "environmentName", "errorMessage", "errorUrl", "errorLine", "newHistoryUrl", "oldHistoryUrl", "newHistoryFragment", "oldHistoryFragment", "newHistoryState", "oldHistoryState", "historySource", "containerVersion", "debugMode", "randomNumber", "containerId", "appId", "appName", "appVersionCode", "appVersionName", "language", "osVersion", "platform", "sdkVersion", "deviceName", "resolution", "advertiserId", "advertisingTrackingEnabled", "htmlId", "ampBrowserLanguage", "ampCanonicalPath", "ampCanonicalUrl", "ampCanonicalHost", "ampReferrer", "ampTitle", "ampClientId", "ampClientTimezone", "ampClientTimestamp", "ampClientScreenWidth", "ampClientScreenHeight", "ampClientScrollX", "ampClientScrollY", "ampClientMaxScrollX", "ampClientMaxScrollY", "ampTotalEngagedTime", "ampPageViewId", "ampPageLoadTime", "ampPageDownloadTime", "ampGtmEvent", "eventName", "firebaseEventParameterCampaign", "firebaseEventParameterCampaignAclid", "firebaseEventParameterCampaignAnid", "firebaseEventParameterCampaignClickTimestamp", "firebaseEventParameterCampaignContent", "firebaseEventParameterCampaignCp1", "firebaseEventParameterCampaignGclid", "firebaseEventParameterCampaignSource", "firebaseEventParameterCampaignTerm", "firebaseEventParameterCurrency", "firebaseEventParameterDynamicLinkAcceptTime", "firebaseEventParameterDynamicLinkLinkid", "firebaseEventParameterNotificationMessageDeviceTime", "firebaseEventParameterNotificationMessageId", "firebaseEventParameterNotificationMessageName", "firebaseEventParameterNotificationMessageTime", "firebaseEventParameterNotificationTopic", "firebaseEventParameterPreviousAppVersion", "firebaseEventParameterPreviousOsVersion", "firebaseEventParameterPrice", "firebaseEventParameterProductId", "firebaseEventParameterQuantity", "firebaseEventParameterValue", "videoProvider", "videoUrl", "videoTitle", "videoDuration", "videoPercent", "videoVisible", "videoStatus", "videoCurrentTime", "scrollDepthThreshold", "scrollDepthUnits", "scrollDepthDirection", "elementVisibilityRatio", "elementVisibilityTime", "elementVisibilityFirstTime", "elementVisibilityRecentTime", "analyticsClientId", "analyticsSessionId", "analyticsSessionNumber" ] } }, "fingerprint": { "description": "The fingerprint of the GTM Container as computed at storage time. This value is recomputed whenever the account is modified.", "type": "string" } } }, "ListContainersResponse": { "id": "ListContainersResponse", "description": "List Containers Response.", "type": "object", "properties": { "containers": { "description": "All Containers of a GTM Account.", "type": "array", "items": { "$ref": "Container" } } } }, "CreateContainerVersionRequestVersionOptions": { "id": "CreateContainerVersionRequestVersionOptions", "description": "Options for new container versions.", "type": "object", "properties": { "quickPreview": { "description": "The creation of this version may be for quick preview and shouldn't be saved.", "type": "boolean" }, "name": { "description": "The name of the container version to be created.", "type": "string" }, "notes": { "description": "The notes of the container version to be created.", "type": "string" } } }, "CreateContainerVersionResponse": { "id": "CreateContainerVersionResponse", "description": "Create container versions response.", "type": "object", "properties": { "containerVersion": { "description": "The container version created.", "$ref": "ContainerVersion" }, "compilerError": { "description": "Compiler errors or not.", "type": "boolean" } } }, "ContainerVersion": { "id": "ContainerVersion", "description": "Represents a Google Tag Manager Container Version.", "type": "object", "properties": { "accountId": { "description": "GTM Account ID.", "type": "string" }, "containerId": { "description": "GTM Container ID.", "type": "string" }, "containerVersionId": { "description": "The Container Version ID uniquely identifies the GTM Container Version.", "type": "string" }, "name": { "description": "Container version display name.", "type": "string" }, "deleted": { "description": "A value of true indicates this container version has been deleted.", "type": "boolean" }, "notes": { "description": "User notes on how to apply this container version in the container.", "type": "string" }, "container": { "description": "The container that this version was taken from.", "$ref": "Container" }, "tag": { "description": "The tags in the container that this version was taken from.", "type": "array", "items": { "$ref": "Tag" } }, "trigger": { "description": "The triggers in the container that this version was taken from.", "type": "array", "items": { "$ref": "Trigger" } }, "variable": { "description": "The variables in the container that this version was taken from.", "type": "array", "items": { "$ref": "Variable" } }, "folder": { "description": "The folders in the container that this version was taken from.", "type": "array", "items": { "$ref": "Folder" } }, "fingerprint": { "description": "The fingerprint of the GTM Container Version as computed at storage time. This value is recomputed whenever the container version is modified.", "type": "string" } } }, "Tag": { "id": "Tag", "description": "Represents a Google Tag Manager Tag.", "type": "object", "properties": { "accountId": { "description": "GTM Account ID.", "type": "string" }, "containerId": { "description": "GTM Container ID.", "type": "string" }, "tagId": { "description": "The Tag ID uniquely identifies the GTM Tag.", "type": "string" }, "name": { "description": "Tag display name.", "type": "string" }, "type": { "description": "GTM Tag Type.", "type": "string" }, "firingTriggerId": { "description": "Firing trigger IDs. A tag will fire when any of the listed triggers are true and all of its blockingTriggerIds (if any specified) are false.", "type": "array", "items": { "type": "string" } }, "blockingTriggerId": { "description": "Blocking trigger IDs. If any of the listed triggers evaluate to true, the tag will not fire.", "type": "array", "items": { "type": "string" } }, "liveOnly": { "description": "If set to true, this tag will only fire in the live environment (e.g. not in preview or debug mode).", "type": "boolean" }, "priority": { "description": "User defined numeric priority of the tag. Tags are fired asynchronously in order of priority. Tags with higher numeric value fire first. A tag's priority can be a positive or negative value. The default value is 0.", "$ref": "Parameter" }, "notes": { "description": "User notes on how to apply this tag in the container.", "type": "string" }, "scheduleStartMs": { "description": "The start timestamp in milliseconds to schedule a tag.", "type": "string", "format": "int64" }, "scheduleEndMs": { "description": "The end timestamp in milliseconds to schedule a tag.", "type": "string", "format": "int64" }, "parameter": { "description": "The tag's parameters.", "type": "array", "items": { "$ref": "Parameter" } }, "fingerprint": { "description": "The fingerprint of the GTM Tag as computed at storage time. This value is recomputed whenever the tag is modified.", "type": "string" }, "setupTag": { "description": "The list of setup tags. Currently we only allow one.", "type": "array", "items": { "$ref": "SetupTag" } }, "teardownTag": { "description": "The list of teardown tags. Currently we only allow one.", "type": "array", "items": { "$ref": "TeardownTag" } }, "parentFolderId": { "description": "Parent folder id.", "type": "string" }, "tagFiringOption": { "description": "Option to fire this tag.", "type": "string", "enumDescriptions": [ "Tag can be fired multiple times per event.", "Tag can only be fired per event but can be fired multiple times per load (e.g., app load or page load).", "Tag can only be fired per load (e.g., app load or page load)." ], "enum": [ "unlimited", "oncePerEvent", "oncePerLoad" ] }, "paused": { "description": "True if the tag is paused.", "type": "boolean" } } }, "Parameter": { "id": "Parameter", "description": "Represents a Google Tag Manager Parameter.", "type": "object", "properties": { "type": { "description": "The parameter type. Valid values are: - boolean: The value represents a boolean, represented as 'true' or 'false' - integer: The value represents a 64-bit signed integer value, in base 10 - list: A list of parameters should be specified - map: A map of parameters should be specified - template: The value represents any text; this can include variable references (even variable references that might return non-string types) - trigger_reference: The value represents a trigger, represented as the trigger id - tag_reference: The value represents a tag, represented as the tag name ", "type": "string", "enumDescriptions": [ "May include variable references.", "", "", "", "", "", "" ], "enum": [ "template", "integer", "boolean", "list", "map", "triggerReference", "tagReference" ] }, "key": { "description": "The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values.", "type": "string" }, "value": { "description": "A parameter's value (may contain variable references). as appropriate to the specified type.", "type": "string" }, "list": { "description": "This list parameter's parameters (keys will be ignored).", "type": "array", "items": { "$ref": "Parameter" } }, "map": { "description": "This map parameter's parameters (must have keys; keys must be unique).", "type": "array", "items": { "$ref": "Parameter" } } } }, "SetupTag": { "id": "SetupTag", "type": "object", "properties": { "tagName": { "description": "The name of the setup tag.", "type": "string" }, "stopOnSetupFailure": { "description": "If true, fire the main tag if and only if the setup tag fires successfully. If false, fire the main tag regardless of setup tag firing status.", "type": "boolean" } } }, "TeardownTag": { "id": "TeardownTag", "type": "object", "properties": { "tagName": { "description": "The name of the teardown tag.", "type": "string" }, "stopTeardownOnFailure": { "description": "If true, fire the teardown tag if and only if the main tag fires successfully. If false, fire the teardown tag regardless of main tag firing status.", "type": "boolean" } } }, "Trigger": { "id": "Trigger", "description": "Represents a Google Tag Manager Trigger", "type": "object", "properties": { "accountId": { "description": "GTM Account ID.", "type": "string" }, "containerId": { "description": "GTM Container ID.", "type": "string" }, "triggerId": { "description": "The Trigger ID uniquely identifies the GTM Trigger.", "type": "string" }, "name": { "description": "Trigger display name.", "type": "string" }, "type": { "description": "Defines the data layer event that causes this trigger.", "type": "string", "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ], "enum": [ "pageview", "domReady", "windowLoaded", "customEvent", "triggerGroup", "always", "formSubmission", "click", "linkClick", "jsError", "historyChange", "timer", "ampClick", "ampTimer", "ampScroll", "ampVisibility", "youTubeVideo", "scrollDepth", "elementVisibility" ] }, "customEventFilter": { "description": "Used in the case of custom event, which is fired iff all Conditions are true.", "type": "array", "items": { "$ref": "Condition" } }, "filter": { "description": "The trigger will only fire iff all Conditions are true.", "type": "array", "items": { "$ref": "Condition" } }, "autoEventFilter": { "description": "Used in the case of auto event tracking.", "type": "array", "items": { "$ref": "Condition" } }, "waitForTags": { "description": "Whether or not we should delay the form submissions or link opening until all of the tags have fired (by preventing the default action and later simulating the default action). Only valid for Form Submission and Link Click triggers.", "$ref": "Parameter" }, "checkValidation": { "description": "Whether or not we should only fire tags if the form submit or link click event is not cancelled by some other event handler (e.g. because of validation). Only valid for Form Submission and Link Click triggers.", "$ref": "Parameter" }, "waitForTagsTimeout": { "description": "How long to wait (in milliseconds) for tags to fire when 'waits_for_tags' above evaluates to true. Only valid for Form Submission and Link Click triggers.", "$ref": "Parameter" }, "uniqueTriggerId": { "description": "Globally unique id of the trigger that auto-generates this (a Form Submit, Link Click or Timer listener) if any. Used to make incompatible auto-events work together with trigger filtering based on trigger ids. This value is populated during output generation since the tags implied by triggers don't exist until then. Only valid for Form Submit, Link Click and Timer triggers.", "$ref": "Parameter" }, "eventName": { "description": "Name of the GTM event that is fired. Only valid for Timer triggers.", "$ref": "Parameter" }, "interval": { "description": "Time between triggering recurring Timer Events (in milliseconds). Only valid for Timer triggers.", "$ref": "Parameter" }, "limit": { "description": "Limit of the number of GTM events this Timer Trigger will fire. If no limit is set, we will continue to fire GTM events until the user leaves the page. Only valid for Timer triggers.", "$ref": "Parameter" }, "fingerprint": { "description": "The fingerprint of the GTM Trigger as computed at storage time. This value is recomputed whenever the trigger is modified.", "type": "string" }, "parentFolderId": { "description": "Parent folder id.", "type": "string" }, "selector": { "description": "A click trigger CSS selector (i.e. \"a\", \"button\" etc.). Only valid for AMP Click trigger.", "$ref": "Parameter" }, "intervalSeconds": { "description": "Time between Timer Events to fire (in seconds). Only valid for AMP Timer trigger.", "$ref": "Parameter" }, "maxTimerLengthSeconds": { "description": "Max time to fire Timer Events (in seconds). Only valid for AMP Timer trigger.", "$ref": "Parameter" }, "verticalScrollPercentageList": { "description": "List of integer percentage values for scroll triggers. The trigger will fire when each percentage is reached when the view is scrolled vertically. Only valid for AMP scroll triggers.", "$ref": "Parameter" }, "horizontalScrollPercentageList": { "description": "List of integer percentage values for scroll triggers. The trigger will fire when each percentage is reached when the view is scrolled horizontally. Only valid for AMP scroll triggers.", "$ref": "Parameter" }, "visibilitySelector": { "description": "A visibility trigger CSS selector (i.e. \"#id\"). Only valid for AMP Visibility trigger.", "$ref": "Parameter" }, "visiblePercentageMin": { "description": "A visibility trigger minimum percent visibility. Only valid for AMP Visibility trigger.", "$ref": "Parameter" }, "visiblePercentageMax": { "description": "A visibility trigger maximum percent visibility. Only valid for AMP Visibility trigger.", "$ref": "Parameter" }, "continuousTimeMinMilliseconds": { "description": "A visibility trigger minimum continuous visible time (in milliseconds). Only valid for AMP Visibility trigger.", "$ref": "Parameter" }, "totalTimeMinMilliseconds": { "description": "A visibility trigger minimum total visible time (in milliseconds). Only valid for AMP Visibility trigger.", "$ref": "Parameter" }, "parameter": { "description": "Additional parameters.", "type": "array", "items": { "$ref": "Parameter" } } } }, "Condition": { "id": "Condition", "description": "Represents a predicate.", "type": "object", "properties": { "type": { "description": "The type of operator for this condition.", "type": "string", "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "" ], "enum": [ "equals", "contains", "startsWith", "endsWith", "matchRegex", "greater", "greaterOrEquals", "less", "lessOrEquals", "cssSelector", "urlMatches" ] }, "parameter": { "description": "A list of named parameters (key/value), depending on the condition's type. Notes: - For binary operators, include parameters named arg0 and arg1 for specifying the left and right operands, respectively. - At this time, the left operand (arg0) must be a reference to a variable. - For case-insensitive Regex matching, include a boolean parameter named ignore_case that is set to true. If not specified or set to any other value, the matching will be case sensitive. - To negate an operator, include a boolean parameter named negate boolean parameter that is set to true. ", "type": "array", "items": { "$ref": "Parameter" } } } }, "Variable": { "id": "Variable", "description": "Represents a Google Tag Manager Variable.", "type": "object", "properties": { "accountId": { "description": "GTM Account ID.", "type": "string" }, "containerId": { "description": "GTM Container ID.", "type": "string" }, "variableId": { "description": "The Variable ID uniquely identifies the GTM Variable.", "type": "string" }, "name": { "description": "Variable display name.", "type": "string" }, "type": { "description": "GTM Variable Type.", "type": "string" }, "notes": { "description": "User notes on how to apply this variable in the container.", "type": "string" }, "scheduleStartMs": { "description": "The start timestamp in milliseconds to schedule a variable.", "type": "string", "format": "int64" }, "scheduleEndMs": { "description": "The end timestamp in milliseconds to schedule a variable.", "type": "string", "format": "int64" }, "parameter": { "description": "The variable's parameters.", "type": "array", "items": { "$ref": "Parameter" } }, "enablingTriggerId": { "description": "For mobile containers only: A list of trigger IDs for enabling conditional variables; the variable is enabled if one of the enabling triggers is true while all the disabling triggers are false. Treated as an unordered set.", "type": "array", "items": { "type": "string" } }, "disablingTriggerId": { "description": "For mobile containers only: A list of trigger IDs for disabling conditional variables; the variable is enabled if one of the enabling trigger is true while all the disabling trigger are false. Treated as an unordered set.", "type": "array", "items": { "type": "string" } }, "fingerprint": { "description": "The fingerprint of the GTM Variable as computed at storage time. This value is recomputed whenever the variable is modified.", "type": "string" }, "parentFolderId": { "description": "Parent folder id.", "type": "string" } } }, "Folder": { "id": "Folder", "description": "Represents a Google Tag Manager Folder.", "type": "object", "properties": { "accountId": { "description": "GTM Account ID.", "type": "string" }, "containerId": { "description": "GTM Container ID.", "type": "string" }, "folderId": { "description": "The Folder ID uniquely identifies the GTM Folder.", "type": "string" }, "name": { "description": "Folder display name.", "type": "string" }, "fingerprint": { "description": "The fingerprint of the GTM Folder as computed at storage time. This value is recomputed whenever the folder is modified.", "type": "string" } } }, "PublishContainerVersionResponse": { "id": "PublishContainerVersionResponse", "description": "Publish container version response.", "type": "object", "properties": { "containerVersion": { "description": "The container version created.", "$ref": "ContainerVersion" }, "compilerError": { "description": "Compiler errors or not.", "type": "boolean" } } }, "ListContainerVersionsResponse": { "id": "ListContainerVersionsResponse", "description": "List container versions response.", "type": "object", "properties": { "containerVersion": { "description": "All versions of a GTM Container.", "type": "array", "items": { "$ref": "ContainerVersion" } }, "containerVersionHeader": { "description": "All container version headers of a GTM Container.", "type": "array", "items": { "$ref": "ContainerVersionHeader" } } } }, "ContainerVersionHeader": { "id": "ContainerVersionHeader", "description": "Represents a Google Tag Manager Container Version Header.", "type": "object", "properties": { "accountId": { "description": "GTM Account ID.", "type": "string" }, "containerId": { "description": "GTM Container ID.", "type": "string" }, "containerVersionId": { "description": "The Container Version ID uniquely identifies the GTM Container Version.", "type": "string" }, "name": { "description": "Container version display name.", "type": "string" }, "numTags": { "description": "Number of tags in the container version.", "type": "string" }, "numTriggers": { "description": "Number of triggers in the container version.", "type": "string" }, "deleted": { "description": "A value of true indicates this container version has been deleted.", "type": "boolean" }, "numVariables": { "description": "Number of variables in the container version.", "type": "string" } } }, "ListVariablesResponse": { "id": "ListVariablesResponse", "description": "List Variables Response.", "type": "object", "properties": { "variables": { "description": "All GTM Variables of a GTM Container.", "type": "array", "items": { "$ref": "Variable" } } } }, "ListTriggersResponse": { "id": "ListTriggersResponse", "description": "List triggers response.", "type": "object", "properties": { "triggers": { "description": "All GTM Triggers of a GTM Container.", "type": "array", "items": { "$ref": "Trigger" } } } }, "ListTagsResponse": { "id": "ListTagsResponse", "description": "List Tags Response.", "type": "object", "properties": { "tags": { "description": "All GTM Tags of a GTM Container.", "type": "array", "items": { "$ref": "Tag" } } } }, "ListFoldersResponse": { "id": "ListFoldersResponse", "description": "List Folders Response.", "type": "object", "properties": { "folders": { "description": "All GTM Folders of a GTM Container.", "type": "array", "items": { "$ref": "Folder" } } } }, "FolderEntities": { "id": "FolderEntities", "description": "Represents a Google Tag Manager Folder's contents.", "type": "object", "properties": { "tag": { "description": "The list of tags inside the folder.", "type": "array", "items": { "$ref": "Tag" } }, "variable": { "description": "The list of variables inside the folder.", "type": "array", "items": { "$ref": "Variable" } }, "trigger": { "description": "The list of triggers inside the folder.", "type": "array", "items": { "$ref": "Trigger" } } } }, "Environment": { "id": "Environment", "description": "Represents a Google Tag Manager Environment. Note that a user can create, delete and update environments of type USER, but can only update the enable_debug and url fields of environments of other types.", "type": "object", "properties": { "accountId": { "description": "GTM Account ID.", "type": "string" }, "containerId": { "description": "GTM Container ID.", "type": "string" }, "environmentId": { "description": "GTM Environment ID uniquely identifies the GTM Environment.", "type": "string" }, "type": { "description": "The type of this environment.", "type": "string", "enumDescriptions": [ "Used for user defined environments.", "Used for Live environment, which points to the live published container version.", "Used for Latest environment, which points to the latest created container version.", "Used for Draft environment, which points to the single draft in the container." ], "enum": [ "user", "live", "latest", "draft" ] }, "fingerprint": { "description": "The fingerprint of the GTM environment as computed at storage time. This value is recomputed whenever the environment is modified.", "type": "string" }, "name": { "description": "The environment display name. Can be set or changed only on USER type environments.", "type": "string" }, "description": { "description": "The environment description. Can be set or changed only on USER type environments.", "type": "string" }, "enableDebug": { "description": "Whether or not to enable debug by default on for the environment.", "type": "boolean" }, "url": { "description": "Default preview page url for the environment.", "type": "string" }, "authorizationCode": { "description": "The environment authorization code.", "type": "string" }, "authorizationTimestampMs": { "description": "The last update time-stamp for the authorization code.", "type": "string", "format": "int64" }, "containerVersionId": { "type": "string" } } }, "ListEnvironmentsResponse": { "id": "ListEnvironmentsResponse", "description": "List Environments Response.", "type": "object", "properties": { "environments": { "description": "All Environments of a GTM Container.", "type": "array", "items": { "$ref": "Environment" } } } } }, "revision": "20260513", "canonicalName": "Tag Manager", "description": "This API allows clients to access and modify container and tag configuration.", "name": "tagmanager", "ownerDomain": "google.com", "version": "v1", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "batchPath": "batch", "ownerName": "Google", "parameters": { "access_token": { "type": "string", "description": "OAuth access token.", "location": "query" }, "alt": { "type": "string", "description": "Data format for response.", "default": "json", "enum": [ "json", "media", "proto" ], "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "location": "query" }, "callback": { "type": "string", "description": "JSONP", "location": "query" }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "key": { "type": "string", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", "location": "query" }, "oauth_token": { "type": "string", "description": "OAuth 2.0 token for the current user.", "location": "query" }, "prettyPrint": { "type": "boolean", "description": "Returns response with indentations and line breaks.", "default": "true", "location": "query" }, "quotaUser": { "type": "string", "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "location": "query" }, "upload_protocol": { "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query" }, "uploadType": { "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query" }, "$.xgafv": { "type": "string", "description": "V1 error format.", "enum": [ "1", "2" ], "enumDescriptions": [ "v1 error format", "v2 error format" ], "location": "query" } }, "baseUrl": "https://tagmanager.googleapis.com/", "servicePath": "", "id": "tagmanager:v1", "mtlsRootUrl": "https://tagmanager.mtls.googleapis.com/", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/tagmanager.delete.containers": { "description": "Delete your Google Tag Manager containers" }, "https://www.googleapis.com/auth/tagmanager.edit.containers": { "description": "Manage your Google Tag Manager container and its subcomponents, excluding versioning and publishing" }, "https://www.googleapis.com/auth/tagmanager.edit.containerversions": { "description": "Manage your Google Tag Manager container versions" }, "https://www.googleapis.com/auth/tagmanager.manage.accounts": { "description": "View and manage your Google Tag Manager accounts" }, "https://www.googleapis.com/auth/tagmanager.manage.users": { "description": "Manage user permissions of your Google Tag Manager account and container" }, "https://www.googleapis.com/auth/tagmanager.publish": { "description": "Publish your Google Tag Manager container versions" }, "https://www.googleapis.com/auth/tagmanager.readonly": { "description": "View your Google Tag Manager container and its subcomponents" } } } }, "title": "Tag Manager API", "kind": "discovery#restDescription", "basePath": "", "protocol": "rest", "rootUrl": "https://tagmanager.googleapis.com/" }