Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

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

AI-generated

Overview

This node interacts with the Google Analytics API, specifically targeting the Admin (V1Beta) resource for managing Google Ads Links. The "List Google Ads Links" operation retrieves a list of Google Ads links associated with a specified Google Analytics property.

This node is beneficial when you want to programmatically access and manage the connections between your Google Analytics properties and Google Ads accounts. For example, it can be used to audit linked Google Ads accounts, automate reporting on linked accounts, or integrate this data into broader marketing workflows.

Practical example:

  • Automatically fetch all Google Ads links for a given Google Analytics property to monitor which ad accounts are connected.
  • Use the retrieved links to synchronize advertising data or trigger alerts if expected links are missing.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property for which to list Google Ads links.
Query Parameters Optional parameters to filter or paginate the results. Includes:
- Calculated Metric ID: ID for calculated metrics (string)
- Entity: Level of data access report (property or account level) (string)
- Filter: Expression to filter request results (string)
- Names: Names of access bindings to retrieve (string)
- Page Size: Maximum number of results to return (number, default 10)
- Page Token: Token for fetching next page of results (string)
- Show Deleted: Whether to include soft-deleted properties (boolean, default true)
- Universal Analytics Property ID: UA property to look up connected GA4 property (string)
- Update Mask: List of fields to update (snake case string)

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 account information, and status.

No binary data is output by this node.

Dependencies

  • Requires an OAuth2 credential configured for Google Analytics API access.
  • The node uses the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1beta.
  • 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 for Google Analytics API are properly set up in n8n.
  • Property ID Required: The operation requires a valid Property ID; omitting it will cause an error.
  • API Errors: Errors returned from the Google Analytics API will be wrapped and shown with the message prefix "Error calling Google Analytics API." Check the API response for details.
  • Pagination: If many Google Ads links exist, use the "Page Size" and "Page Token" query parameters to paginate through results.

Links and References

Discussion