С 8 сентября 2025 года в каждой новой позиции необходимо будет указывать, будет ли она показывать политическую рекламу Европейского союза (ЕС). Загрузки через Display & Video 360 API и SDF без таких указаний будут отклонены. Подробнее о том, как обновить интеграцию и указать это указание, см. на странице «Устаревшие функции».
Ключевое слово с негативным таргетингом, входящее в список минус-слов.
JSON-представление
{"name": string,"keywordValue": string}
Поля
name
string
Только вывод. Имя ресурса минус-слова.
keywordValue
string
Необходимый. Неизменяемый. Ключевое слово с минус-таргетингом, например car insurance .
Должен быть в кодировке UTF-8 с максимальным размером 255 байт. Максимальное количество символов — 80. Максимальное количество слов — 10.
Допустимые символы ограничены только символами ASCII. Единственное разрешенное экранирование URL-адресов — это представление пробелов между словами. Ведущие или конечные пробелы игнорируются.
[null,null,["Последнее обновление: 2025-07-24 UTC."],[[["\u003cp\u003eA \u003ccode\u003eNegativeKeyword\u003c/code\u003e resource represents a negatively targeted keyword within a negative keyword list, preventing ads from showing on searches containing that keyword.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eNegativeKeyword\u003c/code\u003e resources have two main fields: \u003ccode\u003ename\u003c/code\u003e (resource name) and \u003ccode\u003ekeywordValue\u003c/code\u003e (the actual keyword, with restrictions on length, encoding, and characters).\u003c/p\u003e\n"],["\u003cp\u003eDisplay & Video 360 API provides methods to manage \u003ccode\u003eNegativeKeyword\u003c/code\u003e resources, including creating, deleting, listing, bulk editing, and replacing them within negative keyword lists.\u003c/p\u003e\n"]]],["Negative keywords are used for negative targeting within a list. They are represented in JSON with a `name` and a required `keywordValue` string. `keywordValue` must be UTF-8 encoded, under 255 bytes, 80 characters, and 10 words, using only ASCII characters. Actions include creating, deleting, and listing individual negative keywords. Bulk editing and replacing all keywords in a list are also possible. The `name` field is output-only, while `keywordValue` is immutable.\n"],null,["# REST Resource: advertisers.negativeKeywordLists.negativeKeywords\n\n| Display \\& Video 360 API is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\n- [Resource: NegativeKeyword](#NegativeKeyword)\n - [JSON representation](#NegativeKeyword.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: NegativeKeyword\n-------------------------\n\nA negatively targeted keyword that belongs to a negative keyword list.\n\n| JSON representation |\n|----------------------------------------------------|\n| ``` { \"name\": string, \"keywordValue\": string } ``` |\n\n| Fields ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The resource name of the negative keyword. |\n| `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. |\n\n| Methods ------- ||\n|-----------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------|\n| ### [bulkEdit](/display-video/api/reference/rest/v3/advertisers.negativeKeywordLists.negativeKeywords/bulkEdit) | Bulk edits negative keywords in a single negative keyword list. |\n| ### [create](/display-video/api/reference/rest/v3/advertisers.negativeKeywordLists.negativeKeywords/create) | Creates a negative keyword in a negative keyword list. |\n| ### [delete](/display-video/api/reference/rest/v3/advertisers.negativeKeywordLists.negativeKeywords/delete) | Deletes a negative keyword from a negative keyword list. |\n| ### [list](/display-video/api/reference/rest/v3/advertisers.negativeKeywordLists.negativeKeywords/list) | Lists negative keywords in a negative keyword list. |\n| ### [replace](/display-video/api/reference/rest/v3/advertisers.negativeKeywordLists.negativeKeywords/replace) | Replaces all negative keywords in a single negative keyword list. |"]]