Google Tag Manager (Improved) icon

Google Tag Manager (Improved)

Use the Google Tag Manager API

Built-In Variable → Delete Built-In Variable

AI-generated

Overview

This node operation deletes a Built-In Variable in Google Tag Manager (GTM). It is useful for managing GTM configurations by removing unnecessary or obsolete built-in variables from a specific GTM workspace within a container and account. For example, if a built-in variable is no longer needed in a workspace, this operation can be used to delete it, helping to keep the workspace clean and organized.

Use Case Examples

  1. Deleting a built-in variable from a GTM workspace to clean up unused variables.
  2. Removing a built-in variable that is causing conflicts or errors in GTM workspace.

Properties

Name Meaning
Account ID The GTM Account ID where the built-in variable exists.
Container ID The GTM Container ID where the built-in variable exists.
Workspace ID The GTM Workspace ID where the built-in variable exists.
Optional Query Parameters Additional optional parameters for the delete operation, such as 'allowUserPermissionFeatureUpdate' to allow user permission feature updates.

Output

JSON

  • * - The response from the GTM API after deleting the built-in variable, typically an empty object or confirmation of deletion.

Dependencies

  • Google Tag Manager API OAuth2 credentials

Troubleshooting

  • Ensure that the Account ID, Container ID, and Workspace ID are correctly provided; missing any of these will cause an error.
  • Verify that the Built-In Variable to delete exists in the specified workspace; attempting to delete a non-existent variable will result in an error.
  • Check that the OAuth2 credentials for Google Tag Manager API are valid and have sufficient permissions to perform delete operations.
  • If the operation fails due to user permission feature update restrictions, ensure the 'allowUserPermissionFeatureUpdate' parameter is set to true.

Discussion