通知配信オプション
次の場所で、GitHub.com のアクティビティに関する通知を受け取ることができます。
- GitHub.com Web インターフェイスの通知受信トレイ
- GitHub.comの受信トレイと同期する GitHub Mobile の通知受信トレイ
- 認証済みメール アドレスを使用するメール クライアント。GitHub.com および GitHub Mobile の通知受信トレイとも同期可能
GitHub及びGitHub Mobile上で通知インボックスを使うには、通知設定でWeb及びモバイル通知を有効化しなければなりません。 詳しい情報については、「通知設定を選択する」を参照してください。
ヒント: Web とメールの両方の通を受信する場合、通知の既読あるいは未読状態を自動的に同期して、対応するメール通知を読んだら自動的に Web 通知が既読としてマークされるようにできます。 この同期を有効にするには、お使いのメール クライアントで、notifications@github.com
から、画像を表示できる必要があります。
通知インボックスの利点
GitHub.com および GitHub Mobile の通知受信トレイには、次のオプションを含む、GitHub 通知フロー用に特別に設計されたトリアージ オプションが含まれています。
- 複数の通知を一度にトリアージする。
- 完了した通知を [完了] としてマークし、インボックスから削除する。 [完了] とマークされているすべての通知を表示するには、
is:done
クエリを使います。 - 後で確認するために通知を保存する。 保存した通知にはインボックスでフラグが設定され、無期限に保持されます。 保存したすべての通知を表示するには、
is:saved
クエリを使います。 - 通知のサブスクライブを解除し、インボックスから削除する。
- 通知が通知受信トレイ内から GitHub.com で発生する issue または pull request をプレビューする。
reasons
ラベルを使って、インボックスから通知を受信する最新の理由の 1 つを表示する。- 必要に応じて、さまざまな通知に焦点を当てるカスタム フィルターを作成する。
- インボックスの通知をリポジトリまたは日付別にグループ化して、コンテキストの切り替えを減らし、概要をすばやく確認する。
さらに、GitHub Mobile を使用して、モバイル デバイスで通知を受信およびトリアージすることもできます。 詳細については、「GitHub Mobile で通知設定を管理する」または「GitHub Mobile」を参照してください。
通知にメールクライアントを使用する利点
メールクライアントを使用する利点の 1 つは、メールクライアントのストレージ容量に応じて、すべての通知を無期限に保持できることです。 受信トレイの通知は、保存済みとしてマークしていない限り、GitHub に対して 5 か月間のみ保持 されます。 保存済の通知は、無期限に保持されます。 インボックスの保持ポリシーの詳細については、「通知について」を参照してください。
メールクライアントに通知を送信すると、メールクライアントの設定に従ってインボックスをカスタマイズすることもできます。これには、カスタムラベルまたは色分けされたラベルを含めることができます。
メール通知では、受信する各種通知に柔軟に対応し、更新用にさまざまなメールアドレスを選択できます。 たとえば、リポジトリの特定の通知を検証済みの個人のメールアドレスに送信できます。 メールのカスタマイズ オプションの詳細については、「メール通知をカスタマイズする」を参照してください。
参加と Watch 対象の通知について
リポジトリの Watch 時は、そのリポジトリでのアクティビティの更新をサブスクライブしています。
自分が Watch しているリポジトリを表示するには、Watch ページにアクセスします。 詳しくは、「GitHub におけるアクティビティのサブスクリプションを管理する」を参照してください。
リポジトリの通知は、リポジトリ ページまたは Watch ページで設定できます。
カスタム通知について
リポジトリの通知はカスタマイズできます。 たとえば、リポジトリ内で複数のタイプのイベント (issue、pull request、リリース、セキュリティ アラート、またはディスカッション) の更新が発生した場合にのみ通知を受け取るか、リポジトリのすべての通知を無視するかを選択できます。 詳細については、後述の「個々のリポジトリのウォッチ設定の構成」を参照してください。
会話への参加
会話にコメントしたり、あなたのユーザー名が @mentions されたりすると、会話に 参加 することになります。 デフォルトでは、会話に参加すると、会話に自動的にサブスクライブされます。 手動で参加した会話をサブスクライブ解除するには、Issue または Pull Request で [サブスクライブ解除] をクリックするか、通知インボックスの [サブスクライブ解除] オプションを使用します。
Watch 中または参加中の会話については、通知設定で GitHub またはメールで通知を受信するかを選ぶことができます。 詳しくは、通知設定の選択に関するページを参照してください。
たとえば、[通知の設定] ページで次のようにします。
- メールで通知を受け取らない場合は、参加中とウォッチ中の通知で [電子メール] をオフにします。
- 会話に参加したときにメールで通知を受け取る場合は、[参加中] の [電子メール] をオンにします。
Watch または参加通知に対して [通知する: GitHub で] を有効にしない場合、通知受信トレイは更新されません。
メール通知をカスタマイズする
メール通知を有効にした後、GitHub.com ではコンテンツの HTML とプレーン テキストの両方のコピーを含むマルチパートのメールとして通知が送信されます。 メール通知のコンテンツには、GitHub.com の元のコンテンツに示される Markdown、@mentions、絵文字、ハッシュリンクなどがすべて含まれます。 メールでテキストだけを見たいなら、プレーンテキストのコピーだけを表示するようにメールクライアントを設定できます。
ヒント: Web とメールの両方の通を受信する場合、通知の既読あるいは未読状態を自動的に同期して、対応するメール通知を読んだら自動的に Web 通知が既読としてマークされるようにできます。 この同期を有効にするには、お使いのメール クライアントで、notifications@github.com
から、画像を表示できる必要があります。
Gmailを使っているなら、通知メールの横にあるボタンをクリックして、通知を生成したオリジナルのIssueあるいはプルリクエストにアクセスできます。
参加中または Watch 中の会話の更新を送信するデフォルトのメールアドレスを選択します。 また、既定のメール アドレスの用途として、GitHub.com のどのアクティビティの更新を受信するかを指定できます。 たとえば、デフォルトのメールを次の場所から更新するかどうかを選択します。
- Issue やプルリクエストへのコメント。
- Pull request のレビュー。
- プルリクエストのプッシュ。
- Issue やプルリクエストのオープン、コメント、クローズなどの、自分自身の操作による更新。
リポジトリを所有する Organization に応じて、さまざまなメールアドレスに通知を送信することもできます。 Organization では、特定のドメインのメールアドレスを検証する必要がある場合があります。 詳しくは、「通知を設定する」を参照してください。
特定のリポジトリの通知をメールアドレスに送信することもできます。 詳しくは、「リポジトリへのプッシュに対するメール通知について」を参照してください。
通知メールを受信するのは、通知設定でメール通知を選択している場合のみです。
あなたがメンバーになっているOrganizationがメール通知を承認されたメールドメインに制限しているなら、メールアドレスを検証して、そのドメインでOrganization内のアクティビティに関するメール通知を受けるようにしなければなりません。 詳しくは、「Organizationのメール通知の制限」を参照してください。
メール通知のフィルタリング
GitHub.com で送信される各メール通知には、ヘッダー情報が含まれています。 各メールのヘッダー情報には一貫性があるので、それを使ってメール クライアントですべての GitHub 通知あるいは特定の種類の GitHub 通知をフィルタリングしたりフォワードしたりできます。
自分に属していない通知を受け取っていると思われる場合は、その X-GitHub-Recipient
ヘッダーと X-GitHub-Recipient-Address
ヘッダーを調べます。 これらのヘッダは、対象の受信者を示しています。 メールの設定によっては、別のユーザ向けの通知を受け取る場合があります。
ヘッダー情報は、GitHub.com からのメール通知に含まれています。
Header | 情報 |
---|---|
From アドレス | このアドレスは常に、"notifications@github.com " になります。 |
To のフィールド | このフィールドはスレッドに直接接続します。メールに返信すると、会話に新しいコメントが追加されます。 |
Cc アドレス | あなたが会話をサブスクライブしていれば、GitHub Enterprise Cloud はあなたに Cc します。 2 番目の Cc メール アドレスは、通知の理由にマッチします。 これらの通知理由に対するサフィックスは@noreply.github.com です。 通知の理由には以下のようなものがあります。
|
mailing list のフィールド | このフィールドはリポジトリの名前とそのオーナーを特定します。 このアドレスの形式は常に <repository name>.<repository owner>.github.com となります。 |
X-GitHub-Severity のフィールド | 1 つ以上のリポジトリに影響する Dependabot alerts のメール通知には、X-GitHub-Severity ヘッダー フィールドが含まれます。 X-GitHub-Severity ヘッダー フィールドの値を使用して、Dependabot alerts のメール通知をフィルター処理できます。 考えられる重大度レベルは次のとおりです。
|
通知設定を選択する
-
任意のページの右上隅で をクリックします。
-
左側のサイドバーの、リポジトリ リストの下にある [通知の管理] ドロップダウンを使用して、 [通知設定] をクリックします。
-
通知設定ページで、次の場合の通知の受信方法を選択します。
- Watch しているリポジトリ、または参加している会話に更新がある場合。 詳細については、「参加と Watch 対象の通知について」を参照してください。
- 新しいリポジトリにアクセスするか、新しい Team に参加した場合。 詳しくは、「自動 Watch」をご覧ください。
- リポジトリには新しい Dependabot alerts があります。 詳細については、「Dependabot alertsの通知オプション」を参照してください。
- GitHub Actions で設定されたリポジトリにワークフロー実行の更新がある場合。 詳細については、「GitHub Actions の通知オプション」を参照してください。
- あなたが所有者である組織に属するリポジトリに、新しいデプロイ キーが追加された場合。 詳細については、「組織アラートの通知オプション」を参照してください。
自動 Watch
デフォルトでは、新しいリポジトリにアクセスすると、そのリポジトリの Watch が自動的に開始されます。 新しいチームに参加するたびに、更新が自動的にサブスクライブされ、その Team が @mentioned されたときに通知を受け取ります。 自動でサブスクライブしない場合は、通知設定で自動 Watch オプションの選択を解除できます。
「リポジトリを自動的に Watch する」が無効になっている場合、自分のリポジトリを自動的に Watch することはありません。 リポジトリページに移動して、Watch オプションを選択する必要があります。
詳しくは、「通知を設定する」を参照してください。
個々のリポジトリの Watch 設定を行う
リポジトリごとに Watch するどうかを選択できます。 また、issue、pull request、リリース、セキュリティ アラート、またはディスカッション (リポジトリで有効になっている場合) など、特定のイベント タイプのみを通知するようにしたり、個々のリポジトリを完全に無視したりすることもできます。
-
GitHub.com で、リポジトリのメイン ページへ移動します。
-
右上隅の [ウォッチ] ドロップダウン メニューを選んで、ウォッチ オプションをクリックします。
通知をさらにカスタマイズする場合は、 [カスタム] をクリックし、参加と @mentions に加えて、通知を受け取る特定のイベント (issue や pull requests など) を選びます。
たとえば、[Issue] を選ぶと、リポジトリ内のすべての issue (このオプションを選ぶ前からあった issue を含む) についての更新の通知を受け取り、それに登録されます。 このリポジトリの Pull Request で @mentioned されている場合は、その通知も受信し、Issue についての通知に加えて、その特定の Pull Request の更新をサブスクライブします。
Organization のメール通知の送信先を選択する
Organization に所属している場合、Organization のアクティビティに関する通知の送信先にするメールアカウントを指定できます。 たとえば、職場の Organization に所属している場合、通知を個人のアドレスではなく、職場のアドレスに送信する方が良いでしょう。
通知メールを受信するのは、通知設定でメール通知を選択している場合のみです。
あなたがメンバーになっているOrganizationがメール通知を承認されたメールドメインに制限しているなら、メールアドレスを検証して、そのドメインでOrganization内のアクティビティに関するメール通知を受けるようにしなければなりません。 詳しくは、「Organizationのメール通知の制限」を参照してください。
-
任意のページの右上隅で をクリックします。
-
左側のサイドバーの、リポジトリ リストの下にある [通知の管理] ドロップダウンを使用して、 [通知設定] をクリックします。
-
[既定の通知メール] で、通知の送信先にするメールアドレスを選びます。
Organization ごとにメールの送信先を設定する
2 つ以上の Organization のメンバーになっている場合は、各 Organization で、通知が自分の検証済みメール アドレスに送信されるよう設定できます。 詳しくは、「メールアドレスを検証する」をご覧ください。
-
任意のページの右上隅で をクリックします。
-
左側のサイドバーの、リポジトリ リストの下にある [通知の管理] ドロップダウンを使用して、 [通知設定] をクリックします。
-
[既定の通知メール] で、 [カスタム ルーティング] をクリックします。
-
[新しいルートの追加] をクリックします。
-
[Organization の選択] を選び、カスタマイズする Organization をクリックします。
-
検証済みメール アドレスのうち 1 つを選択し、 [保存] をクリックします。
Dependabot alerts の通知オプション
ユーザー アカウントの通知オプションは、https://github.com/settings/notifications にあります。 各リポジトリの通知設定は、リポジトリの Watch 設定で構成できます。
リポジトリの Dependabot alertsに関する通知を受け取るには、これらのリポジトリを監視し、"すべてのアクティビティ" 通知を受け取るようにサブスクライブするか、"セキュリティ アラート" を含めるようにカスタム設定を構成する必要があります。 詳しくは、「通知を設定する」を参照してください。
通知の配信方法と、通知が送信される頻度を選択できます。 既定では、次のようにして通知を受け取ります。
-
インボックス (Web 通知として)。 Web 通知は、Dependabot がリポジトリで有効にされていて、新しいマニフェスト ファイルがリポジトリにコミットされたときに、重要度が重大または高の新しい脆弱性が見つかった場合に送信されます ( [GitHub 上] オプション)。
-
メール。Dependabot がリポジトリで有効にされていて、新しいマニフェスト ファイルがリポジトリにコミットされたときに、重要度が重大または高の新しい脆弱性が見つかると、メールが送信されます ( [Email] オプション)。
-
コマンド ライン。セキュリティで保護されていない依存関係を使用してリポジトリにプッシュすると、警告がコールバックとして表示されます ( [CLI] オプション)。
-
GitHub Mobileでは、Web通知として表示されます。 詳しくは、「通知を設定する」をご覧ください。
注: メールと Web/GitHub Mobile の通知は次のとおりです。
-
Dependabot がリポジトリで有効にされているとき、または新しいマニフェスト ファイルがリポジトリにコミットされたときは、"リポジトリごと"。
-
新しい脆弱性が検出されたときは、"組織ごと"。
-
新しい脆弱性が検出されたときに送信されます。 脆弱性が更新されたときには、GitHub は通知を送信しません。
Dependabot alertsに関する通知を受け取る方法をカスタマイズできます。 たとえば、 [週単位のメール ダイジェスト] オプションを使用すると、最大 10 個のリポジトリについてアラートを要約した週単位のダイジェスト メールを受け取ることができます。
利用可能な通知の配信方法の詳細、および Dependabot alertsの通知を最適化するためのアドバイスについては、「Dependabot アラートの通知を構成する」を参照してください。
Secret scanning 通知オプション
新しいシークレットが検出されると GitHub Enterprise Cloud によって、通知設定に従ってリポジトリのセキュリティ アラートにアクセスできるすべてのユーザーに通知されます。 これらのユーザーは次のとおりです。
- リポジトリ管理者
- セキュリティマネージャー
- 読み書きアクセス権が与えられるカスタム ロールを持つユーザー
- Organization 所有者とエンタープライズ所有者。シークレットが漏洩したリポジトリの管理者である場合
注: コミット作成者がシークレットを間違ってコミットした場合、通知設定に関係なくその者に通知されます。
次の場合に、電子メール通知を受け取ります。
- リポジトリをウォッチしている。
- リポジトリ で [すべてのアクティビティ]、またはカスタムの [セキュリティ アラート] の通知を有効にしている。
- 通知設定にある [サブスクリプション] の [ウォッチ] で、電子メールによる通知を受け取ることを選んだ。
シークレット スキャン アラート の通知を構成する方法について詳しくは、「シークレット スキャン アラートの通知を構成する」をご覧ください。
GitHub Actions の通知オプション
GitHub Actions で設定されており、確認中のリポジトリについては、ワークフロー実行更新を受信する方法を選べます。
-
[通知設定] ページの [システム] で、[アクション] の下にある [通知しない] ドロップダウン メニューを選びます。
-
Web 通知をオプトインするには、ドロップダウン メニューから [GitHub 上] を選びます。
メール通知をオプトインするには、ドロップダウン メニューから [メール] を選びます。
-
または、失敗したワークフロー実行についての通知のみ受信する場合は、[失敗したワークフローについてのみ通知する] を選び、 [保存] をクリックします。
組織アラートの通知オプション
組織の所有者は、組織のメンバーが組織内のリポジトリに新しいデプロイ キーを追加すると、既定で電子メール通知を受け取ります。 これらの通知はいつでもサブスクライブ解除できます。 通知設定ページの Organization alerts で、 [メール] を選択解除します。
GitHub Mobile で通知設定を管理する
GitHub Mobile をインストールすると、自動的に Web 通知が有効になります。 アプリケーション内で、次のイベントのプッシュ通知を有効にできます。
- ダイレクトメンション
- Issue またはプルリクエストへの割り当て
- プルリクエストのレビューをリクエスト
- デプロイメントの承認をリクエスト
GitHub Mobile がモバイルデバイスにプッシュ通知を送信するタイミングをスケジュール設定することもできます。
GitHub Enterprise Serverは、ユーザの情報をサードパーティのサービスに送信することなくプッシュ通知をサポートするためにバックグラウンドフェッチを使用するので、プッシュ通知の受信に遅延が生じることがあります。
GitHub for iOS
で通知設定を管理する
- 下部のメニューで、 [プロファイル] をタップします。
- 設定を表示するには、 をタップします。
- 通知設定を更新するには、 [通知] をタップしてから、トグルを使用して、好みの種類のプッシュ通知を有効または無効にします。
- オプションで、GitHub Mobile がモバイル デバイスにプッシュ通知を送信するタイミングをスケジュールするには、 Working Hours をタップし、 Custom working hours トグルを使用して、プッシュ通知を受信するタイミングを選択します。
GitHub for Android
で通知設定を管理する
- 下部のメニューで、 [プロファイル] をタップします。
- 設定を表示するには、 をタップします。
- 通知設定を更新するには、 [通知の構成] をタップしてから、トグルを使用して、好みの種類のプッシュ通知を有効または無効にします。
- オプションで、GitHub Mobile がモバイル デバイスにプッシュ通知を送信するタイミングをスケジュールするには、 Working Hours をタップし、 Custom working hours トグルを使用して、プッシュ通知を受信するタイミングを選択します。
GitHub Mobile を使用して個々のリポジトリの Watch 設定をする
リポジトリごとに Watch するどうかを選択できます。 また、Issue、Pull Request、ディスカッション (リポジトリで有効になっている場合) などの特定のイベント タイプと新しいリリースのみを通知したり、個々のリポジトリを完全に無視したりすることもできます。
- GitHub Mobile で、リポジトリのメイン ページに移動します。
- [Watch] をタップします。
- 通知を受け取るアクティビティを選択するには、目的の Watch 設定をタップします。 たとえば、参加しているか @mentioned の場合にのみ通知を受け取ること、または [カスタム] オプションを使って通知を受け取る特定のイベントを選ぶことができます。