Skip to main content
ドキュメントへの更新が頻繁に発行されており、このページの翻訳はまだ行われている場合があります。 最新の情報については、「英語のドキュメント」を参照してください。
現在、GitHub AE は限定的リリースです。

通知を設定する

通知を受信する GitHub のアクティビティのタイプと、これらの更新の配信方法を選択します。

通知配信オプション

次の場所で、your enterprise のアクティビティに関する通知を受け取ることができます。

  • your enterprise Web インターフェイスの通知受信トレイ
  • 認証済みメール アドレスを使用するメール クライアント。your enterprise

ヒント: Web とメールの両方の通を受信する場合、通知の既読あるいは未読状態を自動的に同期して、対応するメール通知を読んだら自動的に Web 通知が既読としてマークされるようにできます。 この同期を有効にするには、お使いのメール クライアントで、自分の GitHub AE ホスト名の no-reply メール アドレス から、画像を表示できる必要があります。

通知インボックスの利点

your enterprise の通知受信トレイには、次のオプションを含む、GitHub 通知フロー用に特別に設計されたトリアージ オプションが含まれています。

  • 複数の通知を一度にトリアージする。
  • 完了した通知を [完了] としてマークし、インボックスから削除する。 [完了] とマークされているすべての通知を表示するには、is:done クエリを使います。
  • 後で確認するために通知を保存する。 保存した通知にはインボックスでフラグが設定され、無期限に保持されます。 保存したすべての通知を表示するには、is:saved クエリを使います。
  • 通知のサブスクライブを解除し、インボックスから削除する。
  • 通知が通知受信トレイ内から your enterprise で発生する Issue、Pull Request、または Team ディスカッションをプレビューする。
  • reasons ラベルを使って、インボックスから通知を受信する最新の理由の 1 つを表示する。
  • 必要に応じて、さまざまな通知に焦点を当てるカスタム フィルターを作成する。
  • インボックスの通知をリポジトリまたは日付別にグループ化して、コンテキストの切り替えを減らし、概要をすばやく確認する。

通知にメールクライアントを使用する利点

メールクライアントを使用する利点の 1 つは、メールクライアントのストレージ容量に応じて、すべての通知を無期限に保持できることです。 受信トレイの通知は、保存済みとしてマークしていない限り、GitHub に対して 5 か月間のみ保持 されます保存済の通知は、無期限に保持されます。 インボックスの保持ポリシーの詳細については、「通知について」を参照してください。

メールクライアントに通知を送信すると、メールクライアントの設定に従ってインボックスをカスタマイズすることもできます。これには、カスタムラベルまたは色分けされたラベルを含めることができます。

メール通知では、受信する各種通知に柔軟に対応し、更新用にさまざまなメールアドレスを選択できます。 たとえば、リポジトリの特定の通知を検証済みの個人のメールアドレスに送信できます。 メールのカスタマイズ オプションの詳細については、「メール通知をカスタマイズする」を参照してください。

参加と Watch 対象の通知について

リポジトリの Watch 時は、そのリポジトリでのアクティビティの更新をサブスクライブしています。 同様に、特定の Team のディスカッションの Watch 時は、その Team のページですべての会話の更新をサブスクライブしていることになります。 詳細については、「Team ディスカッションについて」を参照してください。

自分が Watch しているリポジトリを表示するには、Watch ページにアクセスします。 詳細については、「GitHub でサブスクリプションと通知を管理する」を参照してください。

通知を設定する

リポジトリの通知は、リポジトリ ページまたは Watch ページで設定できます。

カスタム通知について

リポジトリの通知はカスタマイズできます。 たとえば、リポジトリ内で複数のタイプのイベント (issue、pull request、リリース、セキュリティ アラート、またはディスカッション) の更新が発生した場合にのみ通知を受け取るか、リポジトリのすべての通知を無視するかを選択できます。 詳細については、後述の「個々のリポジトリのウォッチ設定の構成」を参照してください。

会話への参加

