このページは Cloud Translation API によって翻訳されました。

トラブルシューティング

経験豊富なデベロッパーでも、コードを最初に記述したときに正しく動作することはめったにありません。そのため、トラブルシューティングは開発プロセスの重要な部分となります。このセクションでは、スクリプトのエラーを見つけて理解し、デバッグするのに役立つ手法について説明します。

エラーメッセージ

スクリプトでエラーが発生すると、エラーメッセージが表示されます。メッセージには、トラブルシューティングに使用される行番号が添えられています。この方法で表示されるエラーには、構文エラーとランタイムエラーの 2 つの基本的なタイプがあります。

構文エラー

構文エラーは、JavaScript の文法に準拠していないコードを記述したことが原因で発生します。エラーは、スクリプトを保存しようとしたときに検出されます。たとえば、次のコードスニペットには構文エラーが含まれています。

function emailDataRow(rowNumber) {
  var sheet = SpreadsheetApp.getActiveSheet();
  var data = sheet.getDataRange().getValues();
  var rowData = data[rowNumber-1].join(" ";
  MailApp.sendEmail('john@example.com',
                    'Data in row ' + rowNumber,
                    rowData);
}

この構文の問題は、4 行目の末尾に ) 文字がないことです。スクリプトを保存しようとすると、次のエラーが表示されます。

引数リストの後に ) がありません。（4 行目）

これらのタイプのエラーは、すぐに検出され、通常は原因が単純であるため、トラブルシューティングが容易です。構文エラーを含むファイルは保存できません。つまり、有効なコードのみがプロジェクトに保存されます。

ランタイムエラー

これらのエラーは、関数またはクラスを誤って使用したことが原因で発生し、スクリプトが実行された後にのみ検出できます。たとえば、次のコードはランタイムエラーを引き起こします。

function emailDataRow(rowNumber) {
  var sheet = SpreadsheetApp.getActiveSheet();
  var data = sheet.getDataRange().getValues();
  var rowData = data[rowNumber-1].join(" ");
  MailApp.sendEmail('john',
                    'Data in row ' + rowNumber,
                    rowData);
}

コードの形式は正しいのですが、MailApp.sendEmail を呼び出すときにメールアドレスの値として「john」を渡しています。これは有効なメールアドレスではないため、スクリプトを実行すると次のエラーがスローされます。

無効なメールアドレス: john（5 行目）

これらのエラーのトラブルシューティングが難しいのは、関数に渡すデータがコードに記述されておらず、スプレッドシート、フォーム、その他の外部データソースから取得されることが多いためです。以下のデバッグ手法を使用すると、これらのエラーの原因を特定できます。

一般的なエラー

以下に、一般的なエラーとその原因の一覧を示します。

サービスが呼び出された回数が多すぎます: <アクション名>

このエラーは、特定のアクションの 1 日の割り当てを超えたことを示します。たとえば、1 日に送信するメールが多すぎると、このエラーが発生することがあります。割り当ては、一般ユーザー向けアカウント、ドメインアカウント、プレミアアカウントで異なるレベルに設定されており、Google からの事前通知なしにいつでも変更される可能性があります。さまざまなアクションの割り当て上限については、Apps Script の割り当てに関するドキュメントをご覧ください。

サーバーにアクセスできません。またはサーバーエラーが発生しました。もう一度お試しください。

これらのエラーには、次のような原因が考えられます。

Google のサーバーまたはシステムが一時的に利用できない。しばらく待ってから、スクリプトをもう一度実行してみてください。
スクリプトにエラーがありますが、対応するエラーメッセージがありません。スクリプトをデバッグして、問題を特定してみてください。
このエラーは、Google Apps Script のバグが原因で発生しています。バグレポートの検索と提出の手順については、バグをご覧ください。新しいバグを報告する前に、他のユーザーがすでに報告していないか検索してください。

その操作を実行するには承認が必要です。

このエラーは、スクリプトの実行に必要な認証がないことを示します。スクリプトエディタまたはカスタムメニュー項目からスクリプトを実行すると、ユーザーに承認ダイアログが表示されます。ただし、スクリプトがトリガーから実行された場合、Google サイトのページに埋め込まれた場合、またはサービスとして実行された場合は、ダイアログを表示できないため、このエラーが表示されます。

スクリプトを承認するには、スクリプトエディタを開いて任意の関数を実行します。承認プロンプトが表示されるので、スクリプトプロジェクトを承認します。スクリプトに新しい未承認のサービスが含まれている場合は、スクリプトを再承認する必要があります。

