Changement

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. Il s'agit du seul moyen de modifier les campagnes sur le Réseau de Recherche à l'aide de scripts Google Ads.

Créer une campagne sur le Réseau de Recherche 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 ressource, 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 sur le Réseau de Recherche, et 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);