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 providing operations to manage GTM Transformations among many other GTM resources. The "Get Transformation" operation retrieves details of a specific transformation within a GTM workspace.
Use cases include:
- Fetching detailed information about a particular transformation in your GTM container workspace.
- Automating workflows that require reading transformation configurations for auditing or synchronization purposes.
- Integrating GTM transformation data into broader marketing or analytics automation pipelines.
Example: You want to programmatically retrieve the configuration of a transformation identified by its ID within a specific GTM account, container, and workspace to verify or log its settings.
Properties
| Name | Meaning |
|---|---|
| Account ID | The GTM Account ID where the transformation resides. |
| Container ID | The GTM Container ID containing the workspace with the transformation. |
| Workspace ID | The GTM Workspace ID within the container where the transformation exists. |
| Transformation ID | The unique identifier of the GTM Transformation to retrieve. |
| Optional Query Parameters | Additional optional parameters to customize the request. For this operation, typically empty. |
Output
The output is a JSON object representing the requested GTM Transformation resource. It contains all the properties and metadata of the transformation as returned by the Google Tag Manager API.
The structure corresponds directly to the GTM API's transformation resource schema, including fields such as transformation name, type, parameters, and any other configuration details defined in GTM.
No binary data output is involved in this operation.
Dependencies
- Requires an OAuth2 API credential configured for Google Tag Manager API access.
- The node uses the Google Tag Manager API v2 endpoint (
https://www.googleapis.com/tagmanager/v2). - Proper permissions on the GTM account, container, and workspace are necessary to perform the get operation.
Troubleshooting
- Missing Required IDs: If Account ID, Container ID, Workspace ID, or Transformation ID is not provided, the node will throw an error indicating which ID is missing.
- Authentication Errors: Ensure the OAuth2 credentials are correctly set up and authorized for the GTM API.
- Permission Denied: The authenticated user must have sufficient permissions to access the specified transformation.
- Unknown Operation Error: This occurs if an unsupported operation value is used; ensure the operation is set to "Get Transformation".
- API Request Failures: Network issues or API quota limits can cause failures; check connectivity and API usage quotas.
Links and References
- Google Tag Manager API Documentation - Transformations
- Google Tag Manager API Overview
- n8n OAuth2 Credential Setup
This summary focuses exclusively on the "Get Transformation" operation under the "Transformation" resource as requested.