Le traitement par lot permet de distribuer un ensemble d'opérations, qui peuvent être interdépendantes, à plusieurs services sans attendre la fin des opérations de manière synchrone. Vous pouvez utiliser le traitement par lot pour créer et gérer des campagnes Performance Max.
Ce guide fournit des informations spécifiques aux campagnes Performance Max utilisant le traitement par lot. Le guide générique sur le traitement par lot fournit des informations générales sur le traitement par lot, tandis que le guide des requêtes de structure contient des informations détaillées sur la création de requêtes pour créer ou gérer des campagnes Performance Max.
Pour créer une campagne Performance Max à l'aide du traitement par lot, procédez comme suit:
Créer un job par lot
Suivez l'étape générale de création d'une tâche de traitement par lot pour créer une ressource BatchJob.
Préparer une liste des opérations mutate
Les campagnes Performance Max nécessitent des opérations pour créer plusieurs ressources associées, qui sont détaillées dans le guide sur les requêtes de structure. Créez un objet MutateOperation pour chaque ressource à inclure dans la tâche par lot.
Exigences concernant AssetGroupOperation et AssetGroupAssetOperation
Les opérations de type MutateOperation qui créent des ressources AssetGroup et AssetGroupAsset dans une tâche par lot doivent être séquentielles, sans aucune autre opération intermédiaire, en raison de la manière dont ces opérations sont regroupées lors de leur traitement. Sinon, la requête génère une erreur AssetGroupError indiquant qu'il manque certains éléments, même si les opérations requises pour respecter les exigences minimales concernant les éléments sont incluses ultérieurement dans la liste des opérations.
AssetGroupListingGroupFilterOperation : bonnes pratiques
Lorsque vous utilisez des filtres de groupes de listes dans le contexte d'une AssetGroupListingGroupFilter, nous vous recommandons d'ajouter les opérations AssetGroupListingGroupFilterOperation ciblant la même AssetGroup à une tâche par lot de manière consécutive, afin que l'ensemble d'opérations soit traité de manière atomique lors du fractionnement par lot. Pour en savoir plus sur le fractionnement par lot et sur les autres facteurs affectant les groupes de fiches, consultez le guide de traitement par lot des groupes de fiches.
Ajouter les opérations mutate au job
Ajoutez les opérations mutate de l'étape 2 à une liste et appelez AddBatchJobOperations pour ajouter la liste des mutations à la tâche par lot créée à l'étape 1.
Suivez l'étape d'ajout d'opérations du guide général sur le traitement par lot pour ajouter la liste des opérations mutate.
Exécuter le job par lot
Autorisez l'exécution des tâches importées en appelant RunBatchJob. Consultez l'étape Exécuter la tâche par lot du guide général sur le traitement par lot pour obtenir un exemple.
Récupérer l'état du job
Les jobs par lot démarrent sous la forme d'opérations de longue durée et prennent généralement un certain temps pour se terminer.
Après avoir démarré la tâche, utilisez la méthode GetOperation de l'opération de longue durée pour interroger l'état de la tâche jusqu'à ce qu'elle soit terminée.
Une fois toutes vos tâches par lot terminées, appelez ListBatchJobResults pour imprimer leurs états et leurs réponses en suivant l'étape permettant de répertorier tous les résultats des tâches par lot du guide général de traitement par lot.