実用的なエラー メッセージを作成する

このページでは、ユーザーが目標を達成できるように問題の解決方法をユーザーに伝える実用的なエラー メッセージを作成するためのベスト プラクティスについて説明します。

ユーザーが Google Chat アプリを操作しているときにエラー メッセージが表示され、対処できないエラー メッセージが表示されることがあります。たとえば、エラー メッセージ An error occurred は、何が問題なのか、ユーザーが問題を解決する方法、ユーザーがサポートを利用する方法が説明されていないため、有用ではありません。このページでは、実行可能な例と実行不可能な例を示して、エラー メッセージをユーザーにとって有用なものに構成する方法について説明します。

エラー メッセージの構造

対処可能なエラー メッセージの構造は次のとおりです。

• 何が問題だったのでしょうか。Chat アプリがリクエストを完了できない理由を伝えることで、ユーザーが問題を解決できます。なぜエラーが発生したのかを 説明することで信頼を築くことができます
• ユーザーが目標を達成する方法。何が問題だったかを単に言うだけでは 不十分ですエラーを回避して目標を達成する方法をユーザーに伝えます。
• サポートの利用方法。それでもユーザーが解決しない場合は、さらにサポートを得る方法をユーザーに伝えます。/help コマンドや、Chat アプリのドキュメントへのリンクなどを使用できます。

エラー メッセージの例: 日付形式が正しくありません

この例では、ユーザーが Chat アプリに想定外の形式で日付を入力しています。ここでは November 19, 2021 と記述されていますが、Chat アプリは 2021-11-19 を想定しています。

以下に、Chat アプリから応答されるエラー メッセージの対応可能バージョンと対応不可バージョンを示します。

対処可能なエラー

ユーザーが Chat アプリに他のユーザーとの会議をスケジュールするよう要求します。Chat アプリから、適切な対応が可能なエラー メッセージが返されます。

I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.

このエラー メッセージは、次の理由から対応できます。

• 何が問題かを話します。Chat アプリでは日付形式が認識されません。
• 想定される日付形式をユーザーに伝えてエラーを修正する方法と、何を書くべきかを理解しやすい日付の例も示しています。
• /help スラッシュ コマンドを使用すると、ヘルプがさらに表示されます。ユーザーが行き詰まった場合は、詳細を確認する方法を知ります。

対処できないエラー

ユーザーが Chat アプリに他のユーザーとの会議をスケジュールするよう要求します。Chat アプリから、有用で対処できないエラー メッセージが返されます。

Enter the correct date format.

このエラー メッセージは、次の理由により対応できません。

• 会議がスケジュール設定されたかどうかは表示されません。ユーザーは会議のスケジュール変更に消極的か、会議が予定されていると思い込んでいる可能性があります。
• 日付の形式についてユーザーに説明していません。ユーザーが日付の形式を知っていることを前提とするのではなく、日付形式 yyyy-mm-dd を想定していることを示す必要があります。
• それ以上のサポートは提供されない。ユーザーが行き詰まり、進め方がわからない場合は、Chat アプリへのメッセージ送信を停止する可能性があります。

試してみる

実用的なエラーを作成する方法がわかったところで、次のシナリオでどのエラーが対処可能かを特定してみましょう。

Chat アプリでは、ユーザーがキーワード schedule を使用して Chat アプリにメッセージを送信すると、カレンダーの予定が作成されます。カレンダーの予定を作成するには、Chat アプリでユーザー認証が必要です。ユーザーが認証されていない場合、Chat アプリはエラー メッセージを返します。