Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Google Ads Link → List Google Ads Links

AI-generated

Overview

This node interacts with the Google Analytics API, specifically targeting the Admin (V1Alpha) resource for managing Google Ads Links within a property. The "List Google Ads Links" operation retrieves all Google Ads links associated with a specified Google Analytics property. This is useful for users who want to view or audit the connections between their Google Analytics properties and Google Ads accounts.

Common scenarios:

  • Auditing which Google Ads accounts are linked to a particular Google Analytics property.
  • Automating reporting or synchronization tasks that depend on knowing existing Google Ads links.
  • Integrating Google Ads link data into workflows for marketing analysis or account management.

Example use case:
A marketing analyst wants to generate a report of all Google Ads accounts linked to a specific Google Analytics property to verify correct linking and permissions. They can use this node operation to fetch the list programmatically.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property whose Google Ads links you want to list.
Query Parameters Optional parameters to filter or paginate the results. Includes:
- Calculated Metric ID: ID for calculated metrics (not typically used here).
- Entity: Level of data access report (property or account level).
- Filter: Expression to filter results.
- Names: Names of access bindings to retrieve.
- Page Size: Maximum number of results 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: Fields to update (snake case).

Output

The output is a JSON array where each item represents a Google Ads Link resource associated with the specified property. Each object contains details about a single Google Ads link, such as its ID, linked Google Ads customer ID, and status.

The node does not output binary data.

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 on the Google Analytics property are required to list Google Ads links.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that the OAuth2 credentials are properly set up and authorized.
  • Property ID Required: The operation requires a valid Property ID; if missing, the node will throw an error indicating this requirement.
  • API Errors: Errors returned from the Google Analytics API will be surfaced with messages prefixed by "Error calling Google Analytics API." Check the message and stack trace for details.
  • Pagination: If many Google Ads links exist, use the Page Token query parameter to paginate through results.

Links and References

Discussion