# Search Ads 360

Source: https://pilot.braike.com/en/docs/regies/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.

<Callout title="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.
</Callout>

## Tool families [#familles]

| Family | Tools |
| --- | ---: |
| [Other tools](#autres) | 9 |

## Other tools [#autres]

### `search_ads_360_get_campaign` [#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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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. |
