Estratégia de modificação

Este guia será apresentado para criar um análogo exato aos guias Performance Max existentes, que pressupõem que você vai criar a campanha inteira em uma única solicitação atômica, em vez de criar cada entidade uma por vez em solicitações separadas. Isso significa que você precisará usar IDs temporários para vincular recursos uns aos outros, já que não saberá os nomes completos dos recursos até receber a resposta da API.

Para fazer isso, você precisa escrever um código para garantir que não crie IDs temporários duplicados:

let nextId = -1;

function getNextTempId() {
    const ret = nextId;
    nextId -= 1;
    return ret;
}

Cada chamada sucessiva para getNextTempId vai retornar um número menor que o anterior. Como todos os IDs temporários precisam ser negativos, comece em -1.

Com isso, agora você pode criar uma matriz para armazenar todas as operações:

const operations = [];

Você vai precisar com frequência do ID do cliente para o cliente em que você está fazendo a campanha, já que ele é necessário em todos os nomes de recursos.

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

Sempre que você quiser criar uma nova operação, use o próximo ID temporário no nome do recurso para fazer referência a 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);

Leia mais e confira um exemplo de operação na documentação de mutação REST da API Google Ads.

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

AdsApp.mutateAll(operations);