Etiquetas de la cuenta
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Crear una etiqueta de cuenta
function createAccountLabels(labelName) {
AdsManagerApp.createAccountLabel(labelName);
console.log("Label with text = '%s' created.", labelName);
}
Aplicar una etiqueta de cuenta a varias cuentas
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());
}
}
Quitar una etiqueta de cuenta de varias cuentas
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());
}
}
Seleccionar una cuenta según el nombre de etiqueta
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());
}
}
Seleccionar una cuenta según el ID de etiqueta
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());
}
}
Recuperar todas las etiquetas de cuenta
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());
}
}
Recuperar la etiqueta de una cuenta según el nombre
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.`);
}
}
Recuperar las etiquetas de la cuenta según los 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());
}
}
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-21 (UTC)
[null,null,["Última actualización: 2025-08-21 (UTC)"],[[["\u003cp\u003eThis script provides functions for managing account labels in Google Ads Manager, including creating, applying, and removing labels from accounts.\u003c/p\u003e\n"],["\u003cp\u003eYou can use it to select specific accounts based on label names or IDs for targeted management.\u003c/p\u003e\n"],["\u003cp\u003eThe script enables retrieving information about all existing account labels or specific labels by name or ID.\u003c/p\u003e\n"],["\u003cp\u003eThese functionalities streamline account organization and reporting within your Google Ads Manager hierarchy.\u003c/p\u003e\n"],["\u003cp\u003eProvided examples demonstrate how to perform these tasks with simple, clear, and well-documented code snippets.\u003c/p\u003e\n"]]],[],null,["# Account Labels\n\nCreate an account label\n-----------------------\n\n```text\nfunction createAccountLabels(labelName) {\n AdsManagerApp.createAccountLabel(labelName);\n console.log(\"Label with text = '%s' created.\", labelName);\n}\n```\n\nApply an account label to multiple accounts\n-------------------------------------------\n\n```gdscript\nfunction applyAccountLabels(accountId1, accountId2, labelName) {\n // You can modify this function to accept an array of IDs directly as well.\n const accountIds = [accountId1, accountId2];\n\n const accounts = AdsManagerApp.accounts().withIds(accountIds).get();\n for (const account of accounts) {\n account.applyLabel(labelName);\n\n console.log('Label with text = \"%s\" applied to customer id %s.',\n labelName, account.getCustomerId());\n }\n}\n```\n\nRemove an account label from multiple accounts\n----------------------------------------------\n\n```gdscript\nfunction removeLabelFromAccounts(accountId1, accountId2, labelName) {\n const accountIds = [accountId1, accountId2];\n\n var accounts = AdsManagerApp.accounts().withIds(accountIds).get();\n for (const account of accounts) {\n account.removeLabel(labelName);\n\n console.log('Label with text = \"%s\" removed from customer id %s.',\n labelName, account.getCustomerId());\n }\n}\n```\n\nSelect an account by label name\n-------------------------------\n\n```gdscript\nfunction selectAccountsByLabelName(labelName) {\n const accountIterator = AdsManagerApp.accounts()\n .withCondition(`LabelNames CONTAINS '${labelName}'`)\n .get();\n\n for (const account of accountIterator) {\n const accountName = account.getName() ? account.getName() : '--';\n console.log('%s,%s,%s,%s', account.getCustomerId(), accountName,\n account.getTimeZone(), account.getCurrencyCode());\n }\n}\n```\n\nSelect an account by label ID\n-----------------------------\n\n```transact-sql\nfunction selectAccountsByLabelId(labelId) {\n const label = AdsManagerApp.accountLabels().withIds([labelId]).get().next();\n const accountIterator = label.accounts().get();\n\n for (const account of accountIterator) {\n const accountName = account.getName() ? account.getName() : '--';\n console.log('%s,%s,%s,%s', account.getCustomerId(), accountName,\n account.getTimeZone(), account.getCurrencyCode());\n }\n}\n```\n\nRetrieve all account labels\n---------------------------\n\n```gdscript\nfunction getAllAccountLabels() {\n const labelIterator = AdsManagerApp.accountLabels().get();\n for (const label of labelIterator) {\n console.log('Label with id = %s and text = %s was found.',\n label.getId().toFixed(0), label.getName());\n }\n}\n```\n\nRetrieve an account label by its name\n-------------------------------------\n\n```gdscript\nfunction getLabelByName(labelName) {\n const labelIterator = AdsManagerApp.accountLabels()\n .withCondition(`label.name CONTAINS '${labelName}'`)\n .get();\n\n for (const label of labelIterator) {\n console.log(`Label with id = ${label.getId().toFixed(0)} ` +\n `and text = ${label.getName()} was found.`);\n }\n}\n```\n\nRetrieve account labels by their IDs\n------------------------------------\n\n```transact-sql\nfunction getLabelById(labelId) {\n const labelIterator = AdsManagerApp.accountLabels()\n .withIds([labelId])\n .get();\n\n for (const label of labelIterator) {\n console.log(\"Label with id = %s and text = '%s' was found.\",\n label.getId().toFixed(0), label.getName());\n }\n}\n```"]]