Die meisten Dienste stellen synchrone APIs bereit, bei denen Sie eine Anfrage senden und dann auf eine Antwort warten müssen. BatchJobService bietet jedoch eine Möglichkeit, Batches von Vorgängen für mehrere Dienste auszuführen, ohne synchron auf den Abschluss der Vorgänge warten zu müssen.
Im Gegensatz zu dienstspezifischen Mutate-Vorgängen kann ein einzelner Job in BatchJobService für eine gemischte Sammlung von Kampagnen, Anzeigengruppen, Anzeigen, Kriterien, Labels und Assets ausgeführt werden. Gesendete Jobs werden parallel ausgeführt und BatchJobService wiederholt automatisch Vorgänge, die aufgrund vorübergehender Fehler wie Ratenbegrenzungsfehler fehlschlagen. In der Google Ads API wird jeder Vorgang gemäß der Anleitung zum Zählen von API-Vorgängen auf Ihr tägliches Vorgangslimit angerechnet.
Mit BatchJobService können Sie auch temporäre IDs in Ihren Anfragen verwenden, um abhängige Vorgänge in einem einzigen Job zu senden.
Vorgänge
BatchJobService unterstützt alle in MutateOperation aufgeführten Vorgänge, deren zugrunde liegender Dienst Teilfehler unterstützt, sowie AssetGroupOperation und AssetGroupListingGroupFilterOperation, die explizit ausgenommen und (zusammen mit zugehörigen voneinander abhängigen Vorgängen) in atomaren Unterbatches ausgeführt werden.
Da die Google Ads API Standardvorgänge in einem Job mit aktivierter Teilfehlerbehandlung ausführt (außer innerhalb von atomaren Unterbatches), werden erfolgreiche Vorgänge nicht rückgängig gemacht, wenn ein Job abgebrochen wird oder einzelne Vorgänge fehlschlagen.
Die folgenden Vorgänge in MutateOperation müssen atomar sein und unterstützen keine Teilausfälle. Daher werden sie in Batchjobs nicht unterstützt. Wenn Sie einen dieser Vorgänge einem Batchjob hinzufügen, wird der Fehler MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE (oder InternalError.INTERNAL_ERROR für BookCampaignsOperation und QuoteCampaignsOperation) zurückgegeben. Führen Sie sie stattdessen mit GoogleAdsService.Mutate aus, wobei partial_failure auf false (und validate_only auf true für QuoteCampaignsOperation) festgelegt ist.
Nicht unterstützte Vorgänge in BatchJobService
BookCampaignsOperation(verfügbar inMutateOperation)CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperationQuoteCampaignsOperation(verfügbar inMutateOperation; erfordert, dassvalidate_onlyauftruegesetzt ist)