Batchverarbeitung

Die meisten Dienste bieten synchrone APIs, bei denen Sie eine Anfrage stellen und dann auf eine Antwort warten müssen. BatchJobService bietet 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 Assets 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 Anweisungen zum Zählen von API-Vorgängen 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, deren zugrunde liegender Dienst Teilausfälle unterstützt, sowie AssetGroupOperation und AssetGroupListingGroupFilterOperation, die ausdrücklich ausgenommen und (zusammen mit den zugehörigen voneinander abhängigen Vorgängen) in atomaren Unter-Batches ausgeführt werden.

Da die Google Ads API Standardvorgänge in einem Job mit aktivierter Teilausfall-Funktion ausführt (außer in atomaren Unter-Batches), 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 keine Teilausfälle. Daher werden sie in Batch-Jobs nicht unterstützt. Wenn Sie einen dieser Vorgänge zu einem Batch-Job hinzufügen, wird der MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE Fehler zurückgegeben (oder ein InternalError.INTERNAL_ERROR für BookCampaignsOperation und QuoteCampaignsOperation). Führen Sie sie stattdessen mit GoogleAdsService.Mutate aus, wobei partial_failure auf false gesetzt ist (und validate_only auf true für QuoteCampaignsOperation).

Nicht unterstützte Vorgänge in BatchJobService

Weiter
Nutzungsablauf