システム制限

このページでは、Google Ads API のさまざまな上限と、上限を超えた場合にスローされる対応するエラーについて説明します。

アカウントあたりのキャンペーン数の上限など、プロダクトの上限については、Google 広告アカウントの上限値についてをご覧ください。

注: 文字列値のバイト上限を計算する際は、UTF-8 エンコードが使用されます。2026 年 6 月 1 日より、詳細なレポートのセグメンテーション（日別、時間別、週別）は 37 か月のルックバック ウィンドウに制限されます。37 か月より前の詳細な日付セグメントをクエリすると、DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED が返されます（v24 以降）。

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 文字 エラー AdError.LINE_TOO_WIDE 予防 詳しくは、レスポンシブ検索広告についてをご覧ください。
レスポンシブ検索広告の説明文の長さ	値 90 文字 エラー AdError.LINE_TOO_WIDE 予防 上記を参照してください。
Path1 または path2 の長さ	値 15 文字 エラー AdError.LINE_TOO_WIDE 予防 上記を参照してください。
最終ページ URL の長さ	値 2,084 バイト エラー StringLengthError.TOO_LONG 予防 最終ページ URL にはプロトコル プレフィックス（「https://」など）が必要で、この上限にカウントされます。

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

Campaign budget
アカウント内の共有予算の最大数	値 11,000 エラー ResourceCountLimitExceededError.ACCOUNT_LIMIT 予防 予算の上限は、キャンペーンの上限よりも 1,000 多い値に設定されています。これは、必要に応じて予算を再割り当てできるようにするためです。予算を共有できるキャンペーンの数に制限はありません。
アカウント内の共有されていない予算の最大数	値 20,000 エラー ResourceCountLimitExceededError.ACCOUNT_LIMIT 予防 これは特定のキャンペーンに関連付けられた予算であり、キャンペーン間で共有することはできません。

Campaign
キャンペーンあたりの広告グループに関連付けられる入札戦略の最大数	値 1,000 エラー ResourceCountLimitExceededError.CAMPAIGN_LIMIT 予防 --
名前の長さ	値 256 文字 エラー StringLengthError.TOO_LONG 予防 --

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

Criterion
キーワードの長さ	値 80 文字 エラー CriterionError.KEYWORD_TEXT_TOO_LONG 予防 --
プレースメント URL の長さ	値 250 文字 エラー 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 条件の変更オペレーションには適用されません。たとえば、既存のパーティションの入札単価のみを変更するリクエストには、3 つ以上のショッピング広告グループのオペレーションを含めることができます。3 つ以上のショッピング広告グループの ProductPartition ツリーの構造を変更する場合は、この制限が適用されないバッチジョブの使用を検討してください。
キャンペーンあたりの除外 IP ブロック数	値 500 エラー ResourceCountLimitExceededError.CAMPAIGN_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
アカウントで作成できる P-MAX キャンペーンの最大数	値 100 エラー ResourceCountLimitExceededError.ACCOUNT_LIMIT 予防 詳しくは、アカウント数の上限をご覧ください。上限の引き上げについては、Google のビジネス開発担当者にお問い合わせください。
キャンペーン内のアセット グループの最大数	値 100 エラー ResourceCountLimitExceededError.RESOURCE_LIMIT 予防 --
アセット グループ内のリスティング グループのフィルタの最大数	値 1,000 エラー ResourceCountLimitExceededError.RESOURCE_LIMIT 予防 --
キャンペーン内のリスティング グループ フィルタの区分数の上限	値 7 エラー AssetGroupListingGroupFilterError.TREE_TOO_DEEP 予防 --

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