google_ads_get_account_summary

Get Google Ads Account Summary

Google

Description

Standardized account-level performance summary for cross-platform comparison. Returns normalized metrics identical to meta_ads_get_account_summary plus the supported Demand Gen Platform Comparable conversion family, with per-conversion-action breakdown. Preferred over insights or performance report for quick account overviews. Always fetches fresh data.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_get_account_summary",
    "arguments": {
      "customer_id": "1234567890",
      "reason": "Quick performance overview"
    }
  }
}

Parameters

NameTypeRequiredDescription
customer_id string Required The Google Ads Customer ID (10 digits, with or without dashes)pattern: ^[\d-]+$
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (3)
NameTypeRequiredDescription
login_customer_id string Optional MCC (Manager) Customer ID; required for managed accountspattern: ^[\d-]+$
date_preset string Optional Predefined date range: TODAY, YESTERDAY, LAST_7_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH
TODAY YESTERDAY LAST_7_DAYS LAST_30_DAYS THIS_MONTH LAST_MONTH
date_range object Optional Custom date range {start_date, end_date} in YYYY-MM-DD

Examples

Last 30 days summary

{
  "customer_id": "1234567890",
  "reason": "Quick performance overview"
}

hopkin google account-summary get --customer-id 1234567890

Last 7 days

{
  "customer_id": "1234567890",
  "date_preset": "LAST_7_DAYS",
  "reason": "Weekly check-in"
}

hopkin google account-summary get --customer-id 1234567890 --date-preset LAST_7_DAYS

With MCC

{
  "customer_id": "1234567890",
  "login_customer_id": "9876543210",
  "date_preset": "LAST_30_DAYS",
  "reason": "Managed account overview"
}

hopkin google account-summary get --customer-id 1234567890 --login-customer-id 9876543210 --date-preset LAST_30_DAYS