インボックスについて
GitHub及びGitHub Mobile上で通知インボックスを使うには、通知設定でWeb及びモバイル通知を有効化しなければなりません。詳しくは、「通知を設定する」をご覧ください。
インボックスへアクセスするには、任意のページの右上で、 をクリックします。
受信トレイには、サブスクライブ解除していない、または [完了] としてマークしていないすべての通知が表示されます。 フィルターを使用してワークフローに最適な受信トレイをカスタマイズしたり、すべての通知を表示したり、未読の通知だけを表示したり、通知をグループ化して簡単に概要を確認したりできます。
デフォルトでは、インボックスに既読と未読の通知が表示されます。 未読の通知のみを表示するには、 [未読] をクリックするか、is:unread
クエリを使用します。
トリアージオプション
インボックスからの通知をトリアージする場合のオプションは次のとおりです。
トリアージオプション | 説明 |
---|---|
保存 | 後で確認するために、通知を保存します。 通知を保存するには、通知の右側にある をクリックします。 保存された通知は無期限に保持され、サイド バーで [保存済み] をクリックするか、または is:saved クエリを使用して表示できます。 5か月以上前に保存した通知の保存を解除すると、通知は1日以内にインボックスから消えます。 |
完了 | 通知を完了済としてマークし、受信トレイから通知を削除します。 完了した通知をすべて表示するには、サイド バーで [完了] をクリックするか、または is:done クエリを使用します。 [完了] としてマークされた通知は、5 か月間保存されます。 |
サブスクライブ解除 | @mentioned されるか、参加している Team が @mentioned されるか、またはレビューが要求されるまで、受信トレイから通知を自動的に削除し、会話からサブスクライブ解除します。 |
Read | 通知を既読としてマークします。 受信トレイで既読の通知のみを表示するには、is:read クエリを使用します。 このクエリには、 [完了] としてマークされている通知は含まれません。 |
Unread | 通知を未読としてマークします。 受信トレイで未読の通知のみを表示するには、is:unread クエリを使用します。 |
使用できるキーボード ショートカットについては、「キーボード ショートカット」をご覧ください。
トリアージオプションを選択する前に、まず通知の詳細をプレビューして調査することができます。 詳しくは、「単一の通知をトリアージする」を参照してください。
複数の通知を同時にトリアージする
複数の通知を同時にトリアージするには、関連する通知を選択し、 ドロップダウンを使用してトリアージ オプションを選択します。
デフォルト通知フィルタ
既定では、受信トレイには、割り当てられたとき、スレッドに参加したとき、Pull Request のレビューを要求されたとき、ユーザー名が直接 @mentioned されたとき、またはメンバーになっている Team が @mentioned されたときのフィルターがあります。
カスタムフィルタでインボックスをカスタマイズする
独自のカスタムフィルタを 15 個まで追加できます。
-
任意のページの右上隅で をクリックします。
-
フィルター設定を開くには、左側のサイドバーの [フィルター] の横にある をクリックします。
ヒント: 受信トレイ ビューでクエリを作成し、 [保存] をクリックすると、カスタム フィルターの設定が開き、フィルターの受信トレイの結果をすばやくプレビューできます。
-
フィルタの名前とフィルタクエリを追加します。 たとえば、特定のリポジトリの通知のみを表示するには、クエリ
repo:octocat/open-source-project-name reason:participating
を使用してフィルターを作成します。 ネイティブの絵文字キーボードを使用して、絵文字を追加することもできます。 サポートされている検索クエリの一覧については、「カスタム フィルターでサポートされているクエリ」を参照してください。 -
Create をクリックしてください。
カスタムフィルタの制限
カスタムフィルタは現在、以下をサポートしていません。
- pull request や issue のタイトルの検索を含む、インボックスでの全文検索
is:issue
、is:pr
、およびis:pull-request
クエリ フィルターの区別。 これらのクエリは、Issue と pull request の両方を検索結果として表示します。- 15 個以上のカスタムフィルタの作成
- デフォルトのフィルタまたはその順序の変更
NOT
または-QUALIFIER
を使用した 除外 の検索
カスタムフィルタでサポートされているクエリ
使用できるフィルタの種類は次のとおりです。
- リポジトリによるフィルター (
repo:
を使用) - ディスカッションの種類によるフィルター (
is:
を使用) - 通知理由によるフィルター (
reason:
を使用)
サポートされている repo:
クエリ
repo:
フィルターを追加するには、リポジトリの所有者をクエリに含める必要があります: repo:owner/repository
。 オーナーは、通知をトリガーする GitHub アセットを所有する Organization またはユーザです。 たとえば、repo:octo-org/octo-repo
は、Organization 内の octo-repo リポジトリでトリガーされた通知を表示します。
サポートされている is:
クエリ
GitHub での特定のアクティビティの通知をフィルター処理するには、is
クエリを使用します。 たとえば、リポジトリ招待の更新のみを表示するには is:repository-invitation
を使用します。Dependabot alerts のみを表示するには、is:repository-vulnerability-alert
を使用します。
is:check-suite
is:commit
is:gist
is:issue-or-pull-request
is:release
is:repository-invitation
is:repository-vulnerability-alert
is:team-discussion
Dependabot alerts の通知からノイズを減らす方法については、「Dependabot アラートの通知を構成する」をご覧ください。
is:
クエリを使用して、通知がトリアージされた方法を記述することもできます。
is:saved
is:done
is:unread
is:read
サポートされている reason:
クエリ
更新を受信した理由で通知をフィルター処理するには、reason:
クエリを使用します。 たとえば、自分 (または自分が所属する Team) が Pull Request のレビューを要求されたときに通知を表示するには、reason:review-requested
を使用します。 詳しくは、「通知について」を参照してください。
クエリ | 説明 |
---|---|
reason:assign | 割り当てられている Issue またはプルリクエストに更新があるとき。 |
reason:author | プルリクエストまたは Issue を開くと、更新または新しいコメントがあったとき。 |
reason:comment | issue、pull request、またはチーム ディスカッションについてコメントを付けた場合。 |
reason:participating | issue、pull request、またはチーム ディスカッションにコメントを付けた場合、または @mentioned された場合。 |
reason:invitation | Team、Organization、またはリポジトリに招待されたとき。 |
reason:manual | まだサブスクライブしていない Issue または Pull Request で [サブスクライブ] をクリックしたとき。 |
reason:mention | 直接 @mentioned されたとき。 |
reason:review-requested | 自分または自分が参加している Team が、プルリクエストのレビューをリクエストされたとき。 |
reason:security-alert | リポジトリに対してセキュリティアラートが発行されたとき。 |
reason:state-change | プルリクエストまたは Issue の状態が変更されたとき。 たとえば、Issue がクローズされたり、プルリクエストがマージされた場合です。 |
reason:team-mention | メンバーになっている Team が @mentioned されたとき。 |
reason:ci-activity | リポジトリに、新しいワークフロー実行ステータスなどの CI 更新があるとき。 |
Dependabotカスタムフィルタ
Dependabot を使って依存関係を最新の状態に保つには、次のカスタム フィルターを使って保存します。
is:repository_vulnerability_alert
: Dependabot alertsの通知を表示します。reason:security_alert
: Dependabot alertsとセキュリティ更新プログラムの Pull Request の通知を表示します。author:app/dependabot
: Dependabot によって生成される通知を表示します。 これには、Dependabot alerts、セキュリティアップデートのプルリクエスト、およびバージョン更新のプルリクエストが含まれます。
Dependabot について詳しくは、「Dependabot アラートについて」をご覧ください。