Starting
September 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our
deprecations page for more details on how to update your integration to make this declaration.
REST Resource: advertisers.negativeKeywordLists
Stay organized with collections
Save and categorize content based on your preferences.
Resource: NegativeKeywordList
A list of negative keywords used for targeting.
| JSON representation |
{
"name": string,
"negativeKeywordListId": string,
"displayName": string,
"advertiserId": string,
"targetedLineItemCount": string
} |
| Fields |
name |
string
Output only. The resource name of the negative keyword list.
|
negativeKeywordListId |
string (int64 format)
Output only. The unique ID of the negative keyword list. Assigned by the system.
|
displayName |
string
Required. The display name of the negative keyword list. Must be UTF-8 encoded with a maximum size of 255 bytes.
|
advertiserId |
string (int64 format)
Output only. The unique ID of the advertiser the negative keyword list belongs to.
|
targetedLineItemCount |
string (int64 format)
Output only. Number of line items that are directly targeting this negative keyword list.
|
Methods |
|
|
Creates a new negative keyword list. |
|
|
Deletes a negative keyword list given an advertiser ID and a negative keyword list ID. |
|
|
Gets a negative keyword list given an advertiser ID and a negative keyword list ID. |
|
|
Lists negative keyword lists based on a given advertiser id. |
|
|
Updates a negative keyword list. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-27 UTC.
[null,null,["Last updated 2025-03-27 UTC."],[],["The Display & Video 360 API v4 beta includes a `NegativeKeywordList` resource for targeting. This resource represents a list of negative keywords and contains fields like `name`, `negativeKeywordListId`, `displayName`, `advertiserId`, and `targetedLineItemCount`. Available actions include creating, deleting, getting, listing, and updating (`patch`) negative keyword lists. These methods require an advertiser ID and, in some cases, a negative keyword list ID to manage the lists.\n"],null,["# REST Resource: advertisers.negativeKeywordLists\n\n- [Resource: NegativeKeywordList](#NegativeKeywordList)\n - [JSON representation](#NegativeKeywordList.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: NegativeKeywordList\n-----------------------------\n\nA list of negative keywords used for targeting.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"negativeKeywordListId\": string, \"displayName\": string, \"advertiserId\": string, \"targetedLineItemCount\": string } ``` |\n\n| Fields ||\n|-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The resource name of the negative keyword list. |\n| `negativeKeywordListId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The unique ID of the negative keyword list. Assigned by the system. |\n| `displayName` | `string` Required. The display name of the negative keyword list. Must be UTF-8 encoded with a maximum size of 255 bytes. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The unique ID of the advertiser the negative keyword list belongs to. |\n| `targetedLineItemCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. Number of line items that are directly targeting this negative keyword list. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------|\n| ### [create](/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists/create) | Creates a new negative keyword list. |\n| ### [delete](/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists/delete) | Deletes a negative keyword list given an advertiser ID and a negative keyword list ID. |\n| ### [get](/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists/get) | Gets a negative keyword list given an advertiser ID and a negative keyword list ID. |\n| ### [list](/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists/list) | Lists negative keyword lists based on a given advertiser id. |\n| ### [patch](/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists/patch) | Updates a negative keyword list. |"]]