会話にコメントしたり、あなたのユーザー名が @mentions されたりすると、会話に 参加 することになります。 デフォルトでは、会話に参加すると、会話に自動的にサブスクライブされます。 手動で参加した会話をサブスクライブ解除するには、Issue または Pull Request で [サブスクライブ解除] をクリックするか、通知インボックスの [サブスクライブ解除] オプションを使用します。

Watch 中または参加中の会話については、メールまたは your enterprise の通知受信トレイのどちらで通知を受け取るかを選ぶことができます。 詳しくは、通知設定の選択に関するページを参照してください。

参加および Watch 通知オプションのスクリーンショット

次に例を示します。

  • 通知をメールに送信しない場合は、 [メール] をオフにして、参加と Watch 対象の通知を行います。
  • 会話に参加したときにメールで通知を受信する場合は、Participating の下の [メール] を選択します。

Webに対して Watch または参加通知を有効にしない場合、通知受信トレイは更新されません。

メール通知をカスタマイズする

メール通知を有効にした後、your enterprise ではコンテンツの HTML とプレーン テキストの両方のコピーを含むマルチパートのメールとして通知が送信されます。 メール通知のコンテンツには、your enterprise の元のコンテンツに示される Markdown、@mentions、絵文字、ハッシュリンクなどがすべて含まれます。 メールでテキストだけを見たいなら、プレーンテキストのコピーだけを表示するようにメールクライアントを設定できます。

: your enterprise でアウトバウンド メールのサポートが有効になっている場合にのみ、メール通知を受け取ります。 詳しい情報については、サイト管理者にお問い合わせください。

ヒント: Web とメールの両方の通を受信する場合、通知の既読あるいは未読状態を自動的に同期して、対応するメール通知を読んだら自動的に Web 通知が既読としてマークされるようにできます。 この同期を有効にするには、お使いのメール クライアントで、自分の GitHub AE ホスト名の no-reply メール アドレス から、画像を表示できる必要があります。

参加中または Watch 中の会話の更新を送信するデフォルトのメールアドレスを選択します。 また、既定のメール アドレスの用途として、your enterprise のどのアクティビティの更新を受信するかを指定できます。 たとえば、デフォルトのメールを次の場所から更新するかどうかを選択します。

  • Issue やプルリクエストへのコメント。
  • Pull request のレビュー。
  • プルリクエストのプッシュ。
  • Issue やプルリクエストのオープン、コメント、クローズなどの、自分自身の操作による更新。

リポジトリを所有する Organization に応じて、さまざまなメールアドレスに通知を送信することもできます。 Organization では、特定のドメインのメールアドレスを検証する必要がある場合があります。 詳細については、「Organization のメール通知の送信先を選択する」を参照してください。

特定のリポジトリの通知をメールアドレスに送信することもできます。 詳細については、「リポジトリへのプッシュに対するメール通知について」を参照してください。

通知メールを受信するのは、通知設定でメール通知を選択している場合のみです。

メール通知のフィルタリング

your enterprise で送信される各メール通知には、ヘッダー情報が含まれています。 各メールのヘッダー情報には一貫性があるので、それを使ってメール クライアントですべての GitHub 通知あるいは特定の種類の GitHub 通知をフィルタリングしたりフォワードしたりできます。

自分に属していない通知を受け取っていると思われる場合は、その X-GitHub-Recipient ヘッダーと X-GitHub-Recipient-Address ヘッダーを調べます。 これらのヘッダは、対象の受信者を示しています。 メールの設定によっては、別のユーザ向けの通知を受け取る場合があります。

your enterprise からのメール通知には、以下のヘッダー情報が含まれています:

