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