コミュニティ コネクタのデバッグ

コミュニティ コネクタをデバッグするには、次の 2 つの方法があります。

  1. 拡張エラー メッセージの有効化
  2. 関連する実行データのロギング

このガイドでは、これらの機能を効果的に使用する方法について説明します。

デバッグ機能を有効または無効にする

現在のユーザーにデバッグ メッセージとスタック トレースが表示される場合、isAdminUser() は true を返します。isAdminUser() が false を返すか未定義の場合、エラーが発生すると、ユーザーに対して一般的なエラー メッセージが表示されます。

デバッグのヒント

  • デベロッパーには必ず true が返されるように isAdminUser() を設計してください。
  • getEffectiveUser() を信頼できるユーザーのメールアドレス許可リストと組み合わせて使用すると、エラーの完全な詳細を確認するユーザーを簡単に追加または削除できます。これは、ユーザーがエラーに遭遇して再現できない場合に特に役立ちます。
  • true を保持する必要がある不変条件には、newDebugError() を大量に使用してください。問題の原因を絞り込む際に役立ちます。

Apps Script ロギング

Apps Script には、組み込みの Apps Script Logger、Stackdriver Logging、Stackdriver Error Reporting など、さまざまなロギング メカニズムが用意されています。Google スプレッドシートへのロギングを試すこともできます。プロアクティブなロギングはバグの原因をすばやく特定するのに役立ちますが、機密性の高いユーザーデータはログに記録しないように注意する必要があります。