Google Tag Manager icon

Google Tag Manager

Use the Google Tag Manager API

Actions84

Overview

This node integrates with the Google Tag Manager (GTM) API, allowing users to manage various GTM resources programmatically within n8n workflows. Specifically, the "Get User Permission" operation under the "User Permission" resource retrieves details about a user's access permissions for a GTM account and its containers.

Common scenarios where this node is beneficial include:

  • Automating audits of user permissions across GTM accounts.
  • Integrating GTM user permission data into reporting or compliance workflows.
  • Managing user access dynamically based on external triggers or conditions.

For example, you could use this node to fetch a specific user's permissions in a GTM account to verify their access level before performing further automated changes.

Properties

Name Meaning
Account ID The unique identifier of the Google Tag Manager Account from which to retrieve user permission information.
User Permissions ID The unique identifier of the specific GTM User Permission entry to get details for.
Optional Query Parameters Additional optional parameters that can modify the request behavior. For this operation, these parameters are generally not required but can be used if applicable.

Note: For the "Get User Permission" operation, only Account ID and User Permissions ID are mandatory.

Output

The output JSON contains the detailed information about the specified user's permissions within the GTM account. This typically includes fields such as:

  • User access levels at the account and container scopes.
  • Specific permissions granted.
  • Metadata related to the user permission entry.

The node returns this data as a JSON object in the main output. There is no binary data output for this operation.

Dependencies

  • Requires an active connection to the Google Tag Manager API via OAuth2 authentication.
  • The node expects valid credentials configured in n8n for accessing the Google Tag Manager API.
  • No additional environment variables are needed beyond the OAuth2 credential setup.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that the Google Tag Manager API OAuth2 credentials are properly set up and connected in n8n.
  • Required Parameter Errors: The node validates required parameters like Account ID and User Permissions ID. Missing these will cause errors. Double-check that these IDs are correctly provided.
  • API Errors: Errors returned by the GTM API (e.g., invalid IDs, insufficient permissions) will be surfaced with descriptive messages. Verify that the authenticated user has sufficient rights to access the requested user permission.
  • Unknown Operation: If an unsupported operation is selected, the node will throw an error indicating the unknown operation. Ensure the correct operation name is chosen.

Links and References


This summary focuses on the "User Permission" resource and the "Get User Permission" operation as requested, based on static analysis of the provided source code and property definitions.

Discussion