Google Ads data, from one API.

List the Google Ads accounts this Google login can access directly, with name, currency, time zone, status and whether each is a manager (MCC) or test account. Accounts that can't be read (for example, not enabled) are listed with an error. Client accounts reached only through a manager are not listed; use list_child_accounts on the manager. Describes at most 50 accounts.

List the client accounts under a manager (MCC) account, with name, currency, time zone, status, whether each is itself a manager, and its level below the manager.

customer_id* string

The manager account's customer ID, with or without dashes, e.g. "123-456-7890".

login_customer_id string

Only when this Google login reaches customer_id through a manager (MCC) account: that manager's customer ID, e.g. "111-222-3333".

max_level integer

How many levels below the manager to include (1 = direct clients only). default: 1

Run a read-only Google Ads Query Language (GAQL) query, e.g. "SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS". Only SELECT queries are accepted. Rows are returned as Google sends them: camelCase field names, 64-bit numbers as strings, money in micros (millionths of the account currency). Reference: https://developers.google.com/google-ads/api/docs/query/overview

customer_id* string

The Google Ads account (customer) ID, with or without dashes, e.g. "123-456-7890". list_accessible_customers and list_child_accounts return them.

query* string

The GAQL query. Must start with SELECT.

login_customer_id string

Only when this Google login reaches customer_id through a manager (MCC) account: that manager's customer ID, e.g. "111-222-3333".

max_rows integer

Most rows to return (1–10000). Add a LIMIT clause to the query to keep results small. default: 1000

Per-campaign performance for a date range: impressions, clicks, cost, conversions, conversion value, CTR and average CPC, with status and channel type, sorted by cost. Cost and CPC are in the account currency. Dates are in the account's time zone. Give start_date and end_date, or during (default LAST_30_DAYS, not including today).

customer_id* string

The Google Ads account (customer) ID, with or without dashes, e.g. "123-456-7890". list_accessible_customers and list_child_accounts return them.

start_date string

First day, YYYY-MM-DD (inclusive). Use with end_date.

end_date string

Last day, YYYY-MM-DD (inclusive). Use with start_date.

during string

A predefined range, instead of start_date and end_date. LAST_7_DAYS | LAST_30_DAYS | THIS_MONTH | LAST_MONTH

include_removed boolean

Include removed campaigns. default: false

login_customer_id string

Only when this Google login reaches customer_id through a manager (MCC) account: that manager's customer ID, e.g. "111-222-3333".