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 tem o benefício de permitir 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 mutate

Este guia pressupõe que você cria a campanha inteira 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 de cliente para quem 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 referenciar esse objeto mais tarde e insira 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);

Para saber mais e conferir um exemplo de operação, consulte a documentação de mutação REST da API Google Ads. Aprenda 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);