Page Summary
-
Learn how to retrieve all labels associated with a user's account.
-
Discover how to find a specific label by its name.
-
Understand the process of applying a label to a campaign and similar object types.
-
See how to remove a label from a campaign and other object types.
-
Find out how to delete a label entirely from the user's account.
Get all labels from a user's account
function getAllLabels () { const labelIterator = AdsApp . labels () . get (); console . log ( ` Total labels found : $ { labelIterator . totalNumEntities ()} ` ); return labelIterator ; }
Get a label by name
function getLabelByName ( name ) { const labelIterator = AdsApp . labels () . withCondition ( ` label . name = "${name}" ` ) . get (); if ( labelIterator . hasNext ()) { const label = labelIterator . next (); console . log ( ` Name : $ { label . getName ()} ` ); console . log ( ` Description : $ { label . getDescription ()} ` ); console . log ( ` Color : $ { label . getColor ()} ` ); console . log ( ` Number of campaigns : $ { label . campaigns () . get () . totalNumEntities ()} ` ); console . log ( ` Number of ad groups : $ { label . adGroups () . get () . totalNumEntities ()} ` ); console . log ( ` Number of ads : $ { label . ads () . get () . totalNumEntities ()} ` ); console . log ( ` Number of keywords : $ { label . keywords () . get () . totalNumEntities ()} ` ); return label ; } return null ; }
Apply a label to a campaign
function applyLabel ( labelName , campaignName ) { // Retrieve a campaign , and apply a label to it . Applying labels to other // object types is similar . const campaignIterator = AdsApp . campaigns () . withCondition ( ` campaign . name = "${campaignName}" ` ) . get (); if ( campaignIterator . hasNext ()) { const campaign = campaignIterator . next (); campaign . applyLabel ( labelName ); } }
Remove a label from a campaign
function removeLabel ( labelName , campaignName ) { // Removing labels from other object types is similar . const campaignIterator = AdsApp . campaigns () . withCondition ( ` campaign . name = "${campaignName}" ` ) . get (); if ( campaignIterator . hasNext ()) { const campaign = campaignIterator . next (); campaign . removeLabel ( labelName ); } }
Delete a label from the user's account
function deleteLabel ( labelName ) { const labelIterator = AdsApp . labels () . withCondition ( ` label . name = "${labelName}" ` ) . get (); if ( labelIterator . hasNext ()) { const label = labelIterator . next (); label . remove (); } }
