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, for the Folder resource and the Entities in Folder operation, it lists all entities contained within a specified GTM folder inside a workspace.
This operation is useful when you want to retrieve all tags, triggers, variables, or other entities organized under a particular folder in your GTM container workspace. For example, you might use this to audit or synchronize folder contents, or to automate management tasks based on folder membership.
Properties
| Name | Meaning |
|---|---|
| Account ID | The unique identifier of the GTM Account that contains the folder. |
| 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 the folder exists. |
| Folder ID | The unique identifier of the GTM Folder whose entities you want to list. |
| Optional Query Parameters | Additional optional parameters to customize the API request (e.g., pagination tokens). |
Details on Required Properties for "Entities in Folder" Operation:
- Account ID: Required to specify which GTM account to access.
- Container ID: Required to specify the container within the account.
- Workspace ID: Required to specify the workspace context.
- Folder ID: Required to identify the specific folder whose entities are being listed.
Output
The output is a JSON array containing the entities found within the specified folder. Each item in the array corresponds to an entity (such as tags, triggers, or variables) that belongs to the folder in the GTM workspace.
The structure of each entity object depends on the GTM API response but typically includes identifiers, names, types, and configuration details relevant to the entity.
No binary data is output by this operation.
Dependencies
- Requires valid Google Tag Manager API credentials configured in n8n using OAuth2 authentication.
- 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 access folder entities.
Troubleshooting
- Missing Required IDs: If any of the required IDs (Account ID, Container ID, Workspace ID, Folder ID) are missing, the node will throw an error indicating which ID is required.
- Authentication Errors: Ensure that the OAuth2 credentials for Google Tag Manager are correctly set up and authorized.
- API Rate Limits or Quotas: The Google Tag Manager API may enforce rate limits; if exceeded, requests may fail temporarily.
- Invalid Folder ID: Providing a non-existent or incorrect Folder ID will result in an API error.
- Network Issues: Connectivity problems can cause request failures; verify network access to Google's API endpoints.
Links and References
- Google Tag Manager API Documentation - Folders
- Google Tag Manager API Overview
- n8n OAuth2 Credential Setup
This summary focuses on the "Folder" resource and the "Entities in Folder" operation as requested, describing the input properties, output, dependencies, and common troubleshooting points based on static analysis of the provided source code and property definitions.