システム上の制限

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

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

注: 文字列値のバイト数の上限を計算する際に UTF-8 エンコードが使用されます。

Account
クライアント センター（MCC）アカウントの階層内の Google 広告アカウントの最大数	値 場合によって異なる エラー ManagerLinkError.TOO_MANY_ACCOUNTS 予防 詳しくは、MCC アカウントのアカウント数の上限についてをご覧ください。
MCC アカウント階層内のテスト アカウントの最大数	値 50 エラー ManagerLinkError.TOO_MANY_ACCOUNTS 予防 --
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 予防 詳しくは、テキスト広告についてをご覧ください。
Description1 または description2 の長さ	値 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 mi エラー CriterionError.INVALID_PROXIMITY_RADIUS 予防 --
ProductPartition ツリーの構造を変更する 1 つのリクエストで指定できるショッピング広告グループの最大数。	値 2 エラー AdGroupCriterionError.OPERATIONS_FOR_TOO_MANY_SHOPPING_ADGROUPS 予防 この上限は、ツリーの構造を変更しない ProductPartition 条件変更のオペレーションには適用されません。たとえば、既存のパーティションの入札単価のみを変更するリクエストには、2 つを超えるショッピング広告グループのオペレーションを含めることができます。2 つを超えるショッピング広告グループの 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
アカウント内の P-MAX キャンペーンの最大数	値 100 エラー ResourceCountLimitExceededError.ACCOUNT_LIMIT 予防 詳しくは、アカウント数の上限をご覧ください。上限を引き上げたい場合は、Google のビジネス開発担当者にお問い合わせください。
キャンペーンのアセット グループの最大数	値 100 エラー ResourceCountLimitExceededError.RESOURCE_LIMIT 予防 --
アセット グループ内のリスティング グループのフィルタの最大数	値 1,000 エラー ResourceCountLimitExceededError.RESOURCE_LIMIT 予防 --
キャンペーン内のリスティング グループ フィルタの区分の最大数	値 7 エラー AssetGroupListingGroupFilterError.TREE_TOO_DEEP 予防 --

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