システム上の制限

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

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

注: 文字列値のバイト制限を計算するときは、UTF-8 エンコードが使用されます。

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 予防 詳しくは、テキスト広告についてをご覧ください。
Description1 または description2 の長さ	価値 半角 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
アカウントの共有予算の最大数	価値 11,000 エラー ResourceCountLimitExceededError.ACCOUNT_LIMIT 予防 予算の上限は、キャンペーン数の上限を 1,000 上回るので、必要に応じて予算を再割り当てする余裕を持たせます。予算を共有できるキャンペーンの数に制限はありません。
1 つのアカウントで共有できない予算の最大数	価値 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 予防 --
1 回のリクエストで ProductPartition ツリーの構造を変更するショッピング広告グループの最大数。	価値 2 エラー AdGroupCriterionError.OPERATIONS_FOR_TOO_MANY_SHOPPING_ADGROUPS 予防 この上限は、ツリーの構造を変更しない ProductPartition 条件の変更に対するオペレーションには適用されません。たとえば、既存のパーティションの入札単価のみを変更するリクエストには、3 つ以上のショッピング広告グループのオペレーションを含めることができます。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 予防 --
1 つのアカウントでエンティティ（キャンペーン、広告グループなど）に適用できるラベルの最大数	価値 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 のビジネス開発担当者にお問い合わせください。
1 つのキャンペーンで設定できるアセット グループの最大数	価値 100 エラー ResourceCountLimitExceededError.RESOURCE_LIMIT 予防 --
アセット グループのリスティング グループのフィルタの最大数	価値 1,000 エラー ResourceCountLimitExceededError.RESOURCE_LIMIT 予防 --
キャンペーンで使用できるリスティング グループのフィルタの区分の最大数	価値 7 エラー AssetGroupListingGroupFilterError.TREE_TOO_DEEP 予防 --

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