このページでは、Google 広告 スクリプトで注意すべき制限や制約について簡単に説明します。これらの制限事項は事前の予告なく変更されることがありますので、スクリプトは柔軟に設計し、エラーに対応できるようにしてください。
実行時間の制限
Google 広告 スクリプト
広告主様のアカウントにおける Google 広告 スクリプトの実行は 30 分間までで、時間制限に達するとキャンセルされます。キャンセルまでにスクリプトが行った変更は、そのまま適用されます。
アド マネージャー スクリプト
通常、アド マネージャーのスクリプトは最大 30 分間実行され、その後キャンセルされます。ただし、Google 広告クライアント センター スクリプトで executeInParallel メソッドを使用してアカウントを並行処理し、コールバック メソッドを指定した場合、キャンセルされるまで最大 60 分間実行できます。次の図に示します。processAccount は並列関数で、allFinished は executeInParallel を呼び出すときのコールバック メソッドです。
キャンセルまでにスクリプトが行った変更は、そのまま適用されます。
エンティティの制限
Google 広告アカウントのスクリプト
1 つのイテレータで返される結果は、デフォルトで最大 50,000 件です。セレクタで
withLimit()を呼び出すと、これを変更できます。1 つのセレクタで処理できる
selector.withIds()内の ID は最大 10,000 個です。10,000 個以上の ID を指定すると、selector.get()はランタイム エラーをスローします。同様に、ID のリストを使用してId IN [LIST]条件を指定します。10,000 にすると、ランタイム エラーが発生します。
ログ出力は 100Kb で打ち切られます。打ち切りが発生した場合、ログに警告が記録されます。
MCC アカウントのスクリプト
アド マネージャー スクリプトによって処理される各アカウントには、上記に記載されている独自の割り当てが付与されます。
executeInParallelメソッドを使用する場合、スクリプトは最大 50 個のアカウントを処理できます。executeInParallelのprocessAccountメソッドは、最大 10 MB のデータを返すことができます。
一括アップロードの制限
アップロード ファイルは 50 MB と 100 万行に制限されています。これらの上限を超えると、送信時に拒否されます。
アップロードジョは 2 時間でタイムアウトし、それ以降はアップロードファイルの残りデータの処理が停止されます。
Google サービスのクォータ
基盤となる Google Apps Script サービスには 1 日あたりのクォータが設定され、機能によっては厳しい制限が設定されている場合があります。これらの割り当てとそれに付随する例外メッセージの一覧については、こちらのページをご覧ください。
許可スクリプト数
スクリプトの許可には OAuth2 が使用されます。各アカウントで許可できるスクリプトの数は最大 250 個です。制限を超えると、以前に許可したスクリプトの許可が解除されます。これは一時的な措置であり、次にそのスクリプトを開いたときに再度許可することができます。
この上限に頻繁に達する場合は、複数のユーザー アカウントを使用して、異なるスクリプトセットを承認することを検討してください。
動画キャンペーンとショッピング キャンペーン
標準のキャンペーン セレクタ（AdsApp.campaigns().get()）を使用すると、動画キャンペーンとショッピング キャンペーンが結果から除外されます。代わりに、専用のキャンペーン セレクタを使用してください。