제외 키워드
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
캠페인에 제외 키워드 추가
function addNegativeKeywordToCampaign(keyword, campaignName) {
const campaignIterator = AdsApp.campaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
if (campaignIterator.hasNext()) {
const campaign = campaignIterator.next();
campaign.createNegativeKeyword(keyword);
} else {
throw new Error(`Cannot find campaign with the name '${campaignName}'`);
}
}
캠페인에서 제외 키워드 가져오기
function getNegativeKeywordsForCampaign(campaignName) {
const campaignIterator = AdsApp.campaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
if (campaignIterator.hasNext()) {
const campaign = campaignIterator.next();
const negativeKeywordIterator = campaign.negativeKeywords().get();
console.log(`Found ${negativeKeywordIterator.totalNumEntities()} negative keywords.`);
return negativeKeywordIterator;
} else {
throw new Error(`Cannot find campaign with the name '${campaignName}'`);
}
}
광고그룹에 제외 키워드 추가
function addNegativeKeywordToAdGroup(keyword, adGroupName) {
const adGroupIterator = AdsApp.adGroups()
.withCondition(`ad_group.name = "${adGroupName}"`)
.get();
if (!adGroupIterator.hasNext()) {
throw new Error(`Cannot find ad group with the name '${adGroupName}'`);
}
if (adGroupIterator.totalNumEntities() > 1) {
console.warn(`Found more than one ad group named '${adGroupName}', using the first one.`);
}
const adGroup = adGroupIterator.next();
adGroup.createNegativeKeyword(keyword);
}
광고그룹에 있는 제외 키워드 가져오기
function getNegativeKeywordsForAdGroup(adGroupName) {
const adGroupIterator = AdsApp.adGroups()
.withCondition(`ad_group.name = "${adGroupName}"`)
.get();
if (!adGroupIterator.hasNext()) {
throw new Error(`Cannot find ad group with the name '${adGroupName}'`);
}
if (adGroupIterator.totalNumEntities() > 1) {
console.warn(`Found more than one ad group named '${adGroupName}', using the first one.`);
}
const adGroup = adGroupIterator.next();
const negativeKeywordIterator = adGroup.negativeKeywords().get();
if (negativeKeywordIterator.hasNext()) {
const negativeKeyword = negativeKeywordIterator.next();
console.log(`Found ${negativeKeywordIterator.totalNumEntities()} negative keywords.`);
return negativeKeywordIterator;
}
}
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-21(UTC)
[null,null,["최종 업데이트: 2025-08-21(UTC)"],[[["\u003cp\u003eThis documentation provides Google Ads scripts for managing negative keywords at both the campaign and ad group levels.\u003c/p\u003e\n"],["\u003cp\u003eIt includes functions to add negative keywords and retrieve existing negative keywords for campaigns or ad groups using their respective names.\u003c/p\u003e\n"],["\u003cp\u003eWhen searching for ad groups by name, if multiple ad groups share the same name, the script will use the first one it encounters and issue a warning.\u003c/p\u003e\n"],["\u003cp\u003eThese functions are built upon the Google Ads Scripts API, utilizing methods like \u003ccode\u003ecreateNegativeKeyword\u003c/code\u003e and iterators to interact with campaign and ad group entities.\u003c/p\u003e\n"],["\u003cp\u003eError handling is incorporated to notify users if the specified campaign or ad group is not found.\u003c/p\u003e\n"]]],[],null,["# Negative Keywords\n\nAdd negative keyword to a campaign\n----------------------------------\n\n```gdscript\nfunction addNegativeKeywordToCampaign(keyword, campaignName) {\n const campaignIterator = AdsApp.campaigns()\n .withCondition(`campaign.name = \"${campaignName}\"`)\n .get();\n if (campaignIterator.hasNext()) {\n const campaign = campaignIterator.next();\n campaign.createNegativeKeyword(keyword);\n } else {\n throw new Error(`Cannot find campaign with the name '${campaignName}'`);\n }\n}\n```\n\nGet negative keywords in a campaign\n-----------------------------------\n\n```gdscript\nfunction getNegativeKeywordsForCampaign(campaignName) {\n const campaignIterator = AdsApp.campaigns()\n .withCondition(`campaign.name = \"${campaignName}\"`)\n .get();\n if (campaignIterator.hasNext()) {\n const campaign = campaignIterator.next();\n const negativeKeywordIterator = campaign.negativeKeywords().get();\n console.log(`Found ${negativeKeywordIterator.totalNumEntities()} negative keywords.`);\n return negativeKeywordIterator;\n } else {\n throw new Error(`Cannot find campaign with the name '${campaignName}'`);\n }\n}\n```\n\nAdd a negative keyword to an ad group\n-------------------------------------\n\n```gdscript\nfunction addNegativeKeywordToAdGroup(keyword, adGroupName) {\n const adGroupIterator = AdsApp.adGroups()\n .withCondition(`ad_group.name = \"${adGroupName}\"`)\n .get();\n if (!adGroupIterator.hasNext()) {\n throw new Error(`Cannot find ad group with the name '${adGroupName}'`);\n }\n if (adGroupIterator.totalNumEntities() \u003e 1) {\n console.warn(`Found more than one ad group named '${adGroupName}', using the first one.`);\n }\n const adGroup = adGroupIterator.next();\n adGroup.createNegativeKeyword(keyword);\n}\n```\n\nGet negative keywords in an ad group\n------------------------------------\n\n```gdscript\nfunction getNegativeKeywordsForAdGroup(adGroupName) {\n const adGroupIterator = AdsApp.adGroups()\n .withCondition(`ad_group.name = \"${adGroupName}\"`)\n .get();\n if (!adGroupIterator.hasNext()) {\n throw new Error(`Cannot find ad group with the name '${adGroupName}'`);\n }\n if (adGroupIterator.totalNumEntities() \u003e 1) {\n console.warn(`Found more than one ad group named '${adGroupName}', using the first one.`);\n }\n const adGroup = adGroupIterator.next();\n const negativeKeywordIterator = adGroup.negativeKeywords().get();\n if (negativeKeywordIterator.hasNext()) {\n const negativeKeyword = negativeKeywordIterator.next();\n console.log(`Found ${negativeKeywordIterator.totalNumEntities()} negative keywords.`);\n return negativeKeywordIterator;\n }\n}\n```"]]