このページでは、ユーザーが目標を達成できるように、問題の解決方法を伝える実用的なエラー メッセージを作成するためのベスト プラクティスについて説明します。
ユーザーが 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 アプリへのメッセージの送信を停止する可能性があります。
試してみる
実用的なエラーの作成方法を理解したところで、次のシナリオで、どのエラーが実用的であるかを特定できますか？
ユーザーがキーワード schedule を使用して Chat アプリにメッセージを送信すると、Chat アプリはカレンダーの予定を作成します。カレンダーの予定を作成するには、Chat アプリでユーザー認証が必要です。ユーザーが認証されていない場合、Chat アプリはエラー メッセージを返します。
/signinと入力してログインする必要があります。詳しくは、/help と入力してください。- 何が問題だったか。Chat アプリで 認証が必要です。
- 手順。認証するには、
/signinと入力します。 - サポートの利用方法。ユーザーが詳細情報を必要とする場合は、
/helpと入力します。