Alors que la plupart des services fournissent des API synchrones, ce qui vous oblige à effectuer 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 à un service, une tâche unique dans BatchJobService peut s'effectuer 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 des 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 d'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 accepte toutes les opérations répertoriées dans MutateOperation, à quelques exceptions importantes.
L'API Google Ads exécute toutes les opérations d'une tâche avec échec partiel activé. Toutefois, les opérations suivantes dans MutateOperation ne sont pas compatibles avec les échecs partiels, car elles doivent être atomiques. Par conséquent, elles ne sont pas compatibles avec les tâches par lot et vous devez éviter de les ajouter à vos tâches.
Si vous devez exécuter l'une de ces opérations, utilisez plutôt la méthode mutate de GoogleAdsService et définissez partial_failure sur false dans vos requêtes.