Excluded Locations

AI-generated Key Takeaways

• This script demonstrates how to add or retrieve excluded locations for Google Ads campaigns using the Google Ads scripts.

• excludeTennessee function adds Tennessee as an excluded location for a specific campaign by its name.

• getExcludedLocations function retrieves and returns all excluded locations for a given campaign.

• Both functions utilize campaign iterators to locate the target campaign and leverage campaign targeting methods to manage excluded locations.

Add excluded locations for a campaign

function excludeTennessee(campaignName) {
  const campaignIterator = AdsApp.campaigns()
      .withCondition(`campaign.name = "${campaignName}"`)
      .get();
  if (!campaignIterator.hasNext()) {
    throw new Error(`No campaign with name "${campaignName}" found`);
  }

  const campaign = campaignIterator.next();
  // Exclude Tennessee, United States (location id = 21175) See
  // https://developers.google.com/google-ads/api/reference/data/geotargets
  // for list of all supported geo codes.
  // You could pass either the location code, or a TargetedLocation or
  // ExcludedLocation object from an existing campaign.
  const tennesseeId = 21175;
  campaign.excludeLocation(tennesseeId);
}

Get excluded locations for a campaign

function getExcludedLocations(campaignName) {
  const campaignIterator = AdsApp.campaigns()
      .withCondition(`campaign.name = "${campaignName}"`)
      .get();
  if (!campaignIterator.hasNext()) {
    throw new Error(`No campaign with name "${campaignName}" found`);
  }

  const campaign = campaignIterator.next();
  return campaign.targeting().excludedLocations().get();
}