Répertorier des filtres de groupe dans les tâches par lot

Lorsque vous travaillez avec des filtres de groupe de fiches dans le contexte d'un AdGroupCriterion.listing_group ou d'un AssetGroupListingGroupFilter, tenez compte des points suivants lorsque vous concevez votre intégration.

Fractionnement par lot

Si des opérations d'un job par lot contiennent des critères de groupe d'annonces ou des filtres de groupe de fiches de composants, elles sont divisées en plusieurs sous-lots lorsqu'elles sont reçues par le serveur de l'API Google Ads. Notez que, contrairement aux opérations standards d'un job par lot, chaque sous-lot contenant des opérations de filtrage de groupes d'annonces est traité de manière atomique.

La façon dont les jobs par lot contenant des filtres de groupe de fiches sont divisés en sous-lots est déterminée par les facteurs suivants :

1. Type de filtre de groupe de fiches
2. AdGroupCriterion ou AssetGroup le filtre de groupe de fiches cible
3. Ordre de priorité des opérations

Tenez compte de la façon dont les opérations sont regroupées :

• Toutes les opérations AssetGroupListingGroupFilterOperation consécutives ciblant le même AssetGroup sont regroupées dans un sous-lot atomique (sans comportement d'échec partiel).
• Toutes les opérations AdGroupCriterionOperation consécutives contenant un listing_group ciblant le même AdGroup sont regroupées dans un sous-lot atomique (sans comportement d'échec partiel).
• Toutes les autres opérations consécutives sont regroupées dans des sous-lots non atomiques (comportement en cas d'échec partiel).

Le schéma suivant illustre ce concept. Chacune des zones grises représente un job par lot tel qu'il a été envoyé à l'aide de l'API Google Ads. Dans les zones grises, les opérations individuelles sont regroupées par couleur pour représenter les sous-lots créés par le serveur de l'API Google Ads. L'ordre des opérations dans chacune des zones grises correspond à l'ordre dans lequel les opérations auraient été ajoutées au job par lot.

Limites

Lorsque vous utilisez des filtres de groupe de fiches dans le contexte de tâches par lot, les limites suivantes s'appliquent :

• Un même lot de AssetGroupListingGroupFilterOperation opérations contenant un listing_group et ciblant le même AdGroup ne peut pas comporter plus de 20 000 opérations. Toutefois, nous vous recommandons de ne pas dépasser 10 000 opérations.
• Un même lot de AssetGroupListingGroupFilterOperation opérations ciblant le même AssetGroup ne peut pas dépasser 10 000 opérations.
• Si vous ne respectez pas l'une de ces conditions, l'ensemble du job par lot échouera.

Dépannage

Les opérations de filtrage des groupes de fiches dans un job par lot sont traitées comme une seule transaction. Cela peut entraîner l'échec de nombreuses opérations en raison d'un petit nombre d'opérations erronées. De plus, en raison de la façon dont les opérations BatchJob sont traitées, la cause première des échecs peut apparaître à un index avant ou après les échecs en aval.

Par exemple, lors du traitement d'une réponse de ListBatchJobResults, vous constaterez peut-être que plusieurs opérations ont échoué avec un message d'état Ad group is invalid due to the listing groups it contains. Ce message indique généralement que l'opération à cet index a été annulée en raison d'un échec d'opération à un autre index. Pour identifier la cause première du problème, nous vous recommandons de parcourir tous les messages d'état dans BatchJobResult, avant et après l'index du message d'erreur Ad group is invalid, afin de trouver des informations supplémentaires sur l'erreur.