Labels

  • This script provides functions to manage labels in Google Ads, allowing retrieval of all labels or a specific label by name.

  • It demonstrates how to apply and remove labels from campaigns, with similar functionality for other Google Ads object types.

  • The script also includes a function to delete a label entirely from the user's Google Ads account.

  • Included are example functions that show how to get information like a label's description, color, and the number of entities it's applied to.

Get all labels from a user's account

function getAllLabels() {
  const labelIterator = AdsApp.labels().get();
  console.log(`Total labels found: ${labelIterator.totalNumEntities()}`);
  return labelIterator;
}

Get a label by name

function getLabelByName(name) {
  const labelIterator = AdsApp.labels()
      .withCondition(`label.name = "${name}"`)
      .get();
  if (labelIterator.hasNext()) {
    const label = labelIterator.next();
    console.log(`Name: ${label.getName()}`);
    console.log(`Description: ${label.getDescription()}`);
    console.log(`Color: ${label.getColor()}`);
    console.log(`Number of campaigns: ${label.campaigns().get().totalNumEntities()}`);
    console.log(`Number of ad groups: ${label.adGroups().get().totalNumEntities()}`);
    console.log(`Number of ads: ${label.ads().get().totalNumEntities()}`);
    console.log(`Number of keywords: ${label.keywords().get().totalNumEntities()}`);
    return label;
  }
  return null;
}

Apply a label to a campaign

function applyLabel(labelName, campaignName) {
  // Retrieve a campaign, and apply a label to it. Applying labels to other
  // object types is similar.
  const campaignIterator = AdsApp.campaigns()
      .withCondition(`campaign.name = "${campaignName}"`)
      .get();
  if (campaignIterator.hasNext()) {
    const campaign = campaignIterator.next();
    campaign.applyLabel(labelName);
  }
}

Remove a label from a campaign

function removeLabel(labelName, campaignName) {
   // Removing labels from other object types is similar.
   const campaignIterator = AdsApp.campaigns()
       .withCondition(`campaign.name = "${campaignName}"`)
       .get();
  if (campaignIterator.hasNext()) {
    const campaign = campaignIterator.next();
    campaign.removeLabel(labelName);
  }
}

Delete a label from the user's account

function deleteLabel(labelName) {
  const labelIterator = AdsApp.labels()
      .withCondition(`label.name = "${labelName}"`)
      .get();
  if (labelIterator.hasNext()) {
    const label = labelIterator.next();
    label.remove();
  }
}