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 GTM Triggers within a Container Workspace. The "List Triggers" operation retrieves all triggers configured in a specified GTM Container workspace. This is useful for automation workflows that need to audit, report, or synchronize trigger configurations across environments.
Common scenarios include:
- Automatically fetching all triggers from a GTM container to analyze or export them.
- Integrating GTM trigger data into other systems for monitoring or compliance.
- Using the list of triggers as input for further automated updates or deployments.
Example: You want to retrieve all triggers from a specific GTM container workspace to generate a report of active triggers or to verify their settings before publishing changes.
Properties
| Name | Meaning |
|---|---|
| Account ID | The unique identifier of the Google Tag Manager Account where the container resides. |
| Container ID | The unique identifier of the GTM Container from which to list triggers. |
| Workspace ID | The unique identifier of the GTM Workspace inside the container to scope the triggers list. |
| Optional Query Parameters | Additional optional parameters to customize the API request. |
The Optional Query Parameters collection includes various fields, but for the "List Triggers" operation, typically no additional parameters are required or used.
Output
The output is a JSON array containing the list of GTM Trigger objects retrieved from the specified container workspace. Each object represents a trigger with its configuration details as defined by the GTM API.
The structure corresponds directly to the GTM API's trigger resource representation, including properties such as trigger name, type, filter conditions, and other metadata.
No binary data is output by this operation.
Dependencies
- Requires an OAuth2 API credential for authenticating with the Google Tag Manager API.
- 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 list triggers.
Troubleshooting
- Missing Credentials Error: If the node throws an error about missing credentials, ensure you have configured and selected valid Google Tag Manager OAuth2 credentials.
- Required Parameter Errors: The node requires Account ID, Container ID, and Workspace ID for this operation. Omitting any will cause an error indicating the missing parameter.
- 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". Verify that the provided IDs are correct and that your account has access rights.
- Empty Results: If no triggers are returned, confirm that the workspace contains triggers and that the IDs are accurate.
Links and References
- Google Tag Manager API Documentation - Triggers
- Google Tag Manager Official Site
- n8n OAuth2 Credential Setup Guide
This summary focuses exclusively on the "Trigger" resource and the "List Triggers" operation as requested.