Google Ads

Pilot MCP sert 66 outils pour Google Ads, tous en lecture. Leur nom commence par google_. Les 113 outils d'écriture du connecteur ne sont pas servis : Pilot MCP est en lecture seule.

Google Ads en lecture : comptes, campagnes et budgets, groupes d'annonces et éléments, mots clés et termes de recherche, audiences et zones, conversions, Shopping, recommandations et tests, et requêtes GAQL.

Ce que dit chaque fiche

Le nom, la description et les paramètres viennent de la liste que le serveur sert à votre assistant (tools/list). Les descriptions sont en anglais : c'est le texte que votre assistant reçoit. Votre assistant n'a pas à remplir les accès à la régie : Pilot les ajoute à chaque appel.

Familles d'outils

Famille	Outils
Audiences et zones	10
Campagnes, budgets et enchères	12
Comptes	7
Conversions	3
Groupes d'annonces, annonces et éléments	12
Mots clés et termes de recherche	8
Recommandations, tests et enchères	5
Requêtes GAQL	6
Shopping et Merchant Center	3

Audiences et zones

`google_get_audience_insights`

Google Ads: Get Audience Insights · lecture · rejouable

Get insights about audience performance and characteristics

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.

`google_get_geographic_performance`

Google Ads: Get Geographic Performance · lecture · rejouable

Get performance by geographic location

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`date_range`	`string`	non	Date range preset: LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_90_DAYS, THIS_MONTH, LAST_MONTH.
`start_date`	`string`	non	Start date YYYY-MM-DD, used if date_range not provided.
`end_date`	`string`	non	End date YYYY-MM-DD, used if date_range not provided.
`campaign_id`	`string`	non	Filter by campaign ID.

`google_get_location_performance`

Google Ads: Get Location Performance · lecture · rejouable

Get geographic performance report showing metrics by location

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`campaign_id`	`string`	non	Optional campaign ID to filter by.
`date_range`	`string`	non	Date range preset: LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_90_DAYS, THIS_MONTH, LAST_MONTH.
`start_date`	`string`	non	Start date (YYYY-MM-DD), used if date_range not provided.
`end_date`	`string`	non	End date (YYYY-MM-DD), used if date_range not provided.

`google_get_user_location_view`

Google Ads: Get User Location View · lecture · rejouable

Get performance data based on actual user locations (where users were physically located when they saw ads)

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`campaign_id`	`string`	non	Optional campaign ID to filter by.
`date_range`	`string`	non	Date range preset: LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_90_DAYS, THIS_MONTH, LAST_MONTH.
`start_date`	`string`	non	Start date (YYYY-MM-DD), used if date_range not provided.
`end_date`	`string`	non	End date (YYYY-MM-DD), used if date_range not provided.

`google_list_ad_group_audience_criteria`

Google Ads: List Ad Group Audience Criteria · lecture · rejouable

List audience targeting criteria for an ad group (remarketing lists, in-market segments, custom audiences, etc.). Use this to see what audiences are currently targeted or excluded.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`ad_group_id`	`string`	oui	Ad group ID. Use list_ad_groups to get it.

`google_list_audiences`

Google Ads: List Audiences · lecture · rejouable

Lists the audiences of a Google Ads account (audience resources) with id, name, description, status and dimensions, removed ones excluded, ordered by ID, up to limit rows (default 100). User lists have their own tool, list_user_lists.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`limit`	`number`	non	Max results. Défaut : `100`.

`google_list_campaign_location_targets`

Google Ads: List Campaign Location Targets · lecture · rejouable

List location targeting criteria for a campaign. If campaign_id is omitted, lists location targets for all campaigns.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`campaign_id`	`string`	non	Campaign ID (optional - omit to list all campaigns).

`google_list_remarketing_actions`

Google Ads: List Remarketing Actions · lecture · rejouable

List all remarketing actions (Google tag snippets) for an account. Returns id, name, tag_snippets, and resource_name.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`limit`	`number`	non	Max results (default 50). Défaut : `50`.

`google_list_user_lists`

Google Ads: List User Lists · lecture · rejouable

List all user lists (audiences) in the account

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`list_type`	`string`	non	Filter by type (CRM_BASED, REMARKETING, etc.).

`google_search_locations`

