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
The "Quick Preview Workspace" operation in the Google Tag Manager (GTM) node allows users to quickly preview a workspace by creating a temporary container version from all entities within the specified workspace. This is useful for testing and validating changes made in a GTM workspace before publishing them live. It helps ensure that modifications behave as expected without affecting the live environment.
Common scenarios include:
- Validating new tags, triggers, or variables in a workspace.
- Testing container configurations before publishing.
- Quickly generating a preview version of the workspace for debugging or review.
Example: A user modifies several tags and triggers in a GTM workspace and wants to preview these changes on their website without publishing. Using this operation, they can generate a quick preview container version to test the setup.
Properties
| Name | Meaning |
|---|---|
| Account ID | The GTM Account ID where the workspace resides. |
| Container ID | The GTM Container ID associated with the workspace. |
| Workspace ID | The GTM Workspace ID to be quick previewed. |
| Optional Query Parameters | Additional optional parameters to customize the API request. For this operation, typically empty. |
Note: For the "Quick Preview Workspace" operation, the required properties are Account ID, Container ID, and Workspace ID.
Output
The output is a JSON object representing the response from the GTM API's quick preview endpoint. This typically includes details about the created fake container version used for previewing the workspace. The structure corresponds to the GTM API's container version resource, which may contain information such as:
- Version number or identifier.
- Metadata about the container version.
- Entities included in the preview (tags, triggers, variables, etc.).
- Status or state of the preview.
No binary data is output by this operation.
Dependencies
- Requires an active connection to the Google Tag Manager API using OAuth2 credentials.
- The node must be configured with valid Google Tag Manager API credentials (an OAuth2 token).
- Network access to
https://www.googleapis.com/tagmanager/v2is necessary.
Troubleshooting
- Missing Required IDs: If Account ID, Container ID, or Workspace ID is not provided, the node will throw an error indicating the missing parameter.
- Authentication Errors: If the OAuth2 credentials are invalid or expired, API calls will fail. Refresh or reconfigure credentials.
- API Rate Limits: Excessive requests may lead to rate limiting by Google API; handle retries accordingly.
- Unknown Operation Error: If the operation name is incorrect or unsupported, the node throws an "Unknown operation" error.
- Network Issues: Connectivity problems to Google's API endpoint will cause failures; verify network settings.
Links and References
- Google Tag Manager API - Workspaces Quick Preview
- Google Tag Manager API Documentation
- n8n OAuth2 Credential Setup
This summary focuses specifically on the "Quick Preview Workspace" operation of the GTM node as requested.