Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Beta) - Google Ads Link → Update Google Ads Link

AI-generated

Overview

This node interacts with the Google Analytics API, specifically supporting a wide range of administrative and data management operations across different versions (v1alpha, v1beta) and data APIs. For the selected resource "Admin (V1Beta) - Google Ads Link" and operation "Update Google Ads Link," it allows users to update existing Google Ads links associated with a Google Analytics property.

Typical use cases include managing integrations between Google Analytics properties and Google Ads accounts, such as updating link settings or configurations to ensure accurate data sharing and reporting between these platforms.

Example: A marketing analyst wants to update the configuration of a Google Ads link for a specific Google Analytics property to reflect changes in their advertising campaigns or account structure.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property where the Google Ads link exists.
Google Ads Link ID The identifier of the specific Google Ads link to update within the given property.
Query Parameters Optional parameters to customize the request, including:
- 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 items to return
- Page Token: Token for pagination
- Show Deleted: Whether to include soft-deleted properties
- Universal Analytics Property ID: UA property linked to GA4 property
- Update Mask: Comma-separated list of fields to update (in snake_case)
Request Body JSON object containing the updated data for the Google Ads link. This is the payload sent in the PATCH request.

Output

The node outputs an array of JSON objects representing the response from the Google Analytics API after updating the Google Ads link. The exact structure depends on the API's response but typically includes details of the updated Google Ads link resource, such as its IDs, status, and configuration fields.

No binary data output is involved.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • Uses the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1beta.
  • The node performs authenticated HTTP requests using OAuth2 tokens.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that OAuth2 credentials for Google Analytics are properly set up and connected in n8n.
  • Required Parameter Errors: Errors like "Property ID is required" or "Google Ads Link ID is required" indicate missing mandatory inputs. Verify that these IDs are correctly provided.
  • API Request Failures: Errors returned by the Google Analytics API will be wrapped and shown with the message prefix "Error calling Google Analytics API." Check the error message and stack trace for details. Common issues include invalid IDs, insufficient permissions, or malformed request bodies.
  • Update Mask Usage: When specifying the updateMask query parameter, ensure field names are in snake_case and correspond exactly to the fields being updated in the request body to avoid partial updates or errors.

Links and References


This summary focuses on the "Admin (V1Beta) - Google Ads Link" resource and the "Update Google Ads Link" operation, describing how the node constructs and sends the appropriate PATCH request to update a Google Ads link for a specified property.

Discussion