Read Google Ads campaigns
get_google_ads_campaignsThe connected Google Ads account's campaigns for a period, from what the daily pull stored: impressions, clicks, click through rate, average cost per click, cost, conversions, conversion rate, cost per conversion and conversion value, most spend first, with each campaign's details as Google has them now (type, status, bid strategy and daily budget). Campaign numbers reach back 13 months. With withImpressionShare it also asks Google for each Search campaign's impression share and the share lost to budget and to rank (impressionShare says whether Google answered); nothing else here calls Google. Money is in the account's currency (currencyCode). Read-only; uses no credits.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>"
},
"name": "get_google_ads_campaigns"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| range | No | A named period ending on the last stored day (default last_3_months). Ignored when startDate and endDate are given. | |
| endDate | No | Last day (YYYY-MM-DD). Use with startDate; at most 730 days. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| startDate | No | First day (YYYY-MM-DD, the Ads account's time zone). | |
| withImpressionShare | No | Also give each Search campaign's impression share and the share lost to budget and to rank. These are the only numbers asked of Google when the tool runs (held for 10 minutes); every other number is stored. Default false. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| meta | No | ||
| rows | No | ||
| reason | No | ||
| endDate | No | ||
| hasMore | No | ||
| message | No | ||
| failedAt | No | ||
| rowCount | No | ||
| startDate | No | ||
| connectUrl | No | ||
| storedFrom | No | ||
| accountName | No | ||
| currencyCode | No | ||
| storedThrough | No | ||
| numbersStartOn | No | ||
| impressionShare | No |