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, specifically enabling management of Google Tag Configurations among many other GTM resources. The "Update Google Tag Configuration" operation allows users to update an existing Google Tag Configuration within a specified GTM account, container, and workspace.
Typical use cases include:
- Modifying settings of an existing Google Tag Configuration to reflect changes in tagging strategy.
- Automating updates to tag configurations as part of deployment workflows.
- Integrating GTM configuration updates into broader automation pipelines for marketing or analytics teams.
For example, a user might update a Google Tag Configuration to change tracking parameters or enable new features without manually accessing the GTM web interface.
Properties
| Name | Meaning |
|---|---|
| Account ID | The GTM Account ID where the Google Tag Configuration resides. |
| Container ID | The GTM Container ID containing the Google Tag Configuration. |
| Workspace ID | The GTM Workspace ID within the container where the configuration exists. |
| Google Tag Configuration ID | The unique identifier of the Google Tag Configuration to update. |
| Optional Query Parameters | Additional optional parameters to customize the request, such as feature flags or filters. |
| Request Body | JSON object representing the updated properties of the Google Tag Configuration. |
Details on Optional Query Parameters (selected examples):
- allowUserPermissionFeatureUpdate: Boolean flag to allow updating user permission features.
- fingerprint: String used for optimistic concurrency control; must match stored fingerprint.
- Other parameters relate to various GTM resource types but are generally not required for this operation.
Output
The node outputs a JSON array where each element corresponds to the response from the Google Tag Manager API for the update operation. The JSON structure represents the updated Google Tag Configuration resource as returned by the API, including all its properties after the update.
No binary data output is involved in this operation.
Dependencies
- Requires valid Google Tag Manager API credentials configured in n8n (an OAuth2 API credential).
- Internet access to call the Google Tag Manager API endpoint at
https://www.googleapis.com/tagmanager/v2. - Proper permissions on the GTM account to perform update operations on Google Tag Configurations.
Troubleshooting
- Missing Credentials Error: If the node throws an error about missing credentials, ensure that a valid Google Tag Manager API OAuth2 credential is configured and selected.
- Required Parameter Errors: The node validates presence of required IDs (Account ID, Container ID, Workspace ID, Google Tag Configuration ID). Missing any of these will cause an error. Double-check input values.
- API Errors: Errors returned from the Google API (e.g., permission denied, invalid fingerprint) will be surfaced with messages prefixed by "Error calling GTM API". Review the message and stack trace for details.
- Fingerprint Mismatch: If using the fingerprint parameter, ensure it matches the current fingerprint of the resource to avoid update conflicts.
- Unknown Operation: Using an unsupported operation value will cause an error. Confirm the operation is set to "Update Google Tag Configuration".
Links and References
- Google Tag Manager API Documentation
- Google Tag Configuration Resource
- Google Tag Manager OAuth2 Setup
This summary focuses exclusively on the "Update Google Tag Configuration" operation of the Google Tag Manager node as requested.