Batch-Verarbeitung

Die meisten Dienste stellen synchrone APIs bereit, bei denen Sie eine Anfrage stellen und dann auf eine Antwort warten müssen. BatchJobService bietet hingegen die Möglichkeit, mehrere Vorgänge für mehrere Dienste auszuführen, ohne synchron auf den Abschluss der Vorgänge zu warten.

Im Gegensatz zu dienstspezifischen Mutabläufen kann ein einzelner Job in BatchJobService auf eine gemischte Sammlung von Kampagnen, Anzeigengruppen, Anzeigen, Kriterien, Labels und Feedelementen angewendet werden. Eingereichte Jobs werden parallel ausgeführt und BatchJobService wiederholt automatisch Vorgänge, die aufgrund vorübergehender Fehler wie Ratenlimitfehler fehlschlagen. In der Google Ads API wird jeder Vorgang weiterhin gemäß der Anleitung zum Zählen von API-Vorgängen auf Ihr tägliches Limit für Vorgänge angerechnet.

Außerdem können Sie mit BatchJobService vorübergehende IDs in Ihren Anfragen verwenden, um abhängige Vorgänge in einem einzigen Job einzureichen.

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 ausführt, wenn die Option Teilweiser Fehler aktiviert ist, werden Vorgänge, die erfolgreich waren, 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. Daher werden keine teilweisen Fehler unterstützt und sie werden nicht in Batchjobs unterstützt. Fügen Sie sie Ihren Jobs nicht hinzu, legen Sie in Ihren Anfragen partial_failure auf false fest und verwenden Sie stattdessen die Methode mutate in GoogleAdsService.

Nicht unterstützte Vorgänge in BatchJobService