제외 키워드 목록
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이름별로 제외 키워드 목록 가져오기
function getNegativeKeywordList(name) {
const negativeKeywordLists = AdsApp.negativeKeywordLists()
.withCondition(`shared_set.name = "${name}"`)
.get();
if (!negativeKeywordLists.hasNext()) {
throw new Error(`Cannot find negative keyword list with name "${name}"`);
}
return negativeKeywordLists.next();
}
제외 키워드 목록을 새로 구성하여 캠페인에 추가
function addNegativeKeywordListToCampaign(campaignName, negativeKeywordListName) {
const negativeKeywordLists = AdsApp.negativeKeywordLists()
.withCondition(`shared_set.name = "${negativeKeywordListName}"`)
.get();
if (!negativeKeywordLists.hasNext()) {
throw new Error(`Cannot find negative keyword list with name "${negativeKeywordListName}"`);
}
const negativeKeywordList = negativeKeywordLists.next();
const campaigns = AdsApp.campaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
if (!campaigns.hasNext()) {
throw new Error(`Cannot find campaign with the name "${campaignName}"`);
}
const campaign = campaigns.next();
campaign.addNegativeKeywordList(negativeKeywordList);
}
제외 키워드 목록에서 공유된 제외 키워드 모두 삭제
function removeAllNegativeKeywordsFromList(name) {
const negativeKeywordLists = AdsApp.negativeKeywordLists()
.withCondition(`shared_set.name = "${name}"`)
.get();
if (!negativeKeywordLists.hasNext()) {
throw new Error(`Cannot find negative keyword list with name "${name}"`);
}
const negativeKeywordList = negativeKeywordLists.next();
for (const negativeKeyword of negativeKeywordList.negativeKeywords()) {
negativeKeyword.remove();
}
}
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-21(UTC)
[null,null,["최종 업데이트: 2025-08-21(UTC)"],[[["\u003cp\u003eThese Google Ads scripts provide functions to manage negative keyword lists, including retrieving a list by name, adding a list to a campaign, and removing all negative keywords from a list.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetNegativeKeywordList\u003c/code\u003e function retrieves an existing negative keyword list using its name and throws an error if not found.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eaddNegativeKeywordListToCampaign\u003c/code\u003e function associates an existing negative keyword list with a specific campaign, also throwing an error if either the list or campaign is not found.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eremoveAllNegativeKeywordsFromList\u003c/code\u003e function removes all negative keywords within a specified negative keyword list, throwing an error if the list is not found.\u003c/p\u003e\n"]]],[],null,["# Negative Keyword Lists\n\nGet a negative keyword list by name\n-----------------------------------\n\n```gdscript\nfunction getNegativeKeywordList(name) {\n const negativeKeywordLists = AdsApp.negativeKeywordLists()\n .withCondition(`shared_set.name = \"${name}\"`)\n .get();\n if (!negativeKeywordLists.hasNext()) {\n throw new Error(`Cannot find negative keyword list with name \"${name}\"`);\n }\n\n return negativeKeywordLists.next();\n}\n```\n\nConstruct a new negative keyword list and add it to a campaign\n--------------------------------------------------------------\n\n```gdscript\nfunction addNegativeKeywordListToCampaign(campaignName, negativeKeywordListName) {\n const negativeKeywordLists = AdsApp.negativeKeywordLists()\n .withCondition(`shared_set.name = \"${negativeKeywordListName}\"`)\n .get();\n if (!negativeKeywordLists.hasNext()) {\n throw new Error(`Cannot find negative keyword list with name \"${negativeKeywordListName}\"`);\n }\n const negativeKeywordList = negativeKeywordLists.next();\n\n const campaigns = AdsApp.campaigns()\n .withCondition(`campaign.name = \"${campaignName}\"`)\n .get();\n if (!campaigns.hasNext()) {\n throw new Error(`Cannot find campaign with the name \"${campaignName}\"`);\n }\n const campaign = campaigns.next();\n campaign.addNegativeKeywordList(negativeKeywordList);\n}\n```\n\nRemove all the shared negative keywords in an negative keyword list\n-------------------------------------------------------------------\n\n```gdscript\nfunction removeAllNegativeKeywordsFromList(name) {\n const negativeKeywordLists = AdsApp.negativeKeywordLists()\n .withCondition(`shared_set.name = \"${name}\"`)\n .get();\n if (!negativeKeywordLists.hasNext()) {\n throw new Error(`Cannot find negative keyword list with name \"${name}\"`);\n }\n const negativeKeywordList = negativeKeywordLists.next();\n\n for (const negativeKeyword of negativeKeywordList.negativeKeywords()) {\n negativeKeyword.remove();\n }\n}\n```"]]