Enumera filtros de grupos en trabajos por lotes

Cuando trabajes con filtros de grupos de fichas en el contexto de un AdGroupCriterion.listing_group o un AssetGroupListingGroupFilter, ten en cuenta las siguientes consideraciones cuando diseñes tu integración.

División por lotes

AssetGroupListingGroupFilterOperationAssetGroupAdGroupCriterionOperationlisting_groupAdGroup

Si hay operaciones en un trabajo por lotes que contienen criterios de grupos de anuncios o filtros de grupos de fichas de grupos de recursos, las operaciones del trabajo por lotes se dividen en varios sublotes cuando las recibe el servidor de la API de Google Ads. Ten en cuenta que, a diferencia de las operaciones estándar en un trabajo por lotes, cada sublote que contiene operaciones de filtros de grupos de fichas se trata de forma atómica.

La forma en que los trabajos por lotes que contienen filtros de grupos de fichas se dividen en sublotes está determinada por los siguientes factores:

1. Tipo de filtro de grupos de fichas
2. El AdGroupCriterion o AssetGroup al que se segmenta el filtro de grupos de fichas
3. Orden de las operaciones

Ten en cuenta cómo se agrupan las operaciones:

• Todas las operaciones AssetGroupListingGroupFilterOperation que segmentan el mismo AssetGroup se agrupan en un sublote atómico (sin comportamiento de falla parcial).
• Todas las operaciones consecutivas AdGroupCriterionOperation que contienen un listing_group que segmenta el mismo AdGroup se agrupan en un sublote atómico (sin comportamiento de falla parcial).
• Todas las demás operaciones consecutivas se agrupan en sublotes no atómicos (comportamiento de falla parcial).

En el siguiente diagrama, se ilustra este concepto. Cada uno de los cuadros grises representa un trabajo por lotes tal como se envió con la API de Google Ads. Dentro de los cuadros grises, las operaciones individuales se agrupan por color para representar los sublotes que crea el servidor de la API de Google Ads. El orden de las operaciones en cada uno de los cuadros grises corresponde al orden en que se habrían agregado las operaciones al trabajo por lotes.

Limitaciones

Cuando trabajes con filtros de grupos de fichas en el contexto de trabajos por lotes, se aplican las siguientes limitaciones:

• Un solo lote de AdGroupCriterionOperation operaciones que contenga un listing_group y que segmenten el mismo AdGroup no puede exceder las 20,000 operaciones de longitud. Sin embargo, se recomienda no exceder las 10,000 operaciones.
• Un solo lote de AssetGroupListingGroupFilterOperation operaciones que segmenten el mismo AssetGroup no puede exceder las 10,000 operaciones.
• Si se incumple alguna de estas condiciones, fallará todo el trabajo por lotes.

Solución de problemas

Las operaciones de filtros de grupos de fichas en un trabajo por lotes se procesan como una transacción, lo que puede generar situaciones en las que muchas operaciones fallan debido a una pequeña cantidad de operaciones erróneas. Además, debido a la forma en que se procesan las operaciones BatchJob, la causa raíz de las fallas puede aparecer en un índice antes o después de las fallas posteriores.

Por ejemplo, cuando procesas una respuesta de ListBatchJobResults, es posible que descubras que varias operaciones fallaron con un mensaje de estado, Ad group is invalid due to the listing groups it contains. Por lo general, este mensaje indica que la operación en este índice se canceló debido a una operación fallida en un índice diferente. Para identificar la causa raíz del problema, te recomendamos que iteres por todos los mensajes de estado en BatchJobResult, antes y después del índice del mensaje de error Ad group is invalid, en busca de información adicional sobre el error.