Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Data (V1Beta) - Property → Get Metadata

AI-generated

Overview

This node integrates with the Google Analytics API, specifically supporting a wide range of administrative and data-related operations across different API versions (v1alpha, v1beta) and resource types. The "Data (V1Beta) - Property" resource with the "Get Metadata" operation allows users to retrieve metadata information about a specific Google Analytics property.

Typical use cases include:

  • Fetching metadata details for a Google Analytics property to understand its configuration or available dimensions and metrics.
  • Automating administrative tasks related to Google Analytics properties.
  • Integrating Google Analytics data and metadata retrieval into workflows for reporting or analysis.

For example, a user might want to get metadata about a GA4 property to dynamically build reports or validate available fields before running queries.

Properties

Name Meaning
Property ID The unique identifier of the Google Analytics property for which metadata is requested.
Query Parameters Optional parameters to refine or filter the metadata request. Includes:
- 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 (default 10).
- Page Token: Token for fetching next page of results.
- Show Deleted: Whether to include soft-deleted properties (default true).
- Universal Analytics Property ID: UA property to look up connected GA4 property.
- Update Mask: List of fields to update (in snake case).

Output

The node outputs JSON data representing the response from the Google Analytics API for the requested metadata. This typically includes detailed metadata information about the specified property, such as available dimensions, metrics, settings, and other configuration details.

If the API returns binary data (not typical for metadata requests), it would be included accordingly, but this operation primarily deals with JSON metadata.

Dependencies

  • Requires an OAuth2 API credential configured for Google Analytics API access.
  • The node uses the Google Analytics Admin API endpoints (https://analyticsadmin.googleapis.com/v1beta) for metadata retrieval.
  • Proper permissions on the Google Analytics property are necessary to fetch metadata.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that a valid OAuth2 credential for Google Analytics is configured in n8n.
  • Required Parameter Errors: Errors like "Property ID is required" indicate that the mandatory propertyId parameter was not provided. Make sure to specify the correct property ID.
  • API Request Failures: Errors returned from the Google Analytics API will be wrapped and shown with messages like "Error calling Google Analytics API." Check the error message and stack trace for details. Common issues include insufficient permissions, invalid IDs, or malformed query parameters.
  • Pagination Issues: When using pageSize and pageToken in query parameters, ensure tokens are correctly handled to paginate through results.

Links and References

This summary focuses on the "Data (V1Beta) - Property" resource and the "Get Metadata" operation, describing how to configure and use the node to retrieve metadata for a Google Analytics property.

Discussion