Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Subproperty Event Filter → Delete Subproperty Event Filter

AI-generated

Overview

This node integrates with the Google Analytics API, specifically targeting administrative functions related to subproperty event filters within a property. The "Delete Subproperty Event Filter" operation allows users to delete a specific subproperty event filter from a given property in Google Analytics.

Common scenarios for this node include managing and cleaning up event filters that are no longer needed or were created by mistake. For example, if an organization wants to remove a filter that modifies how events are processed or reported for a subproperty, this node can be used to delete that filter programmatically.

Practical example:

  • An analytics administrator wants to automate the removal of outdated event filters across multiple properties. Using this node, they can specify the property ID and the subproperty event filter ID to delete the filter without manual intervention in the Google Analytics UI.

Properties

Name Meaning
Property ID The unique identifier of the Google Analytics property where the subproperty event filter exists. This is required to specify the target property.
Subproperty Event Filter ID The unique identifier of the subproperty event filter to delete. This identifies which filter will be removed.
Query Parameters Optional additional parameters to customize the request. Includes options like calculated metric ID, entity level, filtering expressions, pagination controls, and update masks.

The "Query Parameters" collection supports these options (all optional):

  • Calculated Metric ID: ID for a calculated metric.
  • Entity: Level of data access report (property or account).
  • Filter: Expression to filter results.
  • Names: Names of access bindings to retrieve.
  • Page Size: Maximum number of report tasks to return.
  • Page Token: Token for fetching next page of results.
  • Show Deleted: Whether to include soft-deleted properties.
  • Universal Analytics Property ID: UA property to look up connected GA4 property.
  • Update Mask: List of fields to update (snake case).

Output

The output is a JSON array containing the response from the Google Analytics API after attempting to delete the specified subproperty event filter. Typically, for a delete operation, the response may be empty or contain confirmation metadata depending on the API's behavior.

No binary data output is involved in this operation.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • The node uses the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1alpha.
  • Proper permissions on the Google Analytics account/property to delete subproperty event filters are necessary.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that the Google Analytics OAuth2 API credentials are properly set up in n8n.
  • Required Parameter Missing: Errors indicating missing "Property ID" or "Subproperty Event Filter ID" mean these inputs must be provided for the operation to succeed.
  • API Permission Denied: If the API returns permission errors, verify that the authenticated user has sufficient rights to delete event filters on the specified property.
  • Invalid IDs: Providing incorrect or non-existent Property ID or Subproperty Event Filter ID will cause the API to fail. Double-check these values.
  • Network or API Errors: General API call failures might be due to network issues or temporary Google API outages; retrying later or checking connectivity may help.

Links and References

Discussion