Fazer chamadas da API Google Ads com a estratégia de mutação

A estratégia de mutação se refere ao uso de AdsApp.mutate para fazer chamadas de API diretamente, em vez de depender de objetos específicos dos scripts do Google Ads. Isso permite que você acesse todos os recursos da API mais rapidamente e tem uma barreira de entrada menor se já estiver familiarizado com a sintaxe da API.

Criar uma campanha Performance Max com mutate

Este guia pressupõe que você cria toda a campanha em uma única solicitação atômica, em vez de criar cada entidade individual em solicitações separadas. Isso significa que você precisará configurar e usar IDs temporários para vincular recursos entre si.

Com isso, crie uma matriz para armazenar todas as operações:

const operations = [];

Você vai precisar do ID do cliente para criar a campanha, já que ele é obrigatório em todos os nomes de recursos.

const customerId = AdsApp.currentAccount().getCustomerId();

Cada vez que você quiser criar uma nova operação, use o próximo ID temporário no nome do recurso para poder fazer referência a esse objeto mais tarde e inserir o objeto criado na matriz:

const newOperation = {
    [OPERATION_TYPE_VARIES]: {
        create: {
            resourceName: `customers/${customerId}/[EXACT_PATH_VARIES]/${getNextTempId()}`
            // Other fields, relevant to the resource being created.
        }
    }
}
operations.push(newOperation);

Leia mais e veja um exemplo de operação na documentação de mutação da API REST do Google Ads. Saiba mais sobre os componentes obrigatórios e opcionais de uma campanha Performance Max e crie operações para suas necessidades.

Depois de criar todas as operações, execute-as em um único lote:

AdsApp.mutateAll(operations);