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 enabling management of GTM Transformations among many other resources. The "Get Transformation" operation retrieves details about a specific transformation within a GTM workspace. This is useful for users who want to programmatically access and inspect transformation configurations in their GTM containers.
Common scenarios include:
- Automating retrieval of transformation details for auditing or reporting.
- Integrating GTM transformation data into workflows that require conditional logic based on transformation properties.
- Synchronizing transformation data between GTM and other systems.
Example: A marketing automation workflow could fetch a transformation's configuration to decide if certain tags or triggers should be updated or deployed.
Properties
| Name | Meaning |
|---|---|
| Account ID | The unique identifier of the Google Tag Manager account. |
| Container ID | The unique identifier of the GTM container within the account. |
| Workspace ID | The unique identifier of the GTM workspace inside the container. |
| Transformation ID | The unique identifier of the GTM transformation to retrieve. |
| Optional Query Parameters | Additional optional parameters to customize the request (e.g., feature flags). |
Details on Optional Query Parameters
The optional query parameters collection allows adding extra flags or filters to the API call, such as:
allowUserPermissionFeatureUpdate(boolean): Allows updating user permission features.- Other parameters exist but are generally not relevant for this operation.
Output
The output is a JSON object representing the requested GTM Transformation resource. It contains all the details returned by the GTM API for that transformation, including its configuration and metadata.
The node outputs an array of JSON objects, each corresponding to one input item processed. For the "Get Transformation" operation, typically only one transformation object is returned per execution.
No binary data is output by this operation.
Dependencies
- Requires valid Google Tag Manager API credentials configured in n8n using OAuth2 authentication.
- The node uses the official GTM API base URL:
https://www.googleapis.com/tagmanager/v2. - Proper permissions on the GTM account and container are necessary to access transformation data.
Troubleshooting
- Missing Required IDs: If any of the required IDs (Account ID, Container ID, Workspace ID, Transformation ID) are missing, the node will throw an error indicating which ID is required.
- Authentication Errors: Ensure that the OAuth2 credentials are correctly set up and authorized for the GTM API.
- API Errors: Errors from the GTM API are caught and rethrown with descriptive messages. Common issues include insufficient permissions or invalid IDs.
- Unknown Operation: If an unsupported operation is selected, the node throws an error indicating the unknown operation.
To resolve errors:
- Verify all required input fields are provided.
- Check that the OAuth2 credential has the correct scopes and is active.
- Confirm that the specified IDs correspond to existing GTM entities accessible by the authenticated user.