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