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 d'abaisser la barrière d'entrée si vous connaissez déjà la syntaxe de l'API.

Créer une campagne Performance Max avec mutate

Ce guide part du principe 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 devez configurer et utiliser des ID temporaires pour associer les ressources entre elles.

Ensuite, créez un tableau pour stocker toutes les opérations :

const operations = [];

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

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

Chaque fois que vous souhaitez créer une ressource, vous utilisez l'ID temporaire suivant dans le nom de la ressource, afin de pouvoir référencer cet objet ultérieurement, et vous insérez 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 méthode mutate de l'API REST Google Ads. Découvrez les composants obligatoires et facultatifs d'une campagne Performance Max, puis créez des opérations en fonction de vos besoins.

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

AdsApp.mutateAll(operations);