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 de scripts do Google Ads. Isso permite que você acesse todos os recursos da API mais rapidamente e tem uma barreira de entrada menor se você já estiver familiarizado com a sintaxe da API.

Criar uma campanha Performance Max com mutação

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 uns aos outros.

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

const operations = [];

Com frequência, você precisará do ID do cliente para o cliente em que está criando a campanha, já que ele é obrigatório em todos os nomes de recursos.

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

Sempre que quiser criar um novo recurso, 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 confira um exemplo de operação na documentação de mutação da API REST do Google Ads. Saiba mais sobre os obrigatórios e opcionais componentes 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);