システム上の制限

このページでは、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 文字 エラー AdError.LINE_TOO_WIDE 予防 詳しくは、テキスト広告についてをご覧ください。
説明文 1 または説明文 2 の長さ	値 90 文字 エラー 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 多くなっています。予算を共有できるキャンペーンの数に制限はありません。
アカウント内の共有されていない予算の最大数	値 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 条件の変更オペレーションには適用されません。たとえば、既存のパーティションの入札単価のみを変更するリクエストには、2 つ以上のショッピング広告グループのオペレーションを含めることができます。2 つ以上のショッピング広告グループの商品パーティション ツリーの構造を変更する場合は、この制限が適用されないバッチジョブの使用をご検討ください。
キャンペーンあたりの除外 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 が返されるまれなケースがあります。これは、内部リソースがマーシャリングされ、内部上限を超える依存関係のファンアウトがある場合に発生します。クエリのサイズまたは複雑さを軽減してみてください。必要な結果を得るには、複数のクエリを実行する必要がある場合があります。