Effettuare chiamate API Google Ads con la strategia mutate

La strategia di mutazione 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 all'ingresso è inferiore se hai già familiarità con la sintassi dell'API.

Creare 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.

Con questa impostazione, crea 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é è richiesto in ogni nome risorsa.

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

Puoi leggere di più e vedere un'operazione di esempio nella documentazione relativa al metodo mutate REST dell'API Google Ads. Scopri i componenti obbligatori e facoltativi di una campagna Performance Max e crea operazioni in base alle tue esigenze.

Una volta create tutte le operazioni, eseguile in un unico batch:

AdsApp.mutateAll(operations);