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 Batchvorgänge 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 Assets ausgeführt werden. Gesendete 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 berücksichtigt.
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, deren zugrunde liegender Dienst Teilfehler unterstützt, sowie AssetGroupOperation und AssetGroupListingGroupFilterOperation, die explizit ausgenommen und (zusammen mit zugehörigen interdependenten Vorgängen) in atomaren Sub-Batches ausgeführt werden.
Da in der Google Ads API Standardvorgänge in einem Job mit aktivierter Teilfehlerbehandlung ausgeführt werden (außer innerhalb von atomaren Unterbatches), werden erfolgreiche Vorgänge 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 keinen teilweisen Fehler. Daher werden sie in Batch-Jobs nicht unterstützt. Wenn Sie eine dieser Operationen einem Batchjob hinzufügen, wird ein MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE-Fehler zurückgegeben (oder ein InternalError.INTERNAL_ERROR-Fehler für BookCampaignsOperation und QuoteCampaignsOperation). Führen Sie sie stattdessen mit GoogleAdsService.Mutate aus, wobei partial_failure auf false und validate_only auf true für QuoteCampaignsOperation festgelegt ist.
Nicht unterstützte Vorgänge in BatchJobService
BookCampaignsOperation(verfügbar inMutateOperationab Version 23)CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperationQuoteCampaignsOperation(verfügbar inMutateOperationab Version 23; erfordertvalidate_onlyauftrue)