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, allowing users to manage various GTM resources programmatically. Specifically, the "Get Container" operation under the "Container" resource retrieves detailed information about a specific GTM container within an account.
Common scenarios for this node include:
- Automating retrieval of container configurations for auditing or reporting.
- Integrating GTM container data into workflows that require dynamic access to tag management settings.
- Synchronizing container details with other systems or dashboards.
For example, a marketing team might use this node to fetch container details before deploying new tags or triggers, ensuring they have the latest configuration snapshot.
Properties
| Name | Meaning |
|---|---|
| Account ID | The unique identifier of the Google Tag Manager Account containing the container. |
| Container ID | The unique identifier of the GTM Container to retrieve. |
| Optional Query Parameters | Additional optional parameters to customize the request. These include: |
| - Allow User Permission Feature Update (boolean): Allows updating user permission features. | |
| - Built-In Variable Type (options): Various built-in variable types like Advertiser ID, Click Text, etc. | |
| - Container Version ID (string): Specify a particular container version. | |
| - Copy Settings (boolean): Whether to copy tag settings when combining containers. | |
| - Copy Terms Of Service (boolean): Accept terms of service agreements when copying tags. | |
| - Copy Users (boolean): Whether to copy users from one tag to another. | |
| - Destination ID (string): Destination linked to a GTM Container. | |
| - Fingerprint (string): Must match the fingerprint of the account in storage. | |
| - Include Google Tags (boolean): Whether to include accounts associated with Google Tag. | |
| - Page Token (string): Token for paginated results. | |
| - Setting Source (options): Source of config setting after combine (Current, Other, Unspecified). | |
| - Tag ID (string): Tag ID for a GTM Container. | |
| - Tag Name (string): Name for a newly created tag. | |
| - Trigger ID (string): Triggers to be moved to a folder. | |
| - Variable ID (string): Variables to be moved to a folder. |
Note: For the "Get Container" operation, primarily the Account ID and Container ID are required; other optional query parameters can be used as needed.
Output
The output is a JSON object representing the GTM Container resource retrieved from the Google Tag Manager API. This includes all container details such as container name, usage context, public ID, and any other metadata provided by the API.
The structure corresponds directly to the GTM API's container representation, typically including fields like:
accountId: The account ID owning the container.containerId: The container's unique ID.name: The container's display name.usageContext: Array describing where the container is used (e.g., web, AMP).- Other metadata fields as defined by the GTM API.
No binary data output is involved in this operation.
Dependencies
- Requires an OAuth2 credential configured for Google Tag Manager API access.
- The node uses the base URL
https://www.googleapis.com/tagmanager/v2. - Proper permissions on the Google Tag Manager account are necessary to perform the "Get Container" operation.
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 selected.
- Required Parameter Missing: Errors indicating missing Account ID or Container ID mean these must be provided for the operation to succeed.
- API Errors: Any errors returned from the GTM API will be wrapped and shown with the message prefix "Error calling GTM API". Check the error message for details such as permission issues or invalid IDs.
- Invalid Optional Parameters: Providing unsupported or incorrectly formatted optional query parameters may cause API errors. Validate parameter values carefully.