Sign in
Ad Campaigns

Replace campaign-level negative keywords

Replaces the FULL set of campaign-level negative keywords (C.270): the desired list is diffed against what Google already has, and the difference is applied as one create/remove mutate. Send an empty array to clear every campaign negative.

The platform is always discovered from the campaign itself; a non-Google campaign returns 501 rather than 404, whether or not platform was sent.

put/v1/ads/campaigns/{campaignId}/negative-keywords

Path parameters

campaignIdstring required

Platform campaign ID

Request body

platform'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai'

Optional and NOT authoritative: the resolved campaign's own platform decides 200 vs 501, never this hint.

Response

Campaign-level negative keywords replaced

createdinteger

Negative criteria newly created on Google

removedinteger

Negative criteria removed from Google

Changes

Changed in 4 of the 55 revisions of this API.8

  • 2c04683ce6944See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 3e6ddf2a99ea1See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

  • 0dba7d004d752See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

  • d7a8fa118ef01See the full diff
    • ○

      endpoint added

      endpoint-added