PilotMCP
Platforms and tools

Search Ads 360

The 9 read-only tools Pilot MCP serves for Search Ads 360, taken from the server.

Pilot MCP serves 9 tools for Search Ads 360, all read-only, on every plan. Their names start with search_ads_360_. The connector has no tool that writes.

What each entry shows

The name, description and parameters come from the list the server serves to your assistant (tools/list). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.

Tool families

FamilyTools
Other tools9

Other tools

search_ads_360_get_campaign

Search Ads 360: Get Campaign · read-only · idempotent

Gets one specific SA360 campaign by its ID (Reporting API v0, FROM campaign WHERE campaign.id=X). Read-only.

ParameterTypeRequiredDescription
customer_idstringyesSA360 customer ID (without dashes).
campaign_idstringyesID of the campaign to get.
duringstringnoSA360QL period for the metrics. Default: "LAST_30_DAYS".
login_customer_idstringnologin-customer-id header (manager access).

search_ads_360_get_metrics

Search Ads 360: Get Metrics · read-only · idempotent

Gets SA360 metrics (metrics.*) for a given entity and period (Reporting API v0). Read-only. Builds a GAQL query from the entity, the requested metrics and the period.

ParameterTypeRequiredDescription
customer_idstringyesSA360 customer ID (without dashes).
entitystringnoFROM entity on which to aggregate the metrics. Values: "campaign", "ad_group", "customer". Default: "campaign".
metricsstring[]noList of metrics (without the metrics. prefix), e.g. ['clicks','impressions','cost_micros','conversions'].
duringstringnoSA360QL period (e.g. LAST_30_DAYS, THIS_MONTH). Default: "LAST_30_DAYS".
login_customer_idstringnologin-customer-id header (manager access).

search_ads_360_get_search_fields

Search Ads 360: Get Search Fields · read-only · idempotent

Queries the metadata of the SA360 fields (searchAds360Fields.search): name, category, data type, whether selectable, whether filterable. Useful to build valid SA360QL queries. Example query: "SELECT name, category, data_type, selectable, filterable WHERE name LIKE 'campaign.%'".

ParameterTypeRequiredDescription
querystringyesMetadata query (SELECT attributes [WHERE ...]). The FROM is implicit (search_ads_360_field).
page_sizenumbernoMaximum number of fields per page.
page_tokenstringnoPagination token.
account_idstringnoSearch Ads 360 account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace.

search_ads_360_list_ad_groups

Search Ads 360: List Ad Groups · read-only · idempotent

Lists the ad groups of an SA360 customer (Reporting API v0, FROM ad_group). Read-only.

ParameterTypeRequiredDescription
customer_idstringyesSA360 customer ID (without dashes).
campaign_idstringnoOptional filter: return only the ad groups of this campaign.
duringstringnoSA360QL period. Default: "LAST_30_DAYS".
limitnumbernoMaximum number of ad groups (LIMIT).
login_customer_idstringnologin-customer-id header (manager access).

search_ads_360_list_campaigns

Search Ads 360: List Campaigns · read-only · idempotent

Lists the campaigns of an SA360 customer (Reporting API v0, query FROM campaign). Read-only.

ParameterTypeRequiredDescription
customer_idstringyesSA360 customer ID (without dashes).
duringstringnoSA360QL period for the metrics (e.g. LAST_30_DAYS, LAST_7_DAYS). Default: "LAST_30_DAYS".
limitnumbernoMaximum number of campaigns (LIMIT clause).
login_customer_idstringnologin-customer-id header (manager access).

search_ads_360_list_conversion_actions

Search Ads 360: List Conversion Actions · read-only · idempotent

Lists the conversion actions (Floodlight) of an SA360 customer (Reporting API v0, FROM conversion_action). Read-only.

ParameterTypeRequiredDescription
customer_idstringyesSA360 customer ID (without dashes).
limitnumbernoMaximum number of actions (LIMIT).
login_customer_idstringnologin-customer-id header (manager access).

search_ads_360_list_customers

Search Ads 360: List Customers · read-only · idempotent

Lists the Search Ads 360 accounts (customers) accessible with the current credentials (Reporting API v0, listAccessibleCustomers). Read-only.

ParameterTypeRequiredDescription
account_idstringnoSearch Ads 360 account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace.

search_ads_360_search_report

Search Ads 360: Search Report · read-only · idempotent

Runs a free-form SA360QL query (GAQL model) on an SA360 customer via the Reporting API v0 (customers.searchAds360.search). Read-only. Example query: 'SELECT campaign.id, campaign.name, metrics.clicks, metrics.cost_micros FROM campaign DURING LAST_30_DAYS'.

ParameterTypeRequiredDescription
customer_idstringyesID of the SA360 customer queried (without dashes).
querystringyesSA360QL query (SELECT ... FROM ... WHERE ... DURING ...).
page_sizenumbernoMaximum number of rows per page.
page_tokenstringnoPagination token (next_page_token).
login_customer_idstringnoManager account ID (login-customer-id header), when access goes through a manager.

search_ads_360_validate_operation

Search Ads 360: Validate Operation · read-only · idempotent

Validates on the client side (no network call) an SA360QL query OR a conversion payload before running it. Reminds that the Reporting API v0 is read-only and that only conversions are writable (legacy API v2).

ParameterTypeRequiredDescription
kindstringyesType of operation to validate: 'query' (SA360QL) or 'conversion' (insert/update payload). Values: "query", "conversion".
querystringnoThe SA360QL query to validate (if kind='query').
conversionobjectnoThe conversion payload to validate (if kind='conversion').
operationstringnoFor kind='conversion': the intended operation (insert or update). Values: "insert", "update". Default: "insert".
account_idstringnoSearch Ads 360 account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace.

On this page