Die meisten Dienste bieten synchrone APIs, bei denen Sie eine Anfrage stellen
und dann auf eine Antwort warten müssen. BatchJobService
bietet jedoch eine Möglichkeit, Batch-Vorgänge für mehrere Dienste auszuführen, ohne
synchron auf den Abschluss der Vorgänge zu warten.
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 Feed-Elementen ausgeführt werden.
Eingereichte Jobs werden parallel ausgeführt und
BatchJobService wiederholt automatisch
Vorgänge, die aufgrund von vorübergehenden Fehlern wie Ratenbegrenzungsfehlern fehlschlagen. In der
Google Ads API wird jeder Vorgang weiterhin auf das
tägliche Vorgangslimit angerechnet.
Dabei werden die Zählregeln für API-Vorgänge berücksichtigt.
BatchJobService ermöglicht Ihnen auch die Verwendung von
temporären IDs in Ihren Anfragen, sodass
Sie abhängige Vorgänge in einem einzigen Job einreichen können.
Vorgänge
BatchJobService unterstützt alle in
MutateOperation aufgeführten Vorgänge, mit einigen wichtigen
Ausnahmen.
Da die Google Ads API alle Vorgänge in einem Job mit teilweiser Fehlerbehebung aktiviert ausführt, werden Vorgänge, die erfolgreich ausgeführt wurden, nicht zurückgesetzt, wenn ein Job abgebrochen wird oder einzelne Vorgänge fehlschlagen.
Die folgenden Vorgänge in MutateOperation müssen
atomar sein und unterstützen daher keine teilweise Fehlerbehebung
. Sie werden nicht in Batch-Jobs unterstützt. Fügen Sie diese Vorgänge nicht Ihren
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
CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation