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 êtes déjà familiarisé avec la syntaxe de l'API. Il s'agit du seul moyen de modifier les campagnes Demand Gen à l'aide de scripts Google Ads.

Créer une campagne Demand Gen avec mutate

Ce guide suppose que vous créez l'ensemble 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 lier les ressources entre elles.

Une fois cette étape effectuée, créez un tableau pour contenir toutes les opérations :

const operations = [];

Vous aurez souvent besoin de l'ID client du 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 référencer 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 REST de l'API Google Ads. Découvrez les composants obligatoires et facultatifs d'une campagne Demand Gen, et créez des opérations en fonction de vos besoins.

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

AdsApp.mutateAll(operations);