帐号标签
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
创建一个账号标签
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());
}
}
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-21。
[null,null,["最后更新时间 (UTC):2025-08-21。"],[[["\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```"]]