Batch-Verarbeitung

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