Rótulos
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.
Recuperar todos os rótulos da conta de um usuário
function getAllLabels() { const labelIterator = AdsApp.labels().get(); console.log(`Total labels found: ${labelIterator.totalNumEntities()}`); return labelIterator; }
Recuperar um rótulo pelo nome
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; }
Aplicar um rótulo a uma campanha
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); } }
Remover um rótulo de uma campanha
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); } }
Excluir um rótulo da conta do usuário
function deleteLabel(labelName) { const labelIterator = AdsApp.labels() .withCondition(`label.name = "${labelName}"`) .get(); if (labelIterator.hasNext()) { const label = labelIterator.next(); label.remove(); } }
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-21 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-21 UTC."],[[["\u003cp\u003eThis script provides functions to manage labels in Google Ads, allowing retrieval of all labels or a specific label by name.\u003c/p\u003e\n"],["\u003cp\u003eIt demonstrates how to apply and remove labels from campaigns, with similar functionality for other Google Ads object types.\u003c/p\u003e\n"],["\u003cp\u003eThe script also includes a function to delete a label entirely from the user's Google Ads account.\u003c/p\u003e\n"],["\u003cp\u003eIncluded are example functions that show how to get information like a label's description, color, and the number of entities it's applied to.\u003c/p\u003e\n"]]],[],null,["# Labels\n\nGet all labels from a user's account\n------------------------------------\n\n```gdscript\nfunction getAllLabels() {\n const labelIterator = AdsApp.labels().get();\n console.log(`Total labels found: ${labelIterator.totalNumEntities()}`);\n return labelIterator;\n}\n```\n\nGet a label by name\n-------------------\n\n```gdscript\nfunction getLabelByName(name) {\n const labelIterator = AdsApp.labels()\n .withCondition(`label.name = \"${name}\"`)\n .get();\n if (labelIterator.hasNext()) {\n const label = labelIterator.next();\n console.log(`Name: ${label.getName()}`);\n console.log(`Description: ${label.getDescription()}`);\n console.log(`Color: ${label.getColor()}`);\n console.log(`Number of campaigns: ${label.campaigns().get().totalNumEntities()}`);\n console.log(`Number of ad groups: ${label.adGroups().get().totalNumEntities()}`);\n console.log(`Number of ads: ${label.ads().get().totalNumEntities()}`);\n console.log(`Number of keywords: ${label.keywords().get().totalNumEntities()}`);\n return label;\n }\n return null;\n}\n```\n\nApply a label to a campaign\n---------------------------\n\n```gdscript\nfunction applyLabel(labelName, campaignName) {\n // Retrieve a campaign, and apply a label to it. Applying labels to other\n // object types is similar.\n const campaignIterator = AdsApp.campaigns()\n .withCondition(`campaign.name = \"${campaignName}\"`)\n .get();\n if (campaignIterator.hasNext()) {\n const campaign = campaignIterator.next();\n campaign.applyLabel(labelName);\n }\n}\n```\n\nRemove a label from a campaign\n------------------------------\n\n```gdscript\nfunction removeLabel(labelName, campaignName) {\n // Removing labels from other object types is similar.\n const campaignIterator = AdsApp.campaigns()\n .withCondition(`campaign.name = \"${campaignName}\"`)\n .get();\n if (campaignIterator.hasNext()) {\n const campaign = campaignIterator.next();\n campaign.removeLabel(labelName);\n }\n}\n```\n\nDelete a label from the user's account\n--------------------------------------\n\n```gdscript\nfunction deleteLabel(labelName) {\n const labelIterator = AdsApp.labels()\n .withCondition(`label.name = \"${labelName}\"`)\n .get();\n if (labelIterator.hasNext()) {\n const label = labelIterator.next();\n label.remove();\n }\n}\n```"]]