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

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

ユーザーが Google Chat アプリを操作しているときに、 エラー メッセージへの対応が難しい場合、不便を感じることがあります。 たとえば、エラー メッセージ An error occurred は、 エラーの原因、ユーザーが問題を解決する方法、 ユーザーがサポートを受けることができます。このページでは、エラー メッセージを 実用的例と実行不可能な例を示して、ユーザーにとって有用なものであることを説明します。

エラー メッセージの構造

実用的なエラー メッセージの構造は次のとおりです。

  • 何が問題だったのかChat 用アプリが ユーザーが問題を解決するのに役立ちます。エラーの原因の説明 信頼を構築できます。
  • ユーザーが目標に向かって進める方法。データ アナリストは、 何が問題なのかを伝えますエラーを回避して完了する方法をお客様に伝える 判断できます
  • サポートのご案内それでも問題が解決しない場合は、以下の手順をご案内します。 をご覧ください。/help コマンドまたはドキュメントへのリンクを指定できます。 必要があります。

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

この例では、ユーザーが入力した日付の形式が 予期せぬ結果が生じました。執筆者 November 19, 2021。ただし Chat アプリは 2021-11-19

ここでは、API 呼び出しによって表示されたエラー メッセージの、実行可能なバージョンと実行できないバージョンを示します。 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」と入力します。
このエラー メッセージは、次のような内容であるため、対処できます。 <ph type="x-smartling-placeholder">
    </ph>
  • 何が問題だったのでしょうか。Chat アプリを使用するには、 あります。
  • 手順「/signin」と入力して認証します。
  • サポートのご案内詳細情報が必要な場合は、 /help
認証が必要です。
このエラー メッセージには対応方法が示されていないため、対処できません。 あります。
ログインします。
このエラー メッセージには署名方法が記載されていないため、対応できません。 ユーザーがログアウトしていることを示唆しており、 混乱が生じます
ミーティングをスケジュールできません。
このエラー メッセージはユーザーに通知されないため、対応できません。 ユーザーがミーティングをスケジュールできない理由、ヘルプなし 提供されます。