Google Ads: Search Locations · lecture · rejouable

Search for geographic location IDs by name. Use this to find location criterion IDs for targeting.

Paramètre	Type	Requis	Description
`location_names`	`string[]`	non	List of location names to search for.
`query`	`string`	non	Single location name to search for (alias for location_names[0]).
`customer_id`	`string`	non	Google Ads customer ID (optional, not used for geo constant lookup).
`locale_code`	`string`	non	Language code (e.g., "en_US", "fr_FR"). Défaut : `"en_US"`.

Campagnes, budgets et enchères

`google_get_campaign_performance`

Google Ads: Get Campaign Performance · lecture · rejouable

Get campaign performance metrics over a date range

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`date_range`	`string`	non	Date range preset: LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_90_DAYS, THIS_MONTH, LAST_MONTH.
`start_date`	`string`	non	Start date YYYY-MM-DD (default: 30 days ago), used if date_range not provided.
`end_date`	`string`	non	End date YYYY-MM-DD (default: today), used if date_range not provided.
`campaign_id`	`string`	non	Filter by campaign ID.

`google_list_bidding_data_exclusions`

Google Ads: List Bidding Data Exclusions · lecture · rejouable

List all bidding data exclusions

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.

`google_list_bidding_strategies`

Google Ads: List Bidding Strategies · lecture · rejouable

List all portfolio bidding strategies for an account. Portfolio strategies (Target CPA, Target ROAS, Maximize Conversions) can be shared across campaigns. Use this to discover strategy IDs before assigning to a campaign.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`type_filter`	`string`	non	Filter by strategy type (default: ALL). Valeurs : `"ALL"`, `"TARGET_CPA"`, `"TARGET_ROAS"`, `"MAXIMIZE_CONVERSIONS"`, `"MAXIMIZE_CONVERSION_VALUE"`, `"TARGET_IMPRESSION_SHARE"`, `"ENHANCED_CPC"`. Défaut : `"ALL"`.
`limit`	`number`	non	Max results (default 50). Défaut : `50`.

`google_list_budgets`

Google Ads: List Budgets · lecture · rejouable

List all campaign budgets for an account. Use this to discover budget IDs and resource names before calling create_campaign. The budget resource_name (e.g. customers/123/campaignBudgets/456) is required by create_campaign.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`include_shared`	`boolean`	non	Include explicitly shared budgets (default true). Défaut : `true`.
`limit`	`number`	non	Maximum number of budgets to return (default 50). Défaut : `50`.

`google_list_campaign_bid_modifiers`

Google Ads: List Campaign Bid Modifiers · lecture · rejouable

List bid modifiers for campaigns (call, interaction types). Use this to audit and manage campaign-level bid adjustments.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`campaign_id`	`string`	non	Filter by campaign ID. Leave empty for all campaigns.
`limit`	`number`	non	Max results (default 100). Défaut : `100`.

`google_list_campaign_groups`

Google Ads: List Campaign Groups · lecture · rejouable

List campaign groups for an account.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`limit`	`number`	non	Maximum number of results (default 100). Défaut : `100`.

`google_list_campaign_targeting`

Google Ads: List Campaign Targeting · lecture · rejouable

List campaign targeting criteria. If campaign_id is omitted, lists all campaign criteria for the account.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`campaign_id`	`string`	non	Campaign ID (optional - omit to list all campaigns).
`limit`	`number`	non	Max results. Défaut : `100`.

`google_list_campaigns`

Google Ads: List Campaigns · lecture · rejouable

List all campaigns for an advertiser account. Use this to discover campaign IDs and resource names needed for other tools. Returns id, name, status, channel_type, budget resource_name and amount, start/end dates.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens, e.g. 7863516311).
`status_filter`	`string`	non	Filter by status. Default: ALL (includes enabled and paused). Valeurs : `"ALL"`, `"ENABLED"`, `"PAUSED"`, `"REMOVED"`. Défaut : `"ALL"`.
`limit`	`number`	non	Maximum number of campaigns to return (default 50). Défaut : `50`.

`google_list_labels`

Google Ads: List Labels · lecture · rejouable

List all labels for an account. Use this to discover label IDs and names before applying or removing labels. Returns id, name, status, background_color, and resource_name.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`limit`	`number`	non	Max results (default 100). Défaut : `100`.

