Find keywords blocked by negatives
find_negative_conflictsRead-onlyIdempotent
Lists positive keywords that cannot serve because a negative keyword blocks them, and which negative (level account, shared_list, campaign or ad_group, plus its id and text). Exact and phrase use the same matching as ADM's optimizer. Broad blocks a keyword when every word of the negative appears as a whole word. Close variants are not detected. Pass negatives and/or keywords to also check words you have not added yet. A hypothetical keyword needs a campaign_id (the tool's campaign_id is used when the item omits it); ad-group negatives apply to it only when it has an ad_group_id. With campaign_id, only that campaign's keywords are checked; account negatives still apply. Paginated via cursor. Keyword text is third-party data.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Page size, 1-200. Default 50. | |
| cursor | No | Opaque next_cursor from the previous page. Keep the other arguments identical. | |
| keywords | No | Hypothetical positive keywords. Each is {text, campaign_id, ad_group_id}. Max 50. | |
| negatives | No | Hypothetical negatives, not yet in the account. Each is {text, match_type: EXACT/PHRASE/BROAD, level: account/campaign/ad_group, campaign_id, ad_group_id}. Max 50. | |
| campaign_id | No | Optional campaign id (from get_campaigns) to limit results to one campaign. | |
| customer_id | Yes | Google Ads customer ID from get_accounts, e.g. 123-456-7890. |