API Reference

Google Ads / API Reference

google_ads_ad_schedule_report

Google Ads tool. Prefer the actions marked RECOMMENDED for everyday Google Ads workflows. Return performance metrics broken down by day of week and hour of day. Use this to identify optimal ad scheduling windows. Args: customer_id: Google Ads customer ID start_date: YYYY-MM-DD (default: last 30 days) end_date: YYYY-MM-DD (default: yesterday) campaign_id: Optional campaign ID filter

This is a read-only tool: it returns ad schedule report for your Google Ads account. It changes nothing.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

Ad schedule report in my Google Ads account.

It takes 1 required and 3 optional parameters.

Parameters

ParameterTypeRequiredDescription
customer_idstringYesCustomer Id
start_datestringNoStart Date
end_datestringNoEnd Date
campaign_idstringNoCampaign Id

Related Google Ads tools

Before you can call it

This tool needs a connected Google Ads account. The Google Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.

Workflows that use this

Rather than calling tools one at a time, these skills run a whole procedure against the same account:

Start using MCP Ads