תוויות חשבון
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
צור תווית חשבון
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());
}
}
בחר חשבון לפי מזהה התווית
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.`);
}
}
אחזר תוויות חשבון לפי המזהים שלהן
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());
}
}
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-21 (שעון UTC).
[null,null,["עדכון אחרון: 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```"]]