帳戶標籤

建立帳戶標籤

function createAccountLabels(labelName) {
  AdsManagerApp.createAccountLabel(labelName);
  console.log("Label with text = '%s' created.", labelName);
}

將帳戶標籤套用至多個帳戶

function applyAccountLabels(accountId1, accountId2, labelName) {
  // You can modify this function to accept an array of IDs directly as well.
  const accountIds = [accountId1, accountId2];

  const accounts = AdsManagerApp.accounts().withIds(accountIds).get();
  for (const account of accounts) {
    account.applyLabel(labelName);

    console.log('Label with text = "%s" applied to customer id %s.',
               labelName, account.getCustomerId());
  }
}

移除多個帳戶中的帳戶標籤

function removeLabelFromAccounts(accountId1, accountId2, labelName) {
  const accountIds = [accountId1, accountId2];

  var accounts = AdsManagerApp.accounts().withIds(accountIds).get();
  for (const account of accounts) {
    account.removeLabel(labelName);

    console.log('Label with text = "%s" removed from customer id %s.',
               labelName, account.getCustomerId());
  }
}

按標籤名稱選取帳戶

function selectAccountsByLabelName(labelName) {
  const accountIterator = AdsManagerApp.accounts()
      .withCondition(`LabelNames CONTAINS '${labelName}'`)
      .get();

  for (const account of accountIterator) {
    const accountName = account.getName() ? account.getName() : '--';
    console.log('%s,%s,%s,%s', account.getCustomerId(), accountName,
        account.getTimeZone(), account.getCurrencyCode());
  }
}

按標籤 ID 選取帳戶

function selectAccountsByLabelId(labelId) {
  const label = AdsManagerApp.accountLabels().withIds([labelId]).get().next();
  const accountIterator = label.accounts().get();

  for (const account of accountIterator) {
    const accountName = account.getName() ? account.getName() : '--';
    console.log('%s,%s,%s,%s', account.getCustomerId(), accountName,
        account.getTimeZone(), account.getCurrencyCode());
  }
}

擷取所有帳戶標籤

function getAllAccountLabels() {
  const labelIterator = AdsManagerApp.accountLabels().get();
  for (const label of labelIterator) {
    console.log('Label with id = %s and text = %s was found.',
               label.getId().toFixed(0), label.getName());
  }
}

按名稱擷取帳戶標籤

function getLabelByName(labelName) {
  const labelIterator = AdsManagerApp.accountLabels()
      .withCondition(`label.name CONTAINS '${labelName}'`)
      .get();

  for (const label of labelIterator) {
    console.log(`Label with id = ${label.getId().toFixed(0)} ` +
        `and text = ${label.getName()} was found.`);
  }
}

按 ID 擷取帳戶標籤

function getLabelById(labelId) {
  const labelIterator = AdsManagerApp.accountLabels()
      .withIds([labelId])
      .get();

  for (const label of labelIterator) {
    console.log("Label with id = %s and text = '%s' was found.",
               label.getId().toFixed(0), label.getName());
  }
}