Page Summary
-
Learn how to create, apply, and remove account labels using Google Ads scripts.
-
Discover methods for selecting accounts based on label name or ID.
-
Understand how to retrieve all account labels or specific labels by name or ID.
Create an account label
function createAccountLabels(labelName) {
AdsManagerApp.createAccountLabel(labelName);
console.log("Label with text = '%s' created.", labelName);
}
Apply an account label to multiple accounts
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 ()); } }
Remove an account label from multiple accounts
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 ()); } }
Select an account by label name
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 ()); } }
Select an account by label 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 ()); } }
Retrieve all account labels
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 ()); } }
Retrieve an account label by its name
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 . ` ); } }
Retrieve account labels by their IDs
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 ()); } }
