Die meisten Dienste stellen synchrone APIs bereit, bei denen Sie eine Anfrage stellen und dann auf eine Antwort warten müssen. Mit BatchJobService
können Sie Vorgänge in Batches für mehrere Dienste ausführen, ohne synchron auf den Abschluss der Vorgänge warten zu müssen.
Im Gegensatz zu dienstspezifischen Änderungsvorgängen kann ein einzelner Auftrag in BatchJobService
für eine Sammlung von Kampagnen, Anzeigengruppen, Anzeigen, Kriterien, Labels und Feedelementen ausgeführt werden.
Gesendete Jobs werden parallel ausgeführt. BatchJobService
wiederholt automatisch Vorgänge, die aufgrund von vorübergehenden Fehlern wie Ratenbegrenzungsfehlern fehlschlagen. In der Google Ads API werden die einzelnen Vorgänge dennoch auf das tägliche Vorgangslimit angerechnet. Folgen Sie dazu der Anleitung unter API-Vorgänge.
Außerdem können Sie mit BatchJobService
temporäre IDs in Anfragen verwenden und so abhängige Vorgänge in einem einzelnen Job senden.
Operations
BatchJobService
unterstützt alle in MutateOperation
aufgeführten Vorgänge, mit einigen wichtigen Ausnahmen.
Die Google Ads API führt alle Vorgänge in einem Job aus, für den ein Teilfehler aktiviert ist. Wenn ein Job abgebrochen wird oder einzelne Vorgänge fehlschlagen, werden erfolgreiche Vorgänge nicht zurückgesetzt.
Die folgenden Vorgänge in MutateOperation
müssen atomar sein. Daher unterstützen sie keine teilweisen Fehler und werden in Batchjobs nicht unterstützt. Fügen Sie sie keinen Jobs hinzu. Setzen Sie partial_failure
in Ihren Anfragen auf false
und verwenden Sie stattdessen die Methode mutate
in GoogleAdsService
.
Nicht unterstützte Vorgänge in BatchJobService
AssetGroupOperation
CampaignConversionGoalOperation
ConversionGoalCampaignConfigOperation
CustomConversionGoalOperation
CustomerConversionGoalOperation
CustomerOperation