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