Effectuer des appels à l'API Google Ads avec la stratégie de mutation

La stratégie de mutation consiste à utiliser AdsApp.mutate pour effectuer des appels d'API directement, plutôt que de s'appuyer sur des objets spécifiques aux scripts Google Ads. Cela vous permet d'accéder plus rapidement à toutes les fonctionnalités de l'API et de réduire les obstacles à l'entrée si vous connaissez déjà la syntaxe de l'API.

Créer une campagne Performance Max avec mutate

Ce guide suppose que vous créez l'intégralité de la campagne dans une seule requête atomique, plutôt que de créer chaque entité individuelle dans des requêtes distinctes. Cela signifie que vous devrez configurer et utiliser des ID temporaires pour associer les ressources entre elles.

Une fois cela fait, créez un tableau pour contenir toutes les opérations :

const operations = [];

Vous aurez souvent besoin du numéro client pour lequel vous créez la campagne, car il est obligatoire dans chaque nom de ressource.

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

Chaque fois que vous souhaitez créer une opération, vous utilisez l'ID temporaire suivant dans le nom de la ressource. Vous pouvez ainsi faire référence à cet objet ultérieurement et insérer l'objet créé dans le tableau :

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

Pour en savoir plus et voir un exemple d'opération, consultez la documentation sur la mutation de l'API REST Google Ads. Découvrez les composants obligatoires et facultatifs d'une campagne Performance Max, et créez les opérations qui répondent à vos besoins.

Une fois que vous avez créé toutes vos opérations, exécutez-les dans un seul lot :

AdsApp.mutateAll(operations);