2025년 9월 8일부터 모든 새 광고 항목은 유럽연합 (EU) 정치 광고를 게재할지 여부를 선언해야 합니다. 선언을 제공하지 않는 Display & Video 360 API 및 SDF 업로드는 실패합니다. 통합을 업데이트하여 이 선언을 하는 방법에 대한 자세한 내용은
지원 중단 페이지를 참고하세요.
REST Resource: advertisers.negativeKeywordLists.negativeKeywords
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: NegativeKeyword
제외 키워드 목록에 속하며 제외 타겟팅되는 키워드입니다.
| JSON 표현 |
{
"name": string,
"keywordValue": string
} |
| 필드 |
name |
string
출력 전용입니다. 제외 키워드의 리소스 이름입니다.
|
keywordValue |
string
필수 항목입니다. 변경할 수 없습니다. 제외 타겟팅 키워드(예: car insurance) UTF-8로 인코딩되어야 하며 최대 크기는 255바이트여야 합니다. 최대 문자 수는 80자(영문 기준)입니다. 최대 단어 수는 10개입니다. 유효한 문자는 ASCII 문자로만 제한됩니다. 단어 사이의 공백을 나타내는 경우에만 URL 이스케이프가 허용됩니다. 선행 또는 후행 공백은 무시됩니다.
|
메서드 |
|
|
단일 제외 키워드 목록에서 제외 키워드를 일괄 수정합니다. |
|
|
제외 키워드 목록에 제외 키워드를 만듭니다. |
|
|
제외 키워드 목록에서 제외 키워드를 삭제합니다. |
|
|
제외 키워드 목록에 제외 키워드를 표시합니다. |
|
|
단일 제외 키워드 목록의 모든 제외 키워드를 대체합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(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. |"]]