このエラーは、ユーザーがトリガーを承認する前にトリガーが起動しているか、トリガーの承認が期限切れになっていることが原因で発生することがよくあります。スクリプトプロジェクトにアクセスできない場合（たとえば、使用しているアドオンでエラーが発生している場合）は、通常、アドオンを再度使用することでスクリプトを承認できます。トリガーが引き続き起動してこのエラーが発生する場合は、次の手順でトリガーを削除できます。

Apps Script プロジェクトの左側にある [トリガー] をクリックします。
削除するトリガーの右側にあるその他アイコン > [トリガーを削除] をクリックします。

問題のあるアドオントリガーは、アドオンをアンインストールすることでも削除できます。

きめ細かい権限も、これらのエラーの原因になる可能性があります。実行がトリガーによって呼び出されない限り、Apps Script は不足している権限をユーザーに自動的にリクエストします。このエラーからトリガーの実行を保護するには、認可スコープのページをご覧ください。

アクセスが拒否されました: DriveApp またはドメインポリシーによりサードパーティのドライブアプリが無効になっています

Google Workspace ドメインの管理者は、ドメインの Drive API を無効にすることができます。これにより、ユーザーは Google ドライブアプリをインストールして使用できなくなります。この設定により、Drive サービスまたは高度な Drive サービスを使用する Apps Script アドオンをユーザーが使用することもできなくなります（管理者が Drive API を無効にする前にスクリプトが承認されていた場合でも同様です）。

ただし、ドライブサービスを使用するアドオンまたはウェブアプリがドメイン全体のインストール用に公開され、ドメイン内の一部またはすべてのユーザーに対して管理者がインストールした場合、ドメインでドライブ API が無効になっていても、それらのユーザーに対してスクリプト関数が機能します。

スクリプトにアクティブユーザーの ID を取得する権限がありません。

アクティブユーザーの ID とメールアドレスがスクリプトで使用できないことを示します。この警告は、Session.getActiveUser() の呼び出しの結果です。スクリプトが AuthMode.FULL 以外の承認モードで実行されている場合、Session.getEffectiveUser() の呼び出しによって発生することもあります。この警告がシグナルで送信されると、以降の User.getEmail() の呼び出しでは "" のみが返されます。

この警告のトラブルシューティングを行う方法は、スクリプトが実行されている承認モードによって異なります。承認モードは、トリガー関数で e イベントパラメータの authMode プロパティとして公開されます。

AuthMode.FULL では、代わりに Session.getEffectiveUser() の使用を検討してください。
AuthMode.LIMITED で、オーナーがスクリプトを承認していることを確認します。
他の認可モードでは、どちらのメソッドも呼び出さないでください。
Google Workspace をご利用のお客様で、インストール可能なトリガーからこの警告が新たに表示されるようになった場合は、トリガーが組織内のユーザーとして実行されていることを確認してください。

ライブラリがありません

スクリプトに一般的なライブラリを追加すると、ライブラリがスクリプトの依存関係としてリストされているにもかかわらず、ライブラリが見つからないというエラーメッセージが表示されることがあります。同時にライブラリにアクセスしているユーザーが多すぎる可能性があります。このエラーを回避するには、次のいずれかの解決策を試してください。

ライブラリのコードをスクリプトにコピーして貼り付け、ライブラリの依存関係を削除します。
ライブラリスクリプトをコピーし、アカウントからライブラリとしてデプロイします。元のスクリプトの依存関係を、パブリックライブラリではなく新しいライブラリに更新してください。

ライブラリバージョンまたはデプロイバージョンがないためエラーが発生しました。エラーコード Not_Found

このエラーメッセージは、次のいずれかを示しています。

デプロイされたスクリプトのバージョンが削除されました。デプロイされたスクリプトのバージョンを更新するには、バージョン管理されたデプロイを編集するをご覧ください。
スクリプトで使用されているライブラリのバージョンが削除されました。不足しているライブラリを確認するには、ライブラリ名の横にある more_vert [その他] > [新しいタブで開く] をクリックします。ライブラリがない場合は、エラーメッセージが表示されます。更新する必要があるライブラリが見つかったら、次のいずれかの操作を行います。
- 別のバージョンを使用するようにライブラリを更新します。ライブラリを更新するをご覧ください。
- 削除したライブラリをスクリプトプロジェクトとコードから削除します。ライブラリを削除するをご覧ください。
スクリプトで使用するライブラリのスクリプトに、削除されたバージョンを使用する別のライブラリが含まれています。次のいずれかを行います。
- スクリプトで使用するライブラリに対する編集権限がある場合は、そのスクリプトのセカンダリライブラリを既存のバージョンに更新します。
- 別のバージョンを使用するようにライブラリを更新します。ライブラリを更新するをご覧ください。
- スクリプトプロジェクトとコードからライブラリを削除します。ライブラリを削除するをご覧ください。

