排除關鍵字
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
為廣告活動新增排除關鍵字
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;
}
}
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-21 (世界標準時間)。
[null,null,["上次更新時間:2025-08-21 (世界標準時間)。"],[[["\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```"]]