Actions84
- 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
Overview
This node integrates with the Google Tag Manager (GTM) API, specifically focusing on managing "Transformations" within GTM container workspaces. The "List Transformations" operation retrieves all transformations associated with a specified GTM container workspace.
Use cases include:
- Automating retrieval of transformation configurations in GTM for auditing or synchronization.
- Integrating GTM transformation data into workflows for reporting or further processing.
- Managing GTM container workspace entities programmatically without manual intervention.
For example, you might use this node to list all transformations in a particular workspace to verify their settings before publishing changes.
Properties
| Name | Meaning |
|---|---|
| Account ID | The unique identifier of the GTM Account containing the container. |
| Container ID | The unique identifier of the GTM Container within the account. |
| Workspace ID | The unique identifier of the GTM Workspace inside the container where transformations reside. |
| Optional Query Parameters | Additional optional parameters to refine or control the API request. |
Details on Optional Query Parameters (subset relevant to this operation)
allowUserPermissionFeatureUpdate: Boolean flag to allow user permission feature updates.pageToken: Token for pagination to fetch the next page of results.
(Note: Many other optional parameters exist but are not typically relevant for listing transformations.)
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 configuration and metadata.
No binary data is output by this operation.
Dependencies
- Requires an OAuth2 API credential configured for Google Tag Manager API access.
- The node makes HTTP requests to the Google Tag Manager API endpoint at
https://www.googleapis.com/tagmanager/v2. - Proper permissions on the GTM account and container are necessary to list transformations.
Troubleshooting
- Missing Credentials: If the OAuth2 credentials are not set up or invalid, the node will throw an error indicating missing credentials.
- Required IDs Missing: The node requires Account ID, Container ID, and Workspace ID to be provided; missing any of these will cause an error specifying which ID is required.
- API Errors: Errors returned from the GTM API (e.g., permission denied, invalid IDs) will be surfaced with messages prefixed by "Error calling GTM API".
- Pagination: If there are many transformations, use the
pageTokenoptional parameter to paginate through results.
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.