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
| Family | Tools |
|---|---|
| Other tools | 9 |
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.
| Parameter | Type | Required | Description |
|---|---|---|---|
customer_id | string | yes | SA360 customer ID (without dashes). |
campaign_id | string | yes | ID of the campaign to get. |
during | string | no | SA360QL period for the metrics. Default: "LAST_30_DAYS". |
login_customer_id | string | no | login-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.
| Parameter | Type | Required | Description |
|---|---|---|---|
customer_id | string | yes | SA360 customer ID (without dashes). |
entity | string | no | FROM entity on which to aggregate the metrics. Values: "campaign", "ad_group", "customer". Default: "campaign". |
metrics | string[] | no | List of metrics (without the metrics. prefix), e.g. ['clicks','impressions','cost_micros','conversions']. |
during | string | no | SA360QL period (e.g. LAST_30_DAYS, THIS_MONTH). Default: "LAST_30_DAYS". |
login_customer_id | string | no | login-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.%'".
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | yes | Metadata query (SELECT attributes [WHERE ...]). The FROM is implicit (search_ads_360_field). |
page_size | number | no | Maximum number of fields per page. |
page_token | string | no | Pagination token. |
account_id | string | no | Search 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
customer_id | string | yes | SA360 customer ID (without dashes). |
campaign_id | string | no | Optional filter: return only the ad groups of this campaign. |
during | string | no | SA360QL period. Default: "LAST_30_DAYS". |
limit | number | no | Maximum number of ad groups (LIMIT). |
login_customer_id | string | no | login-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.
| Parameter | Type | Required | Description |
|---|---|---|---|
customer_id | string | yes | SA360 customer ID (without dashes). |
during | string | no | SA360QL period for the metrics (e.g. LAST_30_DAYS, LAST_7_DAYS). Default: "LAST_30_DAYS". |
limit | number | no | Maximum number of campaigns (LIMIT clause). |
login_customer_id | string | no | login-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.
| Parameter | Type | Required | Description |
|---|---|---|---|
customer_id | string | yes | SA360 customer ID (without dashes). |
limit | number | no | Maximum number of actions (LIMIT). |
login_customer_id | string | no | login-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.
| Parameter | Type | Required | Description |
|---|---|---|---|
account_id | string | no | Search 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'.
| Parameter | Type | Required | Description |
|---|---|---|---|
customer_id | string | yes | ID of the SA360 customer queried (without dashes). |
query | string | yes | SA360QL query (SELECT ... FROM ... WHERE ... DURING ...). |
page_size | number | no | Maximum number of rows per page. |
page_token | string | no | Pagination token (next_page_token). |
login_customer_id | string | no | Manager 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).
| Parameter | Type | Required | Description |
|---|---|---|---|
kind | string | yes | Type of operation to validate: 'query' (SA360QL) or 'conversion' (insert/update payload). Values: "query", "conversion". |
query | string | no | The SA360QL query to validate (if kind='query'). |
conversion | object | no | The conversion payload to validate (if kind='conversion'). |
operation | string | no | For kind='conversion': the intended operation (insert or update). Values: "insert", "update". Default: "insert". |
account_id | string | no | Search 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. |