高度なサービスで Google Chat API を呼び出すとエラー 400（invalid_scope）が発生する

Error 400: invalid_scope エラーメッセージ Some requested scopes cannot be shown が表示された場合は、Apps Script プロジェクトの appsscript.json ファイルで承認スコープが指定されていません。ほとんどの場合、Apps Script はスクリプトに必要なスコープを自動的に判断しますが、Chat の高度なサービスを使用する場合は、スクリプトで使用する認可スコープを Apps Script プロジェクトのマニフェストファイルに手動で追加する必要があります。明示的なスコープの設定をご覧ください。

このエラーを解決するには、oauthScopes 配列の一部として、適切な認証スコープを Apps Script プロジェクトの appsscript.json ファイルに追加します。たとえば、spaces.messages.create メソッドを呼び出すには、次のように追加します。

"oauthScopes": [
  "https://www.googleapis.com/auth/chat.messages.create"
]

<URL> に対して UrlFetch の呼び出しを行うことは、管理者により許可されていません

Google Workspace 管理者は、管理コンソールで許可リストを有効にして、Apps Script を介してアクセスできる外部ドメインを制御できます。

このエラーを解決するには、管理者に連絡して、URL を許可リストに追加するよう依頼してください。

デバッグ

すべての間違いでエラーメッセージが表示されるわけではありません。コードは技術的には正しく実行できるが、結果が期待どおりにならないという、より微妙なエラーが発生している可能性があります。このような状況に対処し、期待どおりに実行されないスクリプトをさらに調査するための戦略をいくつかご紹介します。

ロギング

デバッグの際に、スクリプトプロジェクトの実行時に情報を記録すると便利なことがよくあります。Google Apps Script には、情報をロギングする 2 つの方法があります。Cloud ロギングサービスと、Apps Script エディタに組み込まれているより基本的な Logger サービスとコンソールサービスです。

詳細については、ロギングガイドをご覧ください。

Error Reporting

ランタイムエラーによって発生した例外は、Google Cloud Error Reporting サービスを使用して自動的に記録されます。このサービスを使用すると、スクリプトプロジェクトで作成された例外メッセージを検索してフィルタできます。

Error Reporting にアクセスするには、Google Cloud Platform コンソールで Cloud ログとエラーレポートを表示するをご覧ください。

実行数

スクリプトを実行するたびに、Apps Script は Cloud ログを含む実行の記録を作成します。これらのレコードは、スクリプトが実行したアクションを把握するのに役立ちます。

Apps Script プロジェクトでスクリプトの実行を表示するには、左側の [実行数] をクリックします。

Apps Script サービスのステータスを確認する

まれに、特定の Google Workspace サービス（Gmail やドライブなど）で一時的な問題が発生し、サービス停止につながることがあります。この場合、これらのサービスとやり取りする Apps Script プロジェクトが想定どおりに機能しないことがあります。

Google Workspace ステータスダッシュボードで、Google Workspace サービスの停止が発生しているかどうかを確認できます。現在サービス停止が発生している場合は、解決されるまで待つか、Google Workspace ヘルプセンターまたは Google Workspace に関して報告されている問題のドキュメントで追加のサポートを求めることができます。

デバッガとブレークポイントを使用する

スクリプトの問題を特定するには、デバッグモードで実行します。デバッグモードで実行すると、スクリプトはブレークポイントに達したときに一時停止します。ブレークポイントとは、問題があると思われるスクリプト内の行をハイライト表示したものです。スクリプトが一時停止すると、その時点での各変数の値が表示されるため、多くのロギングステートメントを追加しなくても、スクリプトの内部動作を検査できます。

ブレークポイントを追加する

ブレークポイントを追加するには、ブレークポイントを追加する行の行番号にカーソルを合わせます。行番号の左側にある円をクリックします。次の画像は、スクリプトに追加されたブレークポイントの例を示しています。

ブレークポイントを追加する

デバッグモードでスクリプトを実行する

デバッグモードでスクリプトを実行するには、エディタの上部にある [デバッグ] をクリックします。

