Webhook のタイプについて
Webhook は、リポジトリ、組織、 GitHub Enterprise、 、またはインストールされている GitHub App で使用可能なイベントにのみアクセスできます。
個々のユーザー アカウント、または個人の通知やメンションなどのユーザー リソースに固有のイベントに対して Webhook を作成することはできません。
Webhook を作成および管理するには、Webhook が作成され、イベントをリッスンしているリソースを所有しているか、そのリソースへの管理者アクセス権を持っている必要があります。 たとえば、組織内の Webhook を管理するには、その組織の管理者権限が必要です。
一部の Webhook イベントは、特定の種類の Webhook に固有です。 たとえば、組織の Webhook は、リポジトリ Webhook がサブスクライブできない組織レベルでのみ発生するイベントにサブスクライブできます。 各 Webhook 特有の可用性に関する詳細については、「Webhook のイベントとペイロード」を参照してください。
詳しくは、「webhook について」をご覧ください。
リポジトリウェブフック
リポジトリ内に Webhook を作成すると、そのリポジトリ内で発生するイベントにサブスクライブできます。 リポジトリに Webhook を作成するには、そのリポジトリのオーナーであるか、リポジトリの管理者アクセス権を持っている必要があります。 必要なアクセス許可がないリポジトリで Webhook を作成、編集、または削除することはできません。
1 つのリポジトリに複数の Webhook を作成できます。 ただし、各イベントタイプをサブスクライブする Webhook は、250 個までしか作成できません。 たとえば、1 つのリポジトリでは、push イベントを購読する異なる webhook を最大 250 個までしか作成できません。
GitHub Web インターフェイスまたは REST API を使用して、リポジトリ Webhook を管理できます。 詳細については、「webhookの作成」、「webhookの編集」、「Webhook を無効にする」を参照してください。 REST API を使用してリポジトリ Webhook を管理する方法の詳細については、「リポジトリ ウェブフック の REST API エンドポイント」を参照してください。
組織のウェブフック
組織内に Webhook を作成すると、その組織内で発生するイベントにサブスクライブできます。 組織の Webhook は、組織が所有するすべてのリポジトリで発生するイベントにサブスクライブできます。 また、新しいメンバーが組織に追加されたときなど、所定のリポジトリの外部にある組織レベルで発生するイベントにサブスクライブすることもできます。
組織で Webhook を作成および管理するには、その組織のオーナーである必要があります。
1 つの組織で複数の Webhook を作成できます。 ただし、各イベントタイプに対して、それぞれをサブスクライブするWebhookは 250 個までしか作成できません。 たとえば、1 つの組織では、push イベントを購読する Webhook を、それぞれ異なるものとして最大 250 個までしか作成できません。
GitHub Web インターフェイスまたは REST API を使用して、組織の Webhook を管理できます。 詳細については、「webhookの作成」、「webhookの編集」、「Webhook を無効にする」を参照してください。 REST API を使用して organization の Webhook を管理する方法の詳細については、「組織の Webhook の REST API エンドポイント」を参照してください。
GitHub Enterprise 用のグローバル Webhook
企業のオーナーは、グローバル Webhook を作成して、企業内で発生するイベント、組織内で発生するイベント、および企業が所有するリポジトリにサブスクライブできます。
1 つの企業で複数の Webhook を作成できます。 ただし、各イベントタイプをサブスクライブするWebhookは、個別のイベントタイプごとに最大250個までしか作成できません。 たとえば、1つのエンタープライズでは、membership イベントをサブスクライブする異なる webhook を 250 個までしか作成できません。
GitHub Web インターフェイスを使用して、グローバル Webhook を管理できます。 詳細については、「webhookの作成」、「webhookの編集」、「Webhook を無効にする」を参照してください。 REST API を使用してグローバル Webhook を管理することもできます。 エンドポイントの完全な一覧については、「グローバル Webhook の REST API エンドポイント」を参照してください。
GitHub App webhooks
アプリに対するアクセス権が付与されているリポジトリまたは組織で特定のイベントが発生したときに Webhook を受信するように GitHub App を構成できます
各 GitHub App には、 GitHubによって自動的に作成される 1 つの Webhook があります。 既定では、Webhook はどのイベントにもサブスクライブしません。 Webhook がサブスクライブするイベントを構成できます。 GitHub App webhook は削除できませんが、webhook 配信の受信を停止するために無効にすることはできます。
GitHub Web インターフェイスまたは REST API を使用して、GitHub App Webhook を管理できます。 詳細については、「webhookの作成」、「webhookの編集」、「Webhook を無効にする」を参照してください。 REST API を使用して webhook GitHub App 管理する方法の詳細については、 GitHub App Webhook の REST API エンドポイント を参照してください。