Header情報
From アドレスこのアドレスは常に、"サイトの管理者が設定した no-reply メール アドレス" になります。
To のフィールドこのフィールドはスレッドに直接接続します。
Cc アドレスあなたが会話をサブスクライブしていれば、GitHub AE はあなたに Cc します。 2 番目の Cc メール アドレスは、通知の理由にマッチします。 これらの通知理由に対するサフィックスはサイト管理者が設定した no-reply メール アドレスに基づくです。 通知の理由には以下のようなものがあります。
  • assign: あなたに Issue または Pull Request が割り当てられた。
  • author: あなたが Issue または Pull Request を作成した。
  • ci_activity: あなたがトリガーした GitHub Actions ワークフローの実行が完了した。
  • comment: Issue または Pull Request にあなたがコメントした。
  • manual: あなたが手動でサブスクライブした Issue または Pull Request が更新された。
  • mention: Issue または Pull Request についてあなたがメンションされた。
  • push: あなたがサブスクライブしている Pull Request に誰かがコミットした。
  • review_requested: あなた、またはあなたがメンバーになっている Team が Pull Request のレビューをリクエストされた。
  • security_alert: GitHub で、あなたがアラート受信者になっているリポジトリに脆弱性が検出された。
  • state_change: あなたがサブスクライブしている Issue または Pull Request がクローズまたはオープンされた。
  • subscribed: あなたが Watch しているリポジトリに更新があった。
  • team_mention: あなたが属している Team が、Issue または Pull Request についてメンションされた。
  • your_activity: あなたが Issue または Pull Request をオープン、コメントまたはクローズした。
mailing list のフィールドこのフィールドはリポジトリの名前とそのオーナーを特定します。 このアドレスの形式は常に <repository name>.<repository owner>.[hostname] となります。
X-GitHub-Severity のフィールド1 つ以上のリポジトリに影響する Dependabot alerts のメール通知には、X-GitHub-Severity ヘッダー フィールドが含まれます。 X-GitHub-Severity ヘッダー フィールドの値を使用して、Dependabot alerts のメール通知をフィルター処理できます。 考えられる重大度レベルは次のとおりです。
  • low
  • moderate
  • high
  • critical
詳細については、「Dependabot alerts について」を参照してください。

通知設定を選択する

  1. 任意のページの右上で をクリックします。 未読メッセージを示す通知 1. 左側のサイドバーの、リポジトリ リストの下にある [通知の管理] ドロップダウンを使用して、 [通知設定] をクリックします。 [通知の管理] ドロップダウン メニュー オプション
  2. 通知設定ページで、次の場合の通知の受信方法を選択します。
    • Watch しているリポジトリや Team ディスカッション、または参加している会話に更新がある場合。 詳細については、「参加と Watch 対象の通知について」を参照してください。
    • 新しいリポジトリにアクセスするか、新しい Team に参加した場合。 詳しくは、「自動 Watch」をご覧ください。
    • リポジトリには新しい Dependabot alerts があります。 詳細については、「Dependabot alertsの通知オプション」を参照してください。
    • あなたが所有者である組織に属するリポジトリに、新しいデプロイ キーが追加された場合。 詳細については、「組織アラートの通知オプション」を参照してください。

自動 Watch

デフォルトでは、新しいリポジトリにアクセスすると、そのリポジトリの Watch が自動的に開始されます。 新しいチームに参加するたびに、更新が自動的にサブスクライブされ、その Team が @mentioned されたときに通知を受け取ります。 自動でサブスクライブしない場合は、通知設定で自動 Watch オプションの選択を解除できます。

自動 Watch オプション

「リポジトリを自動的に Watch する」が無効になっている場合、自分のリポジトリを自動的に Watch することはありません。 リポジトリページに移動して、Watch オプションを選択する必要があります。

詳しくは、通知設定の選択に関するページを参照してください。

個々のリポジトリの Watch 設定を行う

リポジトリごとに Watch するどうかを選択できます。 また、issue、pull request、リリース、セキュリティ アラート、またはディスカッション (リポジトリで有効になっている場合) など、特定のイベント タイプのみを通知するようにしたり、個々のリポジトリを完全に無視したりすることもできます。

  1. your enterprise で、リポジトリのメイン ページへ移動します。

  2. 右上隅の [Watch] ドロップダウン メニューを選択し、Watch オプションをクリックします。 リポジトリのドロップダウンメニューの Watch オプション

    [カスタム] オプションを使用すると、通知をさらにカスタマイズして、参加や @mentions に加えて、リポトリで特定のイベントが発生したときにのみ通知されるようにすることができます。 リポジトリのドロップダウン メニューのカスタム Watch オプション[Issue] を選ぶと、リポジトリ内のすべての Issue (このオプションを選ぶ前からあったものを含む) の更新について通知され、サブスクライブされます。 このリポジトリの Pull Request で @mentioned されている場合は、その通知も受信し、Issue についての通知に加えて、その特定の Pull Request の更新をサブスクライブします。

