Effettuare chiamate API Google Ads con la strategia mutate

La strategia di modifica si riferisce all'utilizzo di AdsApp.mutate per effettuare chiamate API direttamente, anziché fare affidamento su oggetti specifici degli script Google Ads. In questo modo, puoi accedere più rapidamente a tutte le funzionalità dell'API e la barriera di accesso è più bassa se hai già familiarità con la sintassi dell'API.

Crea una campagna Performance Max con mutate

Questa guida presuppone che tu crei l'intera campagna in un'unica richiesta atomica, anziché creare ogni singola entità in richieste separate. Ciò significa che dovrai configurare e utilizzare ID temporanei per collegare le risorse tra loro.

A questo punto, crea un array per contenere tutte le operazioni:

const operations = [];

Spesso avrai bisogno dell'ID cliente per il cliente per cui stai creando la campagna, poiché è obbligatorio in ogni nome della risorsa.

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

Ogni volta che vuoi creare una nuova risorsa, utilizzerai l'ID temporaneo successivo nel nome della risorsa, in modo da poter fare riferimento a questo oggetto in un secondo momento e inserire 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 visualizzare un'operazione di esempio, consulta la documentazione sulla modifica REST dell'API Google Ads. Scopri i componenti obbligatori e facoltativi di una campagna Performance Max e crea operazioni in base alle tue esigenze.

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

AdsApp.mutateAll(operations);