Stratégie de mutation

Ce guide vous aidera à créer un équivalent exact des guides Performance Max existants, qui supposent que vous allez créer l'intégralité de la campagne dans une seule requête atomique, plutôt que 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 les noms complets des ressources tant que vous n'aurez pas reçu la réponse de l'API.

Pour ce faire, vous devrez é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 à getNextTempId renvoie un nombre inférieur de un au précédent. Étant donné que tous les ID temporaires doivent être négatifs, commencez par -1.

Vous pouvez maintenant créer un tableau pour contenir 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 obligatoire dans chaque nom de ressource.

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

Chaque fois que vous souhaitez créer une opération, vous utiliserez le prochain ID temporaire dans le nom de la ressource afin de pouvoir référencer cet objet plus tard et d'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 consulter un exemple d'opération, consultez la documentation sur la mutation REST de l'API Google Ads.

Une fois que vous avez construit toutes nos opérations, exécutez-les en une seule série:

AdsApp.mutateAll(operations);