スクリプトがブレークポイントを含む行を実行する前に、スクリプトは一時停止し、デバッグ情報の表を表示します。この表を使用して、パラメータの値やオブジェクトに保存されている情報などのデータを検査できます。

スクリプトの実行方法を制御するには、デバッガパネルの上部にある [ステップイン]、[ステップオーバー]、[ステップアウト] の各ボタンを使用します。これにより、スクリプトを 1 行ずつ実行し、値が時間の経過とともにどのように変化するかを調べることができます。

エラー: 現在の行のソースコードはありません

現在の行のソースコードはありません

このエラーは、アクティブなデバッグファイルが利用できない場合に表示されます。Google Apps Script では、eval() や new Function() を使用して生成されたスクリプトなど、動的に生成された JavaScript（JS）スクリプトをスクリプトエディタに表示することはできません。これらのスクリプトは V8 エンジン内で作成および実行されますが、エディタではスタンドアロンファイルとして表示されません。これらのスクリプトにステップインすると、このエラーが発生します。

たとえば、次のコードについて考えてみます。

function myFunction() {
  eval('a=2');
}

eval() が呼び出されると、その引数は JS コードとして扱われ、V8 エンジン内で動的に作成されたスクリプトとして実行されます。eval() にステップインすると、このエラーが表示されます。スクリプトに //# sourceURL コメントが含まれている場合、その名前がコールスタックに表示されます。それ以外の場合は、名前のないエントリとして表示されます。

エラーメッセージが表示されても、デバッグセッションはアクティブなままで、実行を続行できます。続行するには、ステップイン、ステップアウト、または実行の再開に進みます。ただし、実行が動的スクリプトの範囲内にある限り、このエラーは引き続き表示されます。実行が動的スクリプトから移動すると、デバッグはこのエラーなしで続行されます。

複数の Google アカウントに関する問題

複数の Google アカウントに同時にログインしている場合、アドオンやウェブアプリにアクセスできないことがあります。マルチログイン（同時に複数の Google アカウントにログインしている状態のこと）は、Apps Script、アドオン、ウェブアプリではサポートされていません。

複数のアカウントにログインしている状態で Apps Script エディタを開くと、続行するアカウントを選択するよう求めるメッセージが表示されます。
ウェブアプリまたはアドオンを開いたときにマルチログインに関する問題が発生した場合は、次のいずれかの解決方法をお試しください。
- すべての Google アカウントからログアウトし、アクセスするアドオンまたはウェブアプリを含むアカウントにのみログインします。
- Google Chrome のシークレットウィンドウ、または同等のシークレットブラウジングウィンドウを開き、アクセスするアドオンまたはウェブアプリを含む Google アカウントにログインします。

困ったときは

上記のツールと手法を使用して問題をデバッグすると、さまざまな問題を解決できますが、解決に特別なサポートが必要になる問題が発生する可能性もあります。質問やバグの報告先については、サポートページをご覧ください。

トラブルシューティング コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

エラー メッセージ

構文エラー

ランタイム エラー

一般的なエラー

サービスが呼び出された回数が多すぎます: <アクション名>

サーバーにアクセスできません。またはサーバー エラーが発生しました。もう一度お試しください。

その操作を実行するには承認が必要です。

アクセスが拒否されました: DriveApp または ドメイン ポリシーによりサードパーティのドライブアプリが無効になっています

スクリプトにアクティブ ユーザーの ID を取得する権限がありません。

ライブラリがありません

ライブラリ バージョンまたはデプロイ バージョンがないためエラーが発生しました。エラーコード Not_Found

高度なサービスで Google Chat API を呼び出すとエラー 400（invalid_scope）が発生する

<URL> に対して UrlFetch の呼び出しを行うことは、管理者により許可されていません

デバッグ

ロギング

Error Reporting

実行数

Apps Script サービスのステータスを確認する

デバッガとブレークポイントを使用する

ブレークポイントを追加する

デバッグモードでスクリプトを実行する

エラー: 現在の行のソースコードはありません

複数の Google アカウントに関する問題

困ったときは

トラブルシューティング

エラーメッセージ

ランタイムエラー

サーバーにアクセスできません。またはサーバーエラーが発生しました。もう一度お試しください。

アクセスが拒否されました: DriveApp またはドメインポリシーによりサードパーティのドライブアプリが無効になっています

スクリプトにアクティブユーザーの ID を取得する権限がありません。

ライブラリバージョンまたはデプロイバージョンがないためエラーが発生しました。エラーコード Not_Found