Problemas comuns

Esta é uma compilação dos problemas mais comuns encontrados no Fórum de scripts do Google Ads.

Erros comuns de JavaScript

O script apresenta a falha "Não foi possível encontrar a função: FUNCTION_NAME"

Geralmente, isso é resultado de um nome de função com erro ortográfico no script.

  1. Verifique se o nome da função está escrito corretamente e tem a ortografia correta. Por exemplo, AdsApp.keywordz() resultará nesse erro, porque keywordz não é uma função válida na classe AdsApp. AdsApp.Keywords() também falhará devido à letra maiúscula incorreta para a função keywords().

  2. Verifique se a função existe; por exemplo, AdsApp.keywords().next() falhará porque AdsApp.keywords() retorna um KeywordSelector, enquanto next() é um método para um objeto KeywordIterator. O código correto seria AdsApp.keywords().get().next().

Meu script é executado, mas não resulta em nenhuma ação

O motivo mais comum para esse problema é que você tem uma função que executa uma operação, mas não a está chamando pelo método main(). Isso geralmente acontece quando você copia e cola snippets de código da nossa documentação.

Abordagem de codificação Snippet de código
Versão 1 (não funciona)
function main() {
  // Call to getAllCampaigns is missing, so this script does nothing.
}

function getAllCampaigns() {
  // AdsApp.campaigns() will return all campaigns that are not
  // removed by default.
  let campaignIterator = AdsApp.campaigns().get();
  console.log('Total campaigns found : ' +
      campaignIterator.totalNumEntities());
  while (campaignIterator.hasNext()) {
    let campaign = campaignIterator.next();
    console.log(campaign.getName());
  }
}
Versão 2 (não funciona)
function main() {
  // Call to getAllCampaigns is missing, so this script does nothing.

  function getAllCampaigns() {
    // AdsApp.campaigns() will return all campaigns that are not
    // removed by default.
    let campaignIterator = AdsApp.campaigns().get();
    console.log('Total campaigns found : ' +
        campaignIterator.totalNumEntities());
    while (campaignIterator.hasNext()) {
      let campaign = campaignIterator.next();
      console.log(campaign.getName());
    }
  }
}
Versão 3 (funciona)
function main() {
  getAllCampaigns();
}

function getAllCampaigns() {
  // AdsApp.campaigns() will return all campaigns that are not removed
  // by default.
  let campaignIterator = AdsApp.campaigns().get();
  console.log('Total campaigns found : ' +
      campaignIterator.totalNumEntities());
  while (campaignIterator.hasNext()) {
    let campaign = campaignIterator.next();
    Logger.log(campaign.getName());
  }
}

Eu recebo um erro "Não é possível encontrar a função getFinalUrl" quando faço upgrade dos meus scripts

Você pode encontrar esse erro ao alterar seu script para funcionar com URLs atualizados. Isso acontece quando você substitui as chamadas para ad.getDestinationUrl() por ad.getFinalUrl(). getFinalUrl() faz parte da classe AdUrls, então você precisa alterar seu código para ad.urls().getFinalUrl():

function main() {
  // Incorrect snippet. getFinalUrl is not a member of the Ad class.
  let ad = AdsApp.ads().get().next();
  let url = ad.getFinalUrl();

  // Correct snippet.
  let ad = AdsApp.ads().get().next();
  let url = ad.urls().getFinalUrl();
}

Eu não vejo estatísticas para X

A indisponibilidade de dados para determinada entidade ou período é um erro comum que você pode encontrar ao gerar relatórios ou fazer chamadas de estatísticas. Há várias coisas que você pode tentar:

  1. Verifique o período para o qual você está recuperando estatísticas ou gerando relatórios.

  2. Se você recuperar estatísticas no nível da conta para um script do Google Ads Manager que gerencia contas com moedas diferentes, receberá o custo na moeda da conta de administrador.

  3. É possível que o Google Ads ainda não tenha os dados que você deseja. Consulte nosso guia de atualização de dados para detalhes.

Solicitações de recursos

O recurso X está disponível?

Confira nossa documentação de referência.

Quando o recurso X estará disponível?

Tentamos trabalhar nos recursos mais solicitados primeiro. Se há um recurso que você gostaria de ver, siga estas etapas:

  1. Primeiro, confira se o recurso é compatível com os scripts do Google Ads consultando a documentação de referência.

  2. Se ele não estiver disponível, pesquise no Fórum de scripts do Google Ads para ver se já existem perguntas sobre ele. Em caso afirmativo, apoie essa conversa ou deixe um comentário se quiser compartilhar outros detalhes, como um caso de uso.

  3. Se o recurso ainda não tiver sido solicitado, solicite-o abrindo uma nova conversa no Fórum de scripts do Google Ads. Forneça um caso de uso que esse recurso resolva. Quando possível, inclua um link para o guia da Central de Ajuda ou um guia / uma postagem do blog da Google AdWords API que descreva o recurso. Isso vai ajudar outros desenvolvedores a votarem em uma solicitação de recurso. Priorizamos solicitações de recursos com base na popularidade.

  4. Marque a postagem como "Solicitação de recurso" para facilitar a verificação rápida das solicitações de recursos para nós (e para os usuários).

Como usar o recurso X?

Consulte nossos snippets de código e soluções para conferir exemplos de como usar um determinado recurso. Se você não encontrar um snippet de código adequado, sinta-se à vontade para fazer uma solicitação no fórum.