Während die meisten Dienste synchrone APIs bereitstellen, bei denen Sie eine Anfrage stellen und dann auf eine Antwort warten müssen, bietet BatchJobService die Möglichkeit, mehrere Vorgänge 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 Auftrag in BatchJobService für eine gemischte 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 wird trotzdem jeder Vorgang auf das Tageslimit für Vorgänge angerechnet. Dazu folgen Sie der Zählmethode für API-Vorgänge.
Darüber hinaus können Sie mit BatchJobService in Ihren Anfragen temporäre IDs verwenden, um abhängige Vorgänge in einem einzigen Job zu 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 mit aktiviertem Teilfehler aus. Wenn ein Job abgebrochen wird oder einzelne Vorgänge fehlschlagen, werden für erfolgreich erfolgreiche Vorgänge kein Rollback durchgeführt.
Die folgenden Vorgänge in MutateOperation müssen atomar sein. Sie unterstützen keine partiellen Fehler und werden in Batchjobs nicht unterstützt. Fügen Sie sie nicht Ihren Jobs hinzu. Setzen Sie dafür partial_failure in Ihren Anfragen auf false und verwenden Sie stattdessen die Methode mutate in GoogleAdsService.
Nicht unterstützte Vorgänge in BatchJobService
CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation