このページでは、ユーザーが目標を達成できるように問題の解決方法をユーザーに伝える実用的なエラー メッセージを作成するためのベスト プラクティスについて説明します。
ユーザーが 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 アプリはエラー メッセージを返します。
/signin
」と入力してログインする必要があります。詳細を確認するには、「/help
」と入力します。- 何が問題だったのでしょうか。Chat アプリには認証が必要です。
- 手順「
/signin
」と入力して認証します。 - サポートのご案内さらに詳しい情報が必要な場合は、「
/help
」と入力します。