REST Resource: advertisers.negativeKeywordLists.negativeKeywords

  • A NegativeKeyword resource represents a negatively targeted keyword within a negative keyword list, preventing ads from showing on searches containing that keyword.

  • NegativeKeyword resources have two main fields: name (resource name) and keywordValue (the actual keyword, with restrictions on length, encoding, and characters).

  • Display & Video 360 API provides methods to manage NegativeKeyword resources, including creating, deleting, listing, bulk editing, and replacing them within negative keyword lists.

Resource: NegativeKeyword

A negatively targeted keyword that belongs to a negative keyword list.

JSON representation
{
  "name": string,
  "keywordValue": string
}
Fields
name

string

Output only. The resource name of the negative keyword.

keywordValue

string

Required. Immutable. The negatively targeted keyword, for example car insurance.

Must be UTF-8 encoded with a maximum size of 255 bytes. Maximum number of characters is 80. Maximum number of words is 10.

Valid characters are restricted to ASCII characters only. The only URL-escaping permitted is for representing whitespace between words. Leading or trailing whitespace is ignored.

Methods

bulkEdit

Bulk edits negative keywords in a single negative keyword list.

create

Creates a negative keyword in a negative keyword list.

delete

Deletes a negative keyword from a negative keyword list.

list

Lists negative keywords in a negative keyword list.

replace

Replaces all negative keywords in a single negative keyword list.