Organization のメール通知の送信先を選択する

Organization に所属している場合、Organization のアクティビティに関する通知の送信先にするメールアカウントを指定できます。 たとえば、職場の Organization に所属している場合、通知を個人のアドレスではなく、職場のアドレスに送信する方が良いでしょう。

通知メールを受信するのは、通知設定でメール通知を選択している場合のみです。

  1. 任意のページの右上で をクリックします。 未読メッセージを示す通知 1. 左側のサイドバーの、リポジトリ リストの下にある [通知の管理] ドロップダウンを使用して、 [通知設定] をクリックします。 [通知の管理] ドロップダウン メニュー オプション

  2. [Default notification email] で、通知の送信先にするメールアドレスを選択します。

    既定の通知メール アドレス ドロップダウンのスクリーンショット

  3. [保存] をクリックします。

Organization ごとにメールの送信先を設定する

2 つ以上の Organization のメンバーになっている場合は、各 Organization で、通知が自分のアカウントのメール アドレスに送信されるよう設定できます。

  1. 任意のページの右上で をクリックします。 未読メッセージを示す通知 1. 左側のサイドバーの、リポジトリ リストの下にある [通知の管理] ドロップダウンを使用して、 [通知設定] をクリックします。 [通知の管理] ドロップダウン メニュー オプション

  2. [Custom routing] で、一覧から Organization の名前を見つけます。

    Organization とメールアドレスの一覧

  3. 変更したいアドレスの隣にある [編集] をクリックします。

    Organization のメール アドレスの編集

  4. 検証済みメール アドレスのうち 1 つを選択し、 [保存] をクリックします。

    Organization ごとのメール アドレス切り替え

Dependabot alerts の通知オプション

通知の配信方法と、通知が送信される頻度を選択できます。 既定では、エンタープライズ所有者がインスタンスで通知用にメールを構成している場合、Dependabot alerts を次のように受け取ります。

  • インボックス (Web 通知として)。 Web 通知は、Dependabot がリポジトリで有効にされていて、新しいマニフェスト ファイルがリポジトリにコミットされたときに、重要度が重大または高の新しい脆弱性が見つかった場合に送信されます ( [GitHub 上] オプション)。
  • メール。Dependabot がリポジトリで有効にされていて、新しいマニフェスト ファイルがリポジトリにコミットされたときに、重要度が重大または高の新しい脆弱性が見つかると、メールが送信されます ( [Email] オプション)。
  • ユーザー インターフェイス。セキュリティで保護されていない依存関係がある場合、リポジトリのファイル ビューとコード ビューに警告が表示されます ( [UI アラート] オプション)。
  • コマンド ライン。セキュリティで保護されていない依存関係を使用してリポジトリにプッシュすると、警告がコールバックとして表示されます ( [CLI] オプション)。

注: メールと Web の通知は次のとおりです。

  • Dependabot がリポジトリで有効にされているとき、または新しいマニフェスト ファイルがリポジトリにコミットされたときは、リポジトリごと

  • 新しい脆弱性が検出されたときは、Organization ごと

Dependabot alertsに関する通知を受け取る方法をカスタマイズできます。 たとえば、 [脆弱性の要約をメールで送る][週単位のセキュリティ メール ダイジェスト] オプションを使用すると、最大 10 個のリポジトリについてアラートを要約した週単位のダイジェスト メールを受け取ることができます。

利用可能な通知の配信方法の詳細、および Dependabot alertsの通知を最適化するためのアドバイスについては、「Dependabot alertsに対する通知の設定」をご覧ください。

組織アラートの通知オプション

組織の所有者は、組織のメンバーが組織内のリポジトリに新しいデプロイ キーを追加すると、既定で電子メール通知を受け取ります。 これらの通知はいつでもサブスクライブ解除できます。 通知設定ページの Organization alerts で、 [メール] を選択解除します。