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. Specifically, the "Get Environment" operation under the "Environment" resource retrieves details about a specific GTM Environment within a container.
Common scenarios where this node is beneficial include:
- Automating retrieval of environment configurations for auditing or synchronization.
- Integrating GTM environment data into workflows for deployment pipelines.
- Fetching environment details to dynamically adjust tags or triggers based on environment settings.
For example, a user might use this node to fetch the details of a staging environment in GTM before deploying new tags, ensuring that the environment is correctly configured.
Properties
| Name | Meaning |
|---|---|
| Account ID | The unique identifier of the GTM Account containing the environment. |
| Container ID | The unique identifier of the GTM Container within the account. |
| Environment ID | The unique identifier of the GTM Environment to retrieve. |
| Optional Query Parameters | Additional optional parameters to customize the request. |
The Optional Query Parameters collection includes various advanced options applicable across operations but are generally not required for a simple "Get Environment" call.
Output
The node outputs a JSON object representing the requested GTM Environment's details. This includes all properties returned by the GTM API for an environment resource, such as environment name, URL, authorization codes, and other configuration metadata.
The output structure corresponds directly to the Google Tag Manager Environment resource schema, providing comprehensive information about the specified environment.
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 and container are necessary to retrieve environment details.
Troubleshooting
- Missing Credentials Error: If the node throws an error about missing credentials, ensure that a valid Google Tag Manager OAuth2 credential is configured and connected.
- Required Parameter Errors: The node requires Account ID, Container ID, and Environment ID for this operation. Omitting any will cause an error indicating which parameter is missing.
- API Errors: Errors from the GTM API (e.g., permission denied, not found) will be surfaced with messages prefixed by "Error calling GTM API". Verify that the IDs are correct and that the authenticated user has sufficient access.
- Unknown Operation Error: If the operation name is incorrect or unsupported, the node will throw an unknown operation error.
Links and References
- Google Tag Manager API v2 Documentation - Environments
- Google Tag Manager API Overview
- n8n OAuth2 Credential Setup
This summary focuses on the "Get Environment" operation of the "Environment" resource as requested, based on static analysis of the provided source code and property definitions.