Google Tag Manager

Overview

This node integrates with the Google Tag Manager (GTM) API, specifically enabling management of Google Tag Configurations within GTM containers and workspaces. The "List Google Tag Configurations" operation retrieves all Google Tag configurations present in a specified GTM container workspace.

Typical use cases include:

• Automating retrieval of Google Tag configurations for auditing or reporting.
• Integrating GTM tag configuration data into workflows for further processing or synchronization.
• Managing multiple GTM containers by programmatically listing their tag configurations.

For example, a marketing team could use this node to fetch all Google Tag configurations from a container to verify settings or export them for backup.

Properties

Details on Optional Query Parameters (subset relevant to this operation):

• allowUserPermissionFeatureUpdate (boolean): Allows updating user permission features if needed.
• includeGoogleTags (boolean): Whether to include accounts associated with Google Tag.
• pageToken (string): Token for pagination to fetch the next page of results.
• Other parameters exist but are generally not required for listing Google Tag Configurations.

Output

The output is a JSON array where each item represents a Google Tag Configuration object retrieved from the specified GTM container workspace. Each object contains details about a Google Tag Configuration as returned by the GTM API.

The structure corresponds directly to the Google Tag Manager API's response for Google Tag Configurations, typically including fields such as configuration IDs, names, parameters, and metadata.

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 official GTM API endpoint: https://www.googleapis.com/tagmanager/v2.
• Proper permissions on the GTM account and container are necessary to list Google Tag Configurations.

Troubleshooting

• Missing Credentials Error: If the node throws an error about missing credentials, ensure that a valid Google Tag Manager OAuth2 credential is set up and connected.
• Required Parameter Errors: The node requires Account ID, Container ID, and Workspace ID. Omitting any of these will cause an error indicating which parameter is missing.
• 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 the authenticated user has sufficient permissions.
• Pagination: If there are many Google Tag Configurations, use the pageToken optional parameter to paginate through results.

Links and References

• Google Tag Manager API Documentation - Google Tag Configurations
• Google Tag Manager API Overview
• n8n OAuth2 Credential Setup

This summary focuses exclusively on the "List Google Tag Configurations" operation under the "Google Tag Configuration" resource as requested.