Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Property → Delete Property

AI-generated

Overview

This node integrates with the Google Analytics API, specifically targeting administrative operations on Google Analytics properties and related resources. The "Delete Property" operation under the "Admin (V1Alpha) - Property" resource allows users to mark a specified property as soft-deleted (trashed). This is useful for managing and cleaning up properties within an account that are no longer needed or relevant.

Common scenarios include:

  • Removing outdated or unused Google Analytics properties from an account.
  • Automating property lifecycle management in workflows.
  • Integrating property deletion into broader data governance or cleanup processes.

Example: A marketing team automates the removal of test properties after campaign completion by using this node to delete the property via its ID.

Properties

Name Meaning
Property ID The unique identifier of the Google Analytics property to be deleted.
Query Parameters Optional additional parameters to customize the request, such as filters or pagination.

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

  • Calculated Metric ID: ID for calculated metrics.
  • 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).

For the Delete Property operation, only the "Property ID" is strictly required.

Output

The node outputs a JSON array containing the response from the Google Analytics API. For the Delete Property operation, the output will typically be the representation of the soft-deleted property object returned by the API.

No binary data output is involved.

Dependencies

  • Requires an OAuth2 credential configured for Google Analytics API access.
  • The node uses the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1alpha.
  • Proper permissions/scopes must be granted to the OAuth2 credential to perform property deletions.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that a valid OAuth2 credential with appropriate scopes is configured.
  • Required Parameter Missing: Errors like "Property ID is required" indicate that the necessary input parameter was not provided. Verify that the Property ID is correctly set.
  • API Errors: Any errors returned by the Google Analytics API will be wrapped and shown with the message prefix "Error calling Google Analytics API." Check the error details for issues such as insufficient permissions, invalid property ID, or network problems.
  • Soft Deletion Behavior: The deletion marks the property as trashed but does not permanently remove it immediately. Users should be aware of this behavior when managing properties.

Links and References

This summary focuses on the "Delete Property" operation of the "Admin (V1Alpha) - Property" resource as requested.

Discussion