Die meisten Dienste bieten synchrone APIs, bei denen Sie eine Anfrage stellen und dann auf eine Antwort warten müssen. Mit BatchJobService können Sie jedoch Batches von Vorgängen für mehrere Dienste ausfü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. Bei der Google Ads API wird jeder Vorgang weiterhin auf Ihr tägliches Vorgangslimit angerechnet. Dabei wird die Anleitung zum Zählen von API-Vorgängen befolgt.
Mit BatchJobService können Sie auch temporäre IDs in Ihren Anfragen verwenden, um abhängige Vorgänge in einem einzigen Job zu senden.
Vorgänge
BatchJobService unterstützt alle in MutateOperation aufgeführten Vorgänge, mit einigen wichtigen Ausnahmen.
Da bei der Google Ads API alle Vorgänge in einem Job mit aktivierter Teilfehlerbehandlung ausgeführt werden, 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 und unterstützen daher keinen Teilausfall. Sie werden nicht in Batch-Jobs unterstützt. Fügen Sie diese Vorgänge nicht Ihren Jobs hinzu, legen Sie partial_failure in Ihren Anfragen auf false fest und verwenden Sie stattdessen die Methode mutate in GoogleAdsService.
Nicht unterstützte Vorgänge in BatchJobService
CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation