Actions102
- Account Actions
- Built-In Variable Actions
- Client Actions
- Container Actions
- Destination Actions
- Environment Actions
- Folder Actions
- Google Tag Configuration Actions
- Tag Actions
- Template Actions
- Transformation Actions
- Trigger Actions
- User Permission Actions
- Variable Actions
- Version Actions
- Workspace Actions
- Zone Actions
Overview
This node integrates with the Google Tag Manager (GTM) API, specifically focusing on managing "Transformations" within GTM. The "List Transformations" operation retrieves all transformations associated with a specific GTM container workspace. This is useful for users who want to programmatically access and manage their GTM transformations, such as auditing existing transformations, syncing them with other systems, or automating deployment workflows.
Common scenarios:
- Listing all transformations in a GTM workspace to review or export configuration.
- Automating monitoring or reporting of GTM transformation setups.
- Integrating GTM transformation data into broader marketing or analytics automation pipelines.
Example:
A marketing team wants to fetch all transformations from a particular GTM workspace to verify that the correct data transformations are applied before publishing changes.
Properties
| Name | Meaning |
|---|---|
| Account ID | The GTM Account ID where the container resides. |
| Container ID | The GTM Container ID containing the workspace. |
| Workspace ID | The GTM Workspace ID within the container where transformations exist. |
| Optional Query Parameters | Additional optional parameters to refine or control the API request. |
The Optional Query Parameters collection can include various flags and filters relevant to different operations but for listing transformations, it mainly allows adding query parameters supported by the GTM API.
Output
The output is a JSON array where each item represents a GTM Transformation object retrieved from the specified container workspace. Each transformation object contains details as defined by the GTM API, such as its ID, name, type, and configuration.
No binary data is output by this operation.
Dependencies
- Requires an OAuth2 credential configured for Google Tag Manager API access.
- The node uses the base URL
https://www.googleapis.com/tagmanager/v2. - Proper permissions on the GTM account, container, and workspace are necessary to list transformations.
Troubleshooting
- Missing Credentials Error: If the node throws an error about missing credentials, ensure that a valid Google Tag Manager OAuth2 credential is set up and connected.
- Required Parameter Errors: The node requires Account ID, Container ID, and Workspace ID for this operation. Missing any of these will cause an error indicating which parameter is required.
- API Errors: Errors returned from the GTM API will be wrapped and shown with the message prefix "Error calling GTM API". Check the stack trace for more details.
- Permission Issues: Insufficient permissions on the GTM account or container may result in authorization errors. Verify that the authenticated user has access rights.
Links and References
- Google Tag Manager API Documentation - Transformations
- Google Tag Manager API Overview
- n8n OAuth2 Credential Setup
This summary focuses on the "Transformation" resource and the "List Transformations" operation as requested, based on static analysis of the provided source code and property definitions.