Retrieve detailed ad data including performance metrics for the specified customer and date range.
Args: customer_id: The Google Ads customer ID
start_date (str): Start date for the data range (YYYY-MM-DD). Defaults to 180 days ago. end_date (str): End date for the data range (YYYY-MM-DD). Defaults to today. ad_group_id (int | None): Optional filter by ad group ID ad_id (int | None): Optional filter by ad ID limit: Maximum number of records to retrieve (default: 20)
search: Optional text search filter exclude_removed: Exclude REMOVED entities from results (default: False) oauth2_token: The OAuth2 token for authentication
Returns: List of AdData objects containing ad details and performance
The access token received from the authorization server in the OAuth 2.0 flow.
1 - 200Optional specific Token ID
Successful Response
Metrics associated with an ad