このページでは、Google 広告 スクリプトで注意すべき制限や制約について簡単に説明します。これらの制限事項は事前の予告なく変更されることがありますので、スクリプトは柔軟に設計し、エラーに対応できるようにしてください。
実行時間の制限
Google 広告 スクリプト
広告主様のアカウントにおける Google 広告 スクリプトの実行は 30 分間までで、時間制限に達するとキャンセルされます。キャンセルまでにスクリプトが行った変更は、そのまま適用されます。
アド マネージャー スクリプト
通常、広告管理ツールのスクリプトは最大 30 分間実行できます。その後、キャンセルされます。ただし、Google 広告スクリプトで executeInParallel メソッドを使用してアカウントを並行して処理し、コールバック メソッドを指定している場合は、キャンセルされるまでに最大 60 分実行できます。次の図にこれを示します。ここで、processAccount は並列関数、allFinished は executeInParallel を呼び出すときのコールバック メソッドです。
キャンセルまでにスクリプトが行った変更は、そのまま適用されます。
エンティティの制限
Google 広告アカウントのスクリプト
単一のイテレータでは、デフォルトで最大 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()）は、結果から動画キャンペーンとショッピング キャンペーンを除外します。代わりに、専用のキャンペーン セレクタを使用してください。