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
The "Update Transformation" operation in the Google Tag Manager (GTM) node allows users to update an existing transformation within a specified GTM workspace. Transformations in GTM are used to modify or manipulate data before it is sent to tags, triggers, or variables, enabling more flexible and powerful tag management.
This operation is beneficial when you need to programmatically change the configuration of a transformation, such as updating its rules or parameters, without manually editing it in the GTM interface. For example, you might update a transformation to adjust how user data is processed based on new privacy requirements or to fix errors in data mapping.
Properties
| Name | Meaning |
|---|---|
| Account ID | The unique identifier of the GTM Account where the transformation exists. |
| Container ID | The unique identifier of the GTM Container that holds the workspace with the transformation. |
| Workspace ID | The unique identifier of the GTM Workspace containing the transformation to update. |
| Transformation ID | The unique identifier of the specific GTM Transformation to update. |
| Optional Query Parameters | Additional optional parameters for the request, such as allowUserPermissionFeatureUpdate (boolean), fingerprint (string), etc. These control specific behaviors or provide metadata for the update operation. |
| Request Body | A JSON object representing the updated properties of the transformation. This contains the new configuration details to apply. |
Output
The output is a JSON object representing the updated transformation resource as returned by the GTM API. It includes all the details of the transformation after the update has been applied, such as its ID, name, type, and any other relevant configuration fields.
No binary data is output by this operation.
Dependencies
- Requires valid Google Tag Manager API credentials with OAuth2 authentication.
- The node must be configured with these credentials to authorize API requests.
- Network access to the Google Tag Manager API endpoint (
https://www.googleapis.com/tagmanager/v2) is required.
Troubleshooting
- Missing Required IDs: Errors will occur if any of the required identifiers (Account ID, Container ID, Workspace ID, Transformation ID) are not provided. Ensure all these IDs are correctly set.
- Invalid Credentials: If the OAuth2 credentials are missing or invalid, the node will throw an error indicating missing or unauthorized credentials.
- API Errors: The node surfaces errors from the GTM API, including permission issues, invalid request bodies, or conflicts. Review the error message and stack trace for details.
- Fingerprint Mismatch: If a fingerprint is provided in optional query parameters, it must match the stored fingerprint; otherwise, the update will fail.
- Incorrect Request Body: The JSON in the request body must conform to the expected structure of a GTM transformation resource. Invalid or incomplete JSON will cause the API to reject the request.
Links and References
- Google Tag Manager API - Transformations
- Google Tag Manager Concepts
- Google Tag Manager API Authentication
If you need further details about the request body structure or examples, please refer to the official Google Tag Manager API documentation linked above.