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);