AdGroupCriterion.listing_group または AssetGroupListingGroupFilter のコンテキストでリスティング グループのフィルタを使用する場合、統合を設計する際に考慮すべき点がいくつかあります。
バッチ分割
広告グループ条件またはアセット グループのリスティング グループのフィルタを含むオペレーションがバッチジョブに含まれている場合、そのバッチジョブのオペレーションは Google Ads API サーバーへの受信時に複数のサブバッチに分割されます。バッチジョブの標準オペレーションとは異なり、リスティング グループ フィルタ オペレーションを含む各サブバッチはアトミックに扱われることに注意してください。
リスティング グループのフィルタを含むバッチジョブをサブバッチに分割する方法は、次の要因によって決まります。
- リスティング グループのフィルタの種類
- リスティング グループのフィルタの対象となる
AdGroupCriterionまたはAssetGroup - オペレーションの順序
オペレーションをグループ化する方法については、次の点に注意してください。
- 同じ
AssetGroupをターゲットとするすべての連続するAssetGroupListingGroupFilterOperationオペレーションは、アトミック サブバッチにグループ化されます（部分的な失敗動作はありません）。 - 同じ
AdGroupをターゲットとするlisting_groupを含むすべての連続するAdGroupCriterionOperationオペレーションは、アトミック サブバッチにグループ化されます（部分的な失敗動作はありません）。 - 他のすべての連続したオペレーションは、非アトミックなサブバッチにグループ化されます（部分障害動作）。
下の図に、この概念を示します。グレーのボックスはそれぞれ Google Ads API で送信されたバッチジョブを表します灰色のボックス内では、個々のオペレーションが色でグループ化され、Google Ads API サーバーが作成するサブバッチを表します。グレーのボックス内のオペレーションの順序は、オペレーションがバッチジョブに追加される順序に対応しています。
制限事項
バッチジョブのコンテキストでリスティング グループのフィルタを使用する場合は、次の制限が適用されます。
listing_groupを含み、同じAdGroupをターゲットとするAssetGroupListingGroupFilterOperationオペレーションの 1 つのバッチは、20,000 オペレーションを超えることはできません。ただし、オペレーションは 10,000 件以下にすることをおすすめします。- 同じ
AssetGroupをターゲットとするAssetGroupListingGroupFilterOperationオペレーションの 1 つのバッチは、10,000 オペレーションを超えることはできません。 - これらの条件のいずれかに違反すると、バッチジョブ全体が失敗します。