Stratégie de mutation

Ce guide est présenté pour élaborer une analogie exacte avec les guides Performance Max existants, qui supposent que vous allez créer l'intégralité de la campagne dans une seule requête atomique, au lieu de créer chaque entité une par une dans des requêtes distinctes. Cela signifie que vous devrez utiliser des ID temporaires pour associer des ressources entre elles, car vous ne connaîtrez pas le nom complet des ressources tant que vous n'aurez pas obtenu la réponse de l'API.

Pour ce faire, vous devez écrire du code pour vous assurer de ne pas créer d'ID temporaires en double:

let nextId = -1;

function getNextTempId() {
    const ret = nextId;
    nextId -= 1;
    return ret;
}

Chaque appel successif de getNextTempId renvoie un chiffre inférieur à la valeur précédente. Comme tous les identifiants temporaires doivent être négatifs, commencer à -1.

Vous pouvez maintenant créer un tableau contenant toutes les opérations:

const operations = [];

Vous aurez fréquemment besoin du numéro 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 opération, vous utiliserez l'ID temporaire suivant dans le nom de la ressource, afin de pouvoir 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 de l'API Google Ads sur la méthode REST mutate.

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

AdsApp.mutateAll(operations);