Negative Keywords

  • Functions are provided to add negative keywords to both campaigns and ad groups.

  • Functions are also available to retrieve negative keywords associated with campaigns and ad groups.

  • Error handling is included in the functions to address cases where specified campaigns or ad groups are not found.

  • Warnings are logged if multiple ad groups with the same name are found when adding or getting negative keywords for an ad group.

Add negative keyword to a campaign

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}'`);
  }
}

Get negative keywords in a campaign

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}'`);
  }
}

Add a negative keyword to an ad group

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);
}

Get negative keywords in an ad group

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;
  }
}