Alors que la plupart des services fournissent des API synchrones, ce qui vous oblige à envoyer une requête, puis à attendre une réponse, BatchJobService
permet d'effectuer des lots d'opérations sur plusieurs services sans attendre de manière synchrone que les opérations se terminent.
Contrairement aux opérations mutate spécifiques au service, une seule tâche dans BatchJobService
peut être exécutée sur un ensemble mixte de campagnes, de groupes d'annonces, d'annonces, de critères, de libellés et d'éléments de flux.
Les tâches envoyées s'exécutent en parallèle, et BatchJobService
relance automatiquement les opérations qui échouent en raison d'erreurs temporaires telles que les erreurs de limite de débit. L'API Google Ads comptabilise toujours chaque opération dans votre limite d'opérations quotidiennes, en suivant les instructions de comptabilisation des opérations de l'API.
De plus, BatchJobService
vous permet d'utiliser des ID temporaires dans vos requêtes afin d'envoyer des opérations dépendantes dans une seule tâche.
Opérations
BatchJobService
est compatible avec toutes les opérations répertoriées dans MutateOperation
, à quelques exceptions près.
Étant donné que l'API Google Ads exécute toutes les opérations d'une tâche avec l'échec partiel activé, si une tâche est annulée ou si des opérations individuelles échouent, les opérations réussies ne seront pas annulées.
Les opérations suivantes dans MutateOperation
doivent être atomiques. Par conséquent, elles ne sont pas compatibles avec les échecs partiels et ne sont pas acceptées dans les tâches par lot. Évitez de les ajouter à vos tâches, définissez partial_failure
sur false
dans vos requêtes et utilisez plutôt la méthode mutate
dans GoogleAdsService
.
Opérations non compatibles dans BatchJobService
AssetGroupOperation
CampaignConversionGoalOperation
ConversionGoalCampaignConfigOperation
CustomConversionGoalOperation
CustomerConversionGoalOperation
CustomerOperation