Lidar com erros e avisos no seu script

A única vez que os Scripts retornam erros é quando você adiciona uma entidade com valores inválidos. Por exemplo, se tentar adicionar uma entidade de palavra-chave com um valor de licitação inválido, a operação de compilação falha e devolve um ou mais erros.

        var operation = adGroup.newKeywordBuilder()
            .withText(keywordText)
            .withCpc(-5)
            .build();

        if (operation.isSuccessful()) {
            var keyword = operation.getResult();
            Logger.log(`Added keyword, ${keyword.getText()}.`);
        }
        else {
            // The bid amount is not valid, so this path executes
            for (var error of operation.getErrors()) {
                Logger.log(error);
            }
        }

No entanto, se você tentar atualizar as propriedades de uma entidade com um valor inválido, Scripts não retornará um erro. Em vez disso, o Scripts grava uma mensagem de erro no Log de Alterações e seu código continua em execução. Por exemplo, o código a seguir tenta definir o lance de CPC do grupo de anúncios. Como o valor não é válido, a chamada falha silenciosamente, o script continua em execução e uma mensagem de erro é gravada no log de alterações.

function main() {
    var adGroup = AdsApp.adGroups().get().next();
    adGroup.bidding().setCpc(-5);
}

Nota

Embora possa sentir-se tentado a chamar getCpc o método depois de definir o respetivo valor para verificar se a atualização obteve êxito, não o faça. Chamar o método get depois de chamar o método set degrada o desempenho ao eliminar o recurso de atualização em lote. Para obter mais informações, consulte Atualizações em lote em práticas recomendadas.

Outros erros, como erros de tempo de execução ou falhas de recuperação de entidade, fazem com que a execução do script pare. Quando isto acontece, a mensagem de erro é gravada no Registo de texto. O código a seguir tenta chamar a função, foo() mas como a função não está definida, o script encerra a execução.

function main() {
    foo(); // The script stops because foo() is undefined and generates a reference error
    Logger.log('This line is never logged!');
}

Deve rever sempre todas as mensagens registadas no registo de alterações e no registo de texto.