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, allowing users to manage various GTM resources programmatically within n8n workflows. Specifically, the "Version" resource with the "Live Version" operation retrieves the currently published (live) container version for a specified GTM account and container.
Common scenarios where this node is beneficial include:
- Automating retrieval of the live container version to verify deployment status.
- Integrating GTM version information into reporting or monitoring workflows.
- Triggering downstream processes based on the live version details.
Example use case:
- A marketing automation workflow that fetches the live GTM container version after publishing changes, then logs or notifies stakeholders about the update.
Properties
| Name | Meaning |
|---|---|
| Account ID | The unique identifier of the Google Tag Manager Account to operate on. |
| Container ID | The unique identifier of the GTM Container within the specified account. |
| Optional Query Parameters | Additional optional parameters to customize the API request. For this operation, typically empty. |
Output
The output JSON contains the details of the live (published) container version retrieved from the GTM API. This includes metadata such as version number, description, creation time, and other relevant properties defining the live container state.
The output structure corresponds directly to the GTM API's response for the live container version endpoint, providing comprehensive information about the current published version.
No binary data is produced by this operation.
Dependencies
- Requires an OAuth2 credential configured for Google Tag Manager API access.
- 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 retrieve version information.
Troubleshooting
- Missing Credentials Error: If the node throws an error about missing credentials, ensure that a valid Google Tag Manager OAuth2 credential is configured in n8n.
- Required Parameter Errors: The node requires both Account ID and Container ID. Omitting either will cause an error indicating the missing parameter.
- API Request Failures: Errors returned from the GTM API (e.g., permission denied, invalid IDs) will be surfaced with messages prefixed by "Error calling GTM API". Verify that the provided IDs are correct and that the authenticated user has sufficient access.
- Unknown Operation Error: This should not occur if the node is used as intended, but indicates an unsupported or misspelled operation name.
Links and References
- Google Tag Manager API Documentation - Versions
- Google Tag Manager Official Site
- n8n Documentation - OAuth2 Credentials
This summary focuses exclusively on the "Version" resource with the "Live Version" operation as requested.