Wenn Sie sich mit anderen Nutzern über unsere Produkte austauschen und Feedback geben möchten, können Sie dem offiziellen Google Ads-Discord-Kanal auf dem Server der Google Advertising and Measurement Community beitreten.
Wenn ein Batch-Job Vorgänge mit Anzeigengruppenkriterien oder Filtern für die Listengruppe von Asset-Gruppen enthält, werden die Vorgänge im Batch-Job beim Empfang durch den Google Ads API-Server in mehrere Unter-Batches aufgeteilt. Im Gegensatz zu Standardvorgängen in einem Batchjob wird jeder Unterbatch, der Filtervorgänge für die Eintragsgruppe enthält, als atomar behandelt.
Die Art und Weise, wie Batch-Jobs mit Filtern für die Einträgegruppe in Sub-Batches aufgeteilt werden, hängt von den folgenden Faktoren ab:
Typ des Filters für Eintragsgruppen
Die AdGroupCriterion oder AssetGroup, auf die der Filter für die Eintragsgruppe ausgerichtet ist
Reihenfolge von Vorgängen
So werden Vorgänge gruppiert:
Alle aufeinanderfolgenden AssetGroupListingGroupFilterOperation-Vorgänge, die auf dasselbe AssetGroup ausgerichtet sind, werden in einem atomaren Sub-Batch gruppiert (kein teilweises Fehlerverhalten).
Alle aufeinanderfolgenden AdGroupCriterionOperation-Vorgänge, die ein listing_group für dasselbe AdGroup enthalten, werden in einem atomaren Sub-Batch gruppiert (kein Verhalten bei Teilausfall).
Alle anderen aufeinanderfolgenden Vorgänge werden in nicht atomaren Sub-Batches zusammengefasst (Verhalten bei Teilausfall).
Das folgende Diagramm veranschaulicht dieses Konzept. Jedes der grauen Kästchen steht für einen Batch-Job, der über die Google Ads API eingereicht wurde. In den grauen Feldern sind die einzelnen Vorgänge farblich nach den Unterbatches gruppiert, die vom Google Ads API-Server erstellt werden. Die Reihenfolge der Vorgänge in den einzelnen grauen Kästen entspricht der Reihenfolge, in der die Vorgänge dem Batchjob hinzugefügt worden wären.
Beschränkungen
Wenn Sie im Zusammenhang mit Batch-Jobs mit Filtern für Listengruppen arbeiten, gelten die folgenden Einschränkungen:
Ein einzelner Batch mit AssetGroupListingGroupFilterOperation-Vorgängen, der ein listing_group enthält und auf dasselbe AdGroup ausgerichtet ist, darf nicht länger als 20.000 Vorgänge sein. Es wird jedoch empfohlen, 10.000 Vorgänge nicht zu überschreiten.
Ein einzelner Batch mit AssetGroupListingGroupFilterOperation-Vorgängen, die auf dasselbe AssetGroup ausgerichtet sind, darf nicht mehr als 10.000 Vorgänge umfassen.
Wenn eine dieser Bedingungen nicht erfüllt ist, schlägt der gesamte Batch-Job fehl.
Fehlerbehebung
Filtervorgänge für Listengruppen in einem Batchjob werden als eine Transaktion verarbeitet. Das kann dazu führen, dass viele Vorgänge aufgrund einer kleinen Anzahl fehlerhafter Vorgänge fehlschlagen. Außerdem kann die Ursache der Fehler aufgrund der Art und Weise, wie BatchJob-Vorgänge verarbeitet werden, an einem Index vor oder nach den Downstream-Fehlern auftreten.
Wenn Sie beispielsweise eine Antwort von ListBatchJobResults verarbeiten, stellen Sie möglicherweise fest, dass mehrere Vorgänge mit der Statusmeldung Ad group is invalid due to the listing
groups it contains fehlgeschlagen sind. Diese Meldung weist in der Regel darauf hin, dass der Vorgang an diesem Index aufgrund eines fehlgeschlagenen Vorgangs an einem anderen Index abgebrochen wurde. Um die Ursache des Problems zu ermitteln, empfehlen wir, alle Statusmeldungen in BatchJobResult – vor und nach dem Index der Ad group is invalid-Fehlermeldung – nach zusätzlichen Fehlerinformationen zu durchsuchen.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-05 (UTC)."],[[["\u003cp\u003eWhen using listing group filters in batch jobs, operations are split into sub-batches based on the type of filter, target (AdGroup or AssetGroup), and order of operations.\u003c/p\u003e\n"],["\u003cp\u003eConsecutive operations targeting the same AdGroup or AssetGroup are grouped into atomic sub-batches, ensuring all operations within the sub-batch either succeed or fail together.\u003c/p\u003e\n"],["\u003cp\u003eOther consecutive operations are grouped into non-atomic sub-batches, allowing for partial failures where some operations may succeed while others fail.\u003c/p\u003e\n"],["\u003cp\u003eBatch jobs containing listing group filters have limitations on the number of operations allowed per batch to avoid failures, with recommendations to stay well below the maximum limits.\u003c/p\u003e\n"],["\u003cp\u003eIt is recommended to add operations targeting the same AdGroup or AssetGroup consecutively in a batch job for atomic processing during batch splitting.\u003c/p\u003e\n"]]],[],null,["# Listing group filters in batch jobs\n\nWhen you work with listing group filters in the context of an\n[`AdGroupCriterion.listing_group`](/google-ads/api/reference/rpc/v21/AdGroupCriterion#listing_group)\nor an\n[`AssetGroupListingGroupFilter`](/google-ads/api/reference/rpc/v21/AssetGroupListingGroupFilter),\ntake the following considerations into account when designing your integration.\n\nBatch splitting\n---------------\n\n| **Key Point:** We recommend adding `AssetGroupListingGroupFilterOperation` operations targeting the same `AssetGroup`, and `AdGroupCriterionOperation` operations containing a `listing_group` that targets the same `AdGroup`, to a batch job consecutively, so that the set of operations are treated atomically during batch splitting.\n\nIf there are any operations in a batch job that contain ad group criteria or\nasset group listing group filters, the operations in the batch job are split\ninto multiple *sub-batches* when received by the Google Ads API server. Note that\nunlike standard operations in a batch job, each sub-batch containing listing\ngroup filter operations is treated atomically.\n\nThe way in which batch jobs containing listing group filters are split into\nsub-batches is determined by the following factors:\n\n1. Type of listing group filter\n2. The `AdGroupCriterion` or `AssetGroup` the listing group filter is targeting\n3. Order of operations\n\nConsider how operations are grouped:\n\n- All consecutive [`AssetGroupListingGroupFilterOperation`](/google-ads/api/reference/rpc/v21/AssetGroupListingGroupFilterOperation) operations targeting the same [`AssetGroup`](/google-ads/api/reference/rpc/v21/AssetGroup) are grouped together in an atomic sub-batch (no partial failure behavior).\n- All consecutive [`AdGroupCriterionOperation`](/google-ads/api/reference/rpc/v21/AdGroupCriterionOperation) operations that contain a `listing_group` targeting the same [`AdGroup`](/google-ads/api/reference/rpc/v21/AdGroup) are grouped together in an atomic sub-batch (no partial failure behavior).\n- All other consecutive operations are grouped together in non-atomic sub-batches (partial failure behavior).\n\n| **Key Term:** **Consecutive** refers to the order of the operations in the batch job.\n\nThe following diagram illustrates this concept. Each of the gray boxes\nrepresents a batch job as submitted using the Google Ads API. Within the gray boxes,\nthe individual operations are grouped by color to represent the sub-batches that\nthe Google Ads API server creates. The order of the operations in each of the gray\nboxes corresponds to the order in which the operations would have been added to\nthe batch job.\n\nLimitations\n-----------\n\nWhen working with listing group filters in the context of batch jobs, the\nfollowing limitations apply:\n\n- A single batch of `AssetGroupListingGroupFilterOperation` operations containing a `listing_group` and targeting the same `AdGroup` cannot exceed 20,000 operations in length. However, it is recommended not to exceed 10,000 operations.\n- A single batch of `AssetGroupListingGroupFilterOperation` operations targeting the same `AssetGroup` cannot exceed 10,000 operations.\n- Violating either of these conditions results in the entire batch job failing.\n\nTroubleshooting\n---------------\n\nListing group filter operations in a batch job are processed as one transaction,\nwhich can lead to scenarios where many operations fail due to a small number of\nerroneous operations. Further, because of the way `BatchJob` operations are\nprocessed, the root cause of the failures may appear at an index before or after\nthe downstream failures.\n\nFor example, when processing a response from [`ListBatchJobResults`](/google-ads/api/reference/rpc/v21/BatchJobService#listbatchjobresults), you may find that several\noperations failed with a status message, `Ad group is invalid due to the listing\ngroups it contains`. This message typically indicates that the operation at this\nindex was cancelled because of a failed operation at a different index. To\nidentify the root cause of the issue, we recommend iterating through all status\nmessages in the [`BatchJobResult`](/google-ads/api/reference/rpc/v21/BatchJobResult)---before\nand after the index of the `Ad group is invalid` error message---in search\nof additional error information."]]
