Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Reporting Data Annotation → Delete Reporting Data Annotation

AI-generated

Overview

This node integrates with the Google Analytics API, specifically targeting the Admin (V1Alpha) resource for Reporting Data Annotations. The "Delete Reporting Data Annotation" operation allows users to delete a specific reporting data annotation within a Google Analytics property. This is useful for managing and cleaning up annotations that are no longer relevant or were created in error.

Typical use cases include:

  • Automating the removal of outdated or incorrect reporting annotations.
  • Managing annotations programmatically as part of a larger analytics workflow.
  • Maintaining clean and accurate reporting metadata within Google Analytics properties.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property where the reporting data annotation exists.
Reporting Data Annotation ID The unique identifier of the reporting data annotation to be deleted.
Query Parameters Optional parameters to refine or control the request; includes options like filter, page size, etc.

The Query Parameters collection supports these options (not all necessarily used in delete operation but available generally):

  • Calculated Metric ID
  • Entity (property or account level)
  • Filter expression
  • Names (access bindings to retrieve)
  • Page Size (max number of results)
  • Page Token (for pagination)
  • Show Deleted (include soft-deleted items)
  • Universal Analytics Property ID
  • Update Mask (fields to update)

Output

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

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 allow deletion of reporting data annotations.

Troubleshooting

  • Missing Credentials Error: If the OAuth2 credentials are not set or invalid, the node will throw an error indicating missing Google Analytics API credentials.
  • Required Parameter Missing: Errors will occur if either the Property ID or Reporting Data Annotation ID is not provided, as these are mandatory to identify the resource to delete.
  • API Errors: Any errors returned by the Google Analytics API (e.g., permission denied, resource not found) will be surfaced with the message prefixed by "Error calling Google Analytics API:".
  • Invalid IDs: Providing incorrect or non-existent IDs will result in API errors; verify IDs before running the node.

Links and References

This summary focuses on the "Delete Reporting Data Annotation" operation under the Admin (V1Alpha) - Reporting Data Annotation resource, describing its purpose, required inputs, outputs, dependencies, and common troubleshooting points based on static analysis of the node source code and provided property definitions.

Discussion