`google_list_seasonality_adjustments`

Google Ads: List Seasonality Adjustments · lecture · rejouable

List all seasonality adjustments

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.

`google_simulate_bid_change`

Google Ads: Simulate Bid Change · lecture · rejouable

Simulate the effect of bid changes on a campaign or ad group. Returns projected metrics (clicks, impressions, cost) at different bid levels. Uses Google Ads campaign criterion simulations.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`campaign_id`	`string`	oui	Campaign ID to simulate bid changes for.
`limit`	`number`	non	Maximum number of simulation points (default 20). Défaut : `20`.

`google_simulate_budget_change`

Google Ads: Simulate Budget Change · lecture · rejouable

Simulate the effect of budget changes on a campaign. Returns projected metrics (clicks, impressions, cost, conversions) at different budget levels. Uses Google Ads campaign budget simulations.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`campaign_id`	`string`	oui	Campaign ID to simulate budget changes for.
`limit`	`number`	non	Maximum number of simulation points (default 20). Défaut : `20`.

Comptes

`google_get_account_budget_summary`

Google Ads: Get Account Budget Summary · lecture · rejouable

Get account budget information including approved spending limits and amounts. Returns budget details like status, amount, and spending limits.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`limit`	`number`	non	Maximum number of budgets to return (default 10). Défaut : `10`.

`google_get_account_info`

Google Ads: Get Account Info · lecture · rejouable

Returns detailed information about a Google Ads account including account settings and a performance summary for the last 30 days. Combines account metadata (name, currency, timezone, type) with key metrics (spend, impressions, clicks, conversions). Example: get_account_info(customer_id='1234567890')

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	The Google Ads account ID. Example: '1234567890'.

`google_get_account_spend_today`

Google Ads: Get Account Spend Today · lecture · rejouable

Get the total spend for the account today. Returns cost in micros (divide by 1,000,000 for currency amount). Also includes impressions and clicks for context.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).

`google_get_account_summary`

Google Ads: Get Account Summary · lecture · rejouable

Get account-level summary metrics

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`date_range`	`string`	non	Date range preset: LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_90_DAYS, THIS_MONTH, LAST_MONTH.
`start_date`	`string`	non	Start date YYYY-MM-DD, used if date_range not provided.
`end_date`	`string`	non	End date YYYY-MM-DD, used if date_range not provided.

`google_get_change_history`

Google Ads: Get Change History · lecture · rejouable

Get recent changes made to the Google Ads account. Returns change events showing what was modified, when, and by whom. Useful for auditing account activity.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`limit`	`number`	non	Maximum number of changes to return (default 50). Défaut : `50`.
`change_date_range`	`string`	non	Date range preset: LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS. Défaut : `"LAST_14_DAYS"`.
`resource_type_filter`	`string`	non	Filter by resource type: CAMPAIGN, AD_GROUP, AD, KEYWORD, etc.

`google_get_optimization_score`

Google Ads: Get Optimization Score · lecture · rejouable

Get the account optimization score from Google Ads. Returns a score between 0 and 1 indicating how well the account is optimized.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).

`google_list_accounts`

Google Ads: List Accounts · lecture · rejouable

Lists Google Ads accounts with optimized data fetching. DEFAULT MODE (no parameters): Returns only accessible MCC accounts (manager accounts) with basic info. DETAILED MODE (with manager_customer_id): Returns direct sub-accounts of that specific MCC. Use include_nested=true to recursively fetch nested MCCs and their sub-accounts. Example: list_accounts() → returns MCCs only | list_accounts(manager_customer_id='123456') → returns sub-accounts of MCC 123456

Paramètre	Type	Requis	Description
`manager_customer_id`	`string`	non	If provided, returns sub-accounts of this MCC. If omitted, returns accessible MCC accounts only.
`timeout_seconds`	`number`	non	Timeout in seconds for API calls. Default: 120. Défaut : `120`.
`include_nested`	`boolean`	non	If true and manager_customer_id is provided, recursively includes nested MCCs. Défaut : `false`.
`max_depth`	`number`	non	Maximum recursion depth when include_nested is true. Default: 1 (direct only). Défaut : `1`.
`account_id`	`string`	non	Google Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace.

Conversions

`google_list_conversion_actions`

Google Ads: List Conversion Actions · lecture · rejouable

List all conversion actions for an account. Use this to discover conversion action IDs and resource names before updating or deleting. Returns id, name, type, status, category, and resource_name.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`status_filter`	`string`	non	Filter by status (default: ALL, excludes REMOVED). Valeurs : `"ALL"`, `"ENABLED"`, `"REMOVED"`, `"HIDDEN"`. Défaut : `"ALL"`.
`limit`	`number`	non	Max results (default 50). Défaut : `50`.

`google_list_conversion_actions_detailed`

Google Ads: List Conversion Actions Detailed · lecture · rejouable

List conversion actions with full details including tracking status, counting type, lookback windows, value settings, and attribution model. More detailed than list_conversion_actions.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`status_filter`	`string`	non	Filter by status (default: ALL, excludes REMOVED). Valeurs : `"ALL"`, `"ENABLED"`, `"REMOVED"`, `"HIDDEN"`. Défaut : `"ALL"`.
`limit`	`number`	non	Max results (default 50). Défaut : `50`.

`google_list_conversion_value_rules`

Google Ads: List Conversion Value Rules · lecture · rejouable

List conversion value rules for an account.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`limit`	`number`	non	Maximum number of results (default 100). Défaut : `100`.

Groupes d'annonces, annonces et éléments

`google_get_ad_performance`

Google Ads: Get Ad Performance · lecture · rejouable

Get ad performance metrics

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`date_range`	`string`	non	Date range preset: LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_90_DAYS, THIS_MONTH, LAST_MONTH.
`start_date`	`string`	non	Start date YYYY-MM-DD, used if date_range not provided.
`end_date`	`string`	non	End date YYYY-MM-DD, used if date_range not provided.
`ad_group_id`	`string`	non	Filter by ad group ID.

`google_get_ad_strength`

Google Ads: Get Ad Strength · lecture · rejouable

Get ad strength and policy info for responsive search ads. If ad_id is provided, returns details for that specific ad. Otherwise lists all responsive search ads in the account.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Customer ID.
`ad_id`	`string`	non	Ad ID (optional - lists all RSAs if omitted).

`google_list_ad_group_bid_modifiers`

Google Ads: List Ad Group Bid Modifiers · lecture · rejouable

List bid modifiers for ad groups (device, demographics, preferred content). Returns the modifier value and criterion type for each ad group.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`campaign_id`	`string`	non	Filter by campaign ID (optional).
`ad_group_id`	`string`	non	Filter by ad group ID (optional).
`limit`	`number`	non	Max results (default 100). Défaut : `100`.

`google_list_ad_groups`

Google Ads: List Ad Groups · lecture · rejouable

List all ad groups for an account or a specific campaign. Use this to discover ad group IDs before creating ads or adding keywords. Returns id, name, status, campaign, and resource_name.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`campaign_id`	`string`	non	Filter by campaign ID. Leave empty to list all ad groups across all campaigns.
`status_filter`	`string`	non	Filter by status. Default: ALL (excludes REMOVED). Valeurs : `"ALL"`, `"ENABLED"`, `"PAUSED"`, `"REMOVED"`. Défaut : `"ALL"`.
`limit`	`number`	non	Maximum number of ad groups to return (default 100). Défaut : `100`.

`google_list_ads`

Google Ads: List Ads · lecture · rejouable

List all ads for an account, campaign, or ad group. Use this to discover ad IDs before updating or deleting ads. Returns ad id, type, status, headlines, descriptions, final_urls and ad_group.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`campaign_id`	`string`	non	Filter by campaign ID (optional).
`ad_group_id`	`string`	non	Filter by ad group ID. Use list_ad_groups to get IDs.
`status_filter`	`string`	non	Filter by status. Default: ALL (excludes REMOVED). Valeurs : `"ALL"`, `"ENABLED"`, `"PAUSED"`, `"REMOVED"`. Défaut : `"ALL"`.
`limit`	`number`	non	Maximum number of ads to return (default 50). Défaut : `50`.

`google_list_asset_group_assets`

Google Ads: List Asset Group Assets · lecture · rejouable

Lists assets linked to a Performance Max asset group.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`asset_group_id`	`string`	oui	Asset group ID.
`limit`	`number`	non	Maximum number of assets to return (default 50). Défaut : `50`.

`google_list_asset_groups`

Google Ads: List Asset Groups · lecture · rejouable

Lists Performance Max asset groups for a given campaign.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`campaign_id`	`string`	oui	Performance Max campaign ID.
`limit`	`number`	non	Maximum number of asset groups to return (default 100). Défaut : `100`.

`google_list_assets`

Google Ads: List Assets · lecture · rejouable

List assets (images, text, videos, callouts, sitelinks) for an account. Use this to discover asset IDs and resource names before using them in campaigns or ad groups.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`type_filter`	`string`	non	Filter by asset type (default: ALL). Valeurs : `"ALL"`, `"IMAGE"`, `"TEXT"`, `"YOUTUBE_VIDEO"`, `"MEDIA_BUNDLE"`, `"CALL_TO_ACTION"`, `"SITELINK"`, `"CALLOUT"`, `"STRUCTURED_SNIPPET"`. Défaut : `"ALL"`.
`limit`	`number`	non	Max results (default 50). Défaut : `50`.

`google_list_campaign_assets`

Google Ads: List Campaign Assets · lecture · rejouable

List assets linked to a specific campaign. Returns asset type, field type, and status for each campaign-asset association.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`campaign_id`	`string`	non	Filter by campaign ID. Leave empty to list all.
`limit`	`number`	non	Max results (default 100). Défaut : `100`.

`google_list_extensions`

Google Ads: List Extensions · lecture · rejouable

List all extensions (assets) in an account

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`extension_type`	`string`	non	Filter by type (SITELINK, CALL, CALLOUT, etc.).
`limit`	`number`	non	Max results. Défaut : `100`.

`google_list_feed_items`

Google Ads: List Feed Items · lecture · rejouable

List all items in a feed

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`feed_id`	`string`	non	Feed ID (optional; lists all feed items if omitted).

`google_list_feeds`

Google Ads: List Feeds · lecture · rejouable

List all feeds in the account

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.

Mots clés et termes de recherche

`google_get_keyword_ideas`

Google Ads: Get Keyword Ideas · lecture · rejouable

Generate keyword ideas using Keyword Planner

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Customer ID.
`keyword_texts`	`string[]`	non	Seed keywords (alias: keywords).
`keywords`	`string[]`	non	Alias for keyword_texts.
`url`	`string`	non	Website URL for ideas.
`language_id`	`string`	non	Language ID (1000=English). Défaut : `"1000"`.
`location_ids`	`string[]`	non	Location IDs (e.g., ["2840"] for USA).

`google_get_keyword_performance`

Google Ads: Get Keyword Performance · lecture · rejouable

Get keyword performance metrics

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`date_range`	`string`	non	Date range preset: LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_90_DAYS, THIS_MONTH, LAST_MONTH.
`start_date`	`string`	non	Start date YYYY-MM-DD, used if date_range not provided.
`end_date`	`string`	non	End date YYYY-MM-DD, used if date_range not provided.
`ad_group_id`	`string`	non	Filter by ad group ID.

`google_get_search_terms_report`

Google Ads: Get Search Terms Report · lecture · rejouable

Get search terms report showing actual search queries

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`date_range`	`string`	non	Date range preset: LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_90_DAYS, THIS_MONTH, LAST_MONTH.
`start_date`	`string`	non	Start date YYYY-MM-DD, used if date_range not provided.
`end_date`	`string`	non	End date YYYY-MM-DD, used if date_range not provided.
`campaign_id`	`string`	non	Filter by campaign ID.

`google_list_customer_negative_criteria`

Google Ads: List Customer Negative Criteria · lecture · rejouable

List account-level negative criteria (excluded sites, keywords, placements, apps). These exclusions apply to all campaigns in the account.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`limit`	`number`	non	Max results (default 100). Défaut : `100`.

`google_list_keyword_plans`

Google Ads: List Keyword Plans · lecture · rejouable

List keyword plans for an account.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`limit`	`number`	non	Maximum number of results (default 50). Défaut : `50`.

`google_list_keywords`

Google Ads: List Keywords · lecture · rejouable

List keywords, optionally filtered by ad group

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Customer ID.
`ad_group_id`	`string`	non	Ad group ID to filter by.
`limit`	`number`	non	Maximum number of results. Défaut : `100`.

`google_list_shared_criteria`

Google Ads: List Shared Criteria · lecture · rejouable

List negative keywords/placements in a shared set. Use list_shared_sets to get the shared_set_id first.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`shared_set_id`	`string`	oui	Shared set ID. Use list_shared_sets to get it.
`limit`	`number`	non	Max results (default 100). Défaut : `100`.

`google_list_shared_sets`

Google Ads: List Shared Sets · lecture · rejouable

List all shared sets in the account

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`set_type`	`string`	non	Optional filter by type.

Recommandations, tests et enchères

`google_get_auction_insights`

Google Ads: Get Auction Insights · lecture · rejouable

Google Ads auction insights: the competitor domains in the auctions of Search and Shopping campaigns, per campaign and day, with impression share, overlap rate, outranking share, position above rate, top and absolute top impression percentages. Only Search and Shopping campaigns have them, and Google returns rows only above its privacy thresholds: an empty result comes with a warning naming the likely causes. date_range defaults to LAST_7_DAYS; campaign_ids narrows the campaigns.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID (without hyphens).
`date_range`	`string`	non	Date range preset: LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, YESTERDAY, THIS_MONTH, LAST_MONTH, or 'YYYY-MM-DD,YYYY-MM-DD'. Default: LAST_7_DAYS.
`campaign_ids`	`string[]`	non	Restrict to these campaign IDs (optional).

`google_get_recommendation_impact`

Google Ads: Get Recommendation Impact · lecture · rejouable

Get detailed impact analysis for a specific recommendation

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`recommendation_resource_name`	`string`	oui	Full resource name of the recommendation.

`google_get_recommendations`

Google Ads: Get Recommendations · lecture · rejouable

Get optimization recommendations from Google Ads (KEYWORD, BUDGET, BID, AD, etc.)

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`recommendation_types`	`string[]`	non	Optional list of types to filter by (KEYWORD, BUDGET, BID, AD).
`limit`	`number`	non	Maximum number of results (default: 100, max: 1000). Défaut : `100`.

`google_list_experiment_arms`

Google Ads: List Experiment Arms · lecture · rejouable

List all arms for a specific Google Ads experiment.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Customer ID (without hyphens).
`experiment_resource_name`	`string`	oui	Experiment resource name (e.g., customers/123/experiments/456).
`limit`	`number`	non	Maximum number of arms to return (default 50). Défaut : `50`.

`google_list_experiments`

Google Ads: List Experiments · lecture · rejouable

List all experiments (A/B tests) for a Google Ads customer account.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Customer ID (without hyphens).
`limit`	`number`	non	Maximum number of experiments to return (default 100). Défaut : `100`.

Requêtes GAQL

`google_autocomplete_gaql`

Google Ads: Autocomplete GAQL · lecture · rejouable

Provides autocomplete suggestions for valid GAQL fields for a given resource. Returns all fields that can be selected when querying a specific resource. Example: autocomplete_gaql('campaign') returns all campaign fields, metrics, and segments. Use this to discover what fields are available before building a query.

Paramètre	Type	Requis	Description
`resource_name`	`string`	oui	The Google Ads resource name. Examples: 'campaign', 'ad_group', 'ad_group_criterion'.
`customer_id`	`string`	non	Optional Google Ads customer ID to use for metadata queries.

`google_build_gaql_query`

Google Ads: Build GAQL Query · lecture · rejouable

Builds a safe GAQL query from structured components to avoid syntax errors. Helps LLMs construct valid queries without memorizing GAQL syntax. Example: build_gaql_query(resource='campaign', fields=['campaign.id', 'campaign.name'], filters=[{field: 'campaign.status', op: '=', value: 'ENABLED'}], limit=10) returns a complete, validated GAQL query string ready to use with run_query.

Paramètre	Type	Requis	Description
`resource`	`string`	oui	The Google Ads resource to query. Examples: 'campaign', 'ad_group', 'customer'.
`fields`	`string[]`	oui	List of fields to select. Examples: ['campaign.id', 'campaign.name', 'campaign.status'].
`date_range`	`string`	non	Optional date range filter. Examples: 'LAST_30_DAYS', 'LAST_7_DAYS', '2024-01-01'.
`filters`	`object[]`	non	Optional list of filter conditions. Example: [{field: 'campaign.status', op: '=', value: 'ENABLED'}].
`order_by`	`string`	non	Optional field to order results by. Example: 'campaign.name'.
`limit`	`number`	non	Maximum rows to return. Default: 50, Max: 10000. Défaut : `50`.
`account_id`	`string`	non	Google Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace.

`google_get_resource_metadata`

Google Ads: Get Resource Metadata · lecture · rejouable

Fetches detailed metadata for a Google Ads resource, field, segment, or metric. Useful for understanding what fields exist, which fields can be selected together, and validating GAQL queries. Examples: get_resource_metadata('campaign') returns all campaign fields, get_resource_metadata('metrics.clicks') returns click metric details. Use this to discover available fields when building queries.

Paramètre	Type	Requis	Description
`resource_or_field_name`	`string`	non	The name of the resource or field to query. Examples: 'campaign', 'ad_group', 'campaign.name', 'metrics.clicks'.
`resource_type`	`string`	non	Alias for resource_or_field_name.
`customer_id`	`string`	non	Optional Google Ads customer ID to use for metadata queries.

`google_lint_gaql`

Google Ads: Lint GAQL · lecture · rejouable

Performs strict static analysis and validation of a GAQL query before execution. Catches common errors like missing SELECT/FROM, forbidden actions (UPDATE/DELETE), using SELECT *, missing date filters for metrics, and invalid field names. Example: lint_gaql(query='SELECT campaign.id FROM campaign') returns validation results. Always use this before run_query to catch errors early and save API quota.

Paramètre	Type	Requis	Description
`query`	`string`	oui	The GAQL query to validate. Example: 'SELECT campaign.id, campaign.name FROM campaign'.
`account_id`	`string`	non	Google Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace.

`google_run_query`

Google Ads: Run Query · lecture · rejouable

Executes a GAQL (Google Ads Query Language) query on a Google Ads account. Returns campaign, ad group, keyword, or other Google Ads data based on your query. Example: run_query(customer_id='1234567890', query='SELECT campaign.id, campaign.name FROM campaign WHERE campaign.status = ENABLED LIMIT 10') Always use GAQL syntax: 'SELECT fields FROM resource WHERE conditions LIMIT number'

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	The Google Ads account ID to query. Example: '1234567890'.
`query`	`string`	oui	The GAQL query to execute. Example: 'SELECT campaign.id, campaign.name FROM campaign'.
`limit`	`number`	non	Maximum number of rows to return. Default: 50. Défaut : `50`.
`manager_customer_id`	`string`	non	The main manager (MCC) account ID for authentication. Example: '9876543210'.
`intermediate_manager_customer_id`	`string`	non	The intermediate manager (MCC2) account ID if applicable. For multi-level MCC hierarchies, used as login_customer_id when accessing a client under a sub-MCC.
`timeout_seconds`	`number`	non	Query timeout in seconds. Default: 120. Défaut : `120`.
`skip_validation`	`boolean`	non	If true, skips pre-flight validation (not recommended). Default: false. Défaut : `false`.

`google_validate_query_google`

Google Ads: Validate Query Google · lecture · rejouable

Validates a GAQL query using the Google Ads API without executing it. This performs server-side validation to check if the query is syntactically correct and semantically valid according to Google Ads API rules. Example: validate_query_google(customer_id='1234567890', query='SELECT campaign.id FROM campaign') returns validation status. Use this for final validation before run_query.

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	The Google Ads account ID to validate against. Example: '1234567890'.
`query`	`string`	oui	The GAQL query to validate. Example: 'SELECT campaign.id, campaign.name FROM campaign'.

Shopping et Merchant Center

`google_get_shopping_performance`

Google Ads: Get Shopping Performance · lecture · rejouable

Get Shopping campaign performance report with product-level metrics

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`campaign_id`	`string`	non	Optional campaign ID to filter by.
`start_date`	`string`	non	Start date (YYYY-MM-DD). Défaut : `"2024-01-01"`.
`end_date`	`string`	non	End date (YYYY-MM-DD). Défaut : `"2024-12-31"`.

`google_list_merchant_center_links`

Google Ads: List Merchant Center Links · lecture · rejouable

List all Merchant Center links for an account

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.

`google_list_product_groups`

Google Ads: List Product Groups · lecture · rejouable

List all product groups (listing groups) in an account or ad group

Paramètre	Type	Requis	Description
`customer_id`	`string`	oui	Google Ads customer ID.
`ad_group_id`	`string`	non	Optional ad group ID to filter by.

Familles d'outilsCopier le lien de la section

Audiences et zonesCopier le lien de la section

google_get_audience_insightsCopier le lien de la section

google_get_geographic_performanceCopier le lien de la section

google_get_location_performanceCopier le lien de la section

google_get_user_location_viewCopier le lien de la section

google_list_ad_group_audience_criteriaCopier le lien de la section

google_list_audiencesCopier le lien de la section

google_list_campaign_location_targetsCopier le lien de la section

google_list_remarketing_actionsCopier le lien de la section

google_list_user_listsCopier le lien de la section

google_search_locationsCopier le lien de la section

Campagnes, budgets et enchèresCopier le lien de la section

google_get_campaign_performanceCopier le lien de la section

google_list_bidding_data_exclusionsCopier le lien de la section

google_list_bidding_strategiesCopier le lien de la section

google_list_budgetsCopier le lien de la section

google_list_campaign_bid_modifiersCopier le lien de la section

google_list_campaign_groupsCopier le lien de la section

google_list_campaign_targetingCopier le lien de la section

google_list_campaignsCopier le lien de la section

google_list_labelsCopier le lien de la section

google_list_seasonality_adjustmentsCopier le lien de la section

google_simulate_bid_changeCopier le lien de la section

google_simulate_budget_changeCopier le lien de la section

ComptesCopier le lien de la section

google_get_account_budget_summaryCopier le lien de la section

google_get_account_infoCopier le lien de la section

google_get_account_spend_todayCopier le lien de la section

google_get_account_summaryCopier le lien de la section

google_get_change_historyCopier le lien de la section

google_get_optimization_scoreCopier le lien de la section

google_list_accountsCopier le lien de la section

ConversionsCopier le lien de la section

google_list_conversion_actionsCopier le lien de la section

google_list_conversion_actions_detailedCopier le lien de la section

google_list_conversion_value_rulesCopier le lien de la section

Groupes d'annonces, annonces et élémentsCopier le lien de la section

google_get_ad_performanceCopier le lien de la section

google_get_ad_strengthCopier le lien de la section

google_list_ad_group_bid_modifiersCopier le lien de la section

google_list_ad_groupsCopier le lien de la section

google_list_adsCopier le lien de la section

google_list_asset_group_assetsCopier le lien de la section

google_list_asset_groupsCopier le lien de la section

google_list_assetsCopier le lien de la section

google_list_campaign_assetsCopier le lien de la section

google_list_extensionsCopier le lien de la section

google_list_feed_itemsCopier le lien de la section

google_list_feedsCopier le lien de la section

Mots clés et termes de rechercheCopier le lien de la section

google_get_keyword_ideasCopier le lien de la section

google_get_keyword_performanceCopier le lien de la section

google_get_search_terms_reportCopier le lien de la section

google_list_customer_negative_criteriaCopier le lien de la section

google_list_keyword_plansCopier le lien de la section

google_list_keywordsCopier le lien de la section

google_list_shared_criteriaCopier le lien de la section

google_list_shared_setsCopier le lien de la section

Recommandations, tests et enchèresCopier le lien de la section

google_get_auction_insightsCopier le lien de la section

google_get_recommendation_impactCopier le lien de la section

google_get_recommendationsCopier le lien de la section

google_list_experiment_armsCopier le lien de la section

google_list_experimentsCopier le lien de la section

Requêtes GAQLCopier le lien de la section

google_autocomplete_gaqlCopier le lien de la section

google_build_gaql_queryCopier le lien de la section

google_get_resource_metadataCopier le lien de la section

google_lint_gaqlCopier le lien de la section

google_run_queryCopier le lien de la section

google_validate_query_googleCopier le lien de la section

Shopping et Merchant CenterCopier le lien de la section

google_get_shopping_performanceCopier le lien de la section

google_list_merchant_center_linksCopier le lien de la section

google_list_product_groupsCopier le lien de la section

Sur cette page