Bien que la plupart des services fournissent des API synchrones, ce qui vous oblige à envoyer une requête, puis à attendre une réponse, BatchJobService vous permet d'effectuer des lots d'opérations sur plusieurs services sans attendre la fin des opérations.
Contrairement aux opérations mutate spécifiques au service, une seule tâche de BatchJobService peut s'exécuter sur un ensemble mixte de campagnes, de groupes d'annonces, d'annonces, de critères, d'étiquettes 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 des erreurs de limitation du débit. L'API Google Ads compte toujours chaque opération dans votre limite d'opérations quotidiennes en suivant les instructions de comptabilisation des opérations 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 échec partiel activé, si une tâche est annulée ou que 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 défaillances partielles et ne sont pas compatibles avec 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.