システム上の制限

このページでは、Google Ads API のさまざまな上限と、その上限を超えた場合にスローされるエラーの一覧を示します。

アカウントあたりのキャンペーンの最大数など、サービスの制限については、Google 広告アカウントの上限についてをご覧ください。

Account
MCC アカウント階層内の Google 広告アカウントの最大数	値 場合によって異なる エラー ManagerLinkError.TOO_MANY_ACCOUNTS 予防 詳しくは、MCC アカウントのアカウント数の上限についてをご覧ください。
MCC アカウントの階層構造におけるテスト アカウントの最大数	値 50 エラー ManagerLinkError.TOO_MANY_ACCOUNTS 予防 --
1 つの Google 広告アカウントを管理できる MCC アカウントの最大数	値 5 エラー ManagerLinkError.TOO_MANY_MANAGERS 予防 詳しくは、MCC アカウントへのリンクエラーについてをご覧ください。
最上位の MCC アカウントから最下位の Google 広告アカウントまでの階層構造の最大数	値 6 エラー ManagerLinkError.MAX_DEPTH_EXCEEDED 予防 詳しくは、MCC アカウントへのリンクエラーについてをご覧ください。
同じ階層内での保留中の MCC アカウントへの招待の最大数	値 20 エラー ManagerLinkError.TOO_MANY_INVITES 予防 詳しくは、MCC アカウントへのリンクエラーについてをご覧ください。
名前の長さ	値 255 文字 エラー StringLengthError.TOO_LONG 予防 --

Ads
広告見出しの長さ	値 半角 30 文字（全角 15 文字） エラー AdError.LINE_TOO_WIDE 予防 詳しくは、テキスト広告についてをご覧ください。
説明文 1 または説明文 2 の長さ	値 半角 90 文字（全角 45 文字） エラー AdError.LINE_TOO_WIDE 予防 上記を参照してください。
経路 1 または経路 2 の長さ	値 15 文字 エラー AdError.LINE_TOO_WIDE 予防 上記を参照してください。
最終ページ URL の長さ	値 2,084 バイト エラー StringLengthError.TOO_LONG 予防 最終ページ URL にはプロトコル プレフィックス（「https://」など）が必要であり、この上限に対してカウントされます。

Ad group
名前の長さ	値 256 文字 エラー AdGroupError.INVALID_ADGROUP_NAME 予防 --

Campaign budget
1 つのアカウントで使用できる共有予算の最大数	値 11,000 エラー ResourceCountLimitExceededError.ACCOUNT_LIMIT 予防 予算の上限はキャンペーン数の上限を 1,000 上回っているので、必要に応じて予算を再割り当てできる余裕があります。予算を共有できるキャンペーンの数に制限はありません。
アカウントの非共有予算の最大数	値 20,000 エラー ResourceCountLimitExceededError.ACCOUNT_LIMIT 予防 特定のキャンペーンに関連付けられた予算で、キャンペーン間で共有することはできません。

Campaign
各キャンペーンに広告グループに適用される入札戦略の最大数	値 1,000 エラー ResourceCountLimitExceededError.CAMPAIGN_LIMIT 予防 --
名前の長さ	値 256 文字 エラー StringLengthError.TOO_LONG 予防 --

Conversion upload
1 回の API 呼び出しでアップロードできるオフライン クリック コンバージョンの最大数	値 2,000 エラー ConversionUploadError.TOO_MANY_CONVERSIONS_IN_REQUEST 予防 パフォーマンス上の理由から、1 つの API リクエストでアップロードできるコンバージョンの数は 2,000 件に制限されています。

Criterion
キーワードの長さ	値 半角 80 文字（全角 40 文字） エラー CriterionError.KEYWORD_TEXT_TOO_LONG 予防 --
プレースメントの URL の長さ	値 半角 250 文字（全角 125 文字） エラー CriterionError.PLACEMENT_URL_IS_TOO_LONG 予防 プロトコル接頭辞（「http://」など）はプレースメントの URL から削除されるため、この制限にはカウントされません。
最終ページ URL の長さ	値 2,047 バイト エラー StringLengthError.TOO_LONG 予防 プロトコル接頭辞（「http://」など）はこの制限に対してカウントされます。
近隣地域の半径	値 800 km / 500 マイル エラー CriterionError.INVALID_PROXIMITY_RADIUS 予防 --
ProductPartition ツリーの構造を変更する、1 回のリクエストでのショッピング広告グループの最大数。	値 2 エラー AdGroupCriterionError.OPERATIONS_FOR_TOO_MANY_SHOPPING_ADGROUPS 予防 この上限は、ツリーの構造を変更しない ProductPartition 条件変更オペレーションには適用されません。たとえば、既存のパーティションの入札単価のみを変更するリクエストには、2 つ以上のショッピング広告グループのオペレーションを含めることができます。3 つ以上のショッピング広告グループで ProductPartition ツリーの構造を変更する場合は、バッチジョブの使用を検討してください。この制限は適用されません。
キャンペーンあたりの除外 IP ブロック数	値 500 エラー ResourceCountLimitExceededError.CAMPAIGN_LIMIT 予防 --

Feed
アカウントあたりのフィード数	値 100 エラー ResourceCountLimitExceededError.ACCOUNT_LIMIT 予防 可能な限り、広告表示オプションの種類ごとに 1 つのフィードのみを使用することをおすすめします。
アカウントあたりのフィード アイテム数	値 5,000,000 エラー ResourceCountLimitExceededError.ACCOUNT_LIMIT 予防 --
フィードあたりのフィード属性数	値 30 エラー ResourceCountLimitExceededError.ACCOUNT_LIMIT 予防 --
マッチング関数あたりのフィード アイテム数	値 20 エラー ResourceCountLimitExceededError.ACCOUNT_LIMIT 予防 --

Label
MCC アカウントでアカウントに適用できるラベルの最大数	値 200 エラー ResourceCountLimitExceededError.ACCOUNT_LIMIT 予防 --
ラベルを適用できるアカウントの最大数	値 1,000 エラー ResourceCountLimitExceededError.ACCOUNT_LIMIT 予防 --
アカウントごとにエンティティ（キャンペーン、広告グループなど）に適用できるラベルの最大数	値 100,000 エラー ResourceCountLimitExceededError.CAMPAIGN_LIMIT, ADGROUP_LIMIT, etc. 予防 すべてのエンティティ タイプのラベルに同じ上限が適用されます。
1 つのエンティティ（キャンペーン、広告グループなど）に適用できるラベルの最大数	値 50 エラー ResourceCountLimitExceededError.CAMPAIGN_LIMIT, ADGROUP_LIMIT, etc. 予防 --

Listing groups
広告グループあたりのリスティング グループの最大数	値 20,000 エラー ResourceCountLimitExceededError.RESOURCE_LIMIT 予防 --

Payments account
お支払いアカウントにリンクできるお支払い情報の設定の最大数	値 75,000 エラー BillingSetupError.PAYMENTS_ACCOUNT_INELIGIBLE 予防 --

Performance Max
1 つのアカウントで使用できる P-MAX キャンペーンの最大数	値 100 エラー ResourceCountLimitExceededError.ACCOUNT_LIMIT 予防 詳しくは、アカウント数の上限をご覧ください。上限を引き上げる必要がある場合は、Google ビジネス開発担当者にお問い合わせください。
キャンペーンのアセット グループの最大数	値 100 エラー ResourceCountLimitExceededError.RESOURCE_LIMIT 予防 --
アセット グループ内のリスティング グループのフィルタの最大数	値 1,000 エラー ResourceCountLimitExceededError.RESOURCE_LIMIT 予防 --
キャンペーンで使用できるリスティング グループ フィルタの区分の最大数	値 7 エラー AssetGroupListingGroupFilterError.TREE_TOO_DEEP 予防 --

上記のいずれの上限も超えていないにもかかわらず、まれに INTERNAL_ERROR が発生することがあります。これは、内部リソースがマーシャリングされ、内部上限を超える依存関係のファンアウトがある場合に発生します。クエリのサイズまたは複雑さを減らしてみてください。必要な結果を得るには、複数のクエリの実行が必要になる場合があります。