Alors que la plupart des services fournissent des API synchrones qui vous obligent à envoyer une requête et à attendre une réponse, BatchJobService vous permet d'effectuer des lots d'opérations sur plusieurs services sans attendre de manière synchrone la fin des opérations.
Contrairement aux opérations de mutation spécifiques à un service, un seul job dans BatchJobService peut fonctionner sur une collection mixte de campagnes, de groupes d'annonces, d'annonces, de critères, de libellés et de composants. Les jobs envoyés s'exécutent en parallèle, et BatchJobService réessaie automatiquement les opérations qui échouent en raison d'erreurs temporaires telles que les erreurs de limitation du 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.
BatchJobService vous permet également d'utiliser des ID temporaires dans vos requêtes afin de pouvoir envoyer des opérations dépendantes dans un seul job.
Opérations
BatchJobService est compatible avec toutes les opérations listées dans MutateOperation dont le service sous-jacent est compatible avec l'échec partiel, ainsi qu'avec AssetGroupOperation et AssetGroupListingGroupFilterOperation, qui sont explicitement exemptées et exécutées (avec les opérations interdépendantes associées) dans des sous-lots atomiques.
Étant donné que l'API Google Ads exécute des opérations standards dans un job avec l'option Échec partiel activée (sauf dans les sous-lots atomiques), si un job est annulé ou si des opérations individuelles échouent, les opérations qui ont réussi ne sont pas annulées.
Les opérations suivantes dans MutateOperation doivent être atomiques et ne sont pas compatibles avec les échecs partiels. Elles ne sont donc pas acceptées dans les jobs par lot. L'ajout de l'une de ces opérations à un job par lot renvoie une erreur MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE (ou InternalError.INTERNAL_ERROR pour BookCampaignsOperation et QuoteCampaignsOperation). Exécutez-les plutôt à l'aide de GoogleAdsService.Mutate avec partial_failure défini sur false (et validate_only défini sur true pour QuoteCampaignsOperation).
Opérations non acceptées dans BatchJobService
BookCampaignsOperation(disponible dansMutateOperationà partir de la version 23)CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperationQuoteCampaignsOperation(disponible dansMutateOperationà partir de la version 23 ; nécessite quevalidate_onlysoit défini surtrue)