Strategia di modifica

Questa guida verrà presentata per creare un analogo esatto delle guide Performance Max esistenti, il che presuppone che creerai l'intera campagna in una singola richiesta atomica, anziché creare ogni entità una alla volta in richieste distinte. Ciò significa che dovrai utilizzare ID temporanei per collegare le risorse tra loro, dato che non conoscerai i nomi completi delle risorse fino a quando non riceverai la risposta dell'API.

Per farlo, dovrai scrivere del codice per assicurarti di non creare ID temporanei duplicati:

let nextId = -1;

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

Ogni chiamata successiva al numero getNextTempId restituirà un numero in meno rispetto a quello precedente. Poiché tutti gli ID temporanei devono essere negativi, inizia da -1.

Con questa impostazione, ora puoi creare un array per contenere tutte le operazioni:

const operations = [];

Spesso avrai bisogno dell'ID cliente per il cliente in cui stai creando la campagna, poiché è obbligatorio in tutti i nomi delle risorse.

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

Ogni volta che vuoi creare una nuova operazione, utilizzerai l'ID temporaneo successivo nel nome della risorsa, in modo da poter fare riferimento a questo oggetto in un secondo momento e inserisci l'oggetto creato nell'array:

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

Per saperne di più e vedere un'operazione di esempio, consulta la documentazione di modifica del REST dell'API Google Ads.

Dopo aver creato tutte le nostre operazioni, eseguile in un singolo batch:

AdsApp.mutateAll(operations);