GitHubイベントの種類

Events API は、GitHubのアクティビティによってトリガーされるさまざまな種類のイベントを返すことができます。各イベントの応答には共有プロパティが含まれますが、イベントの種類によって決まる固有の payload オブジェクトがあります。イベントオブジェクトの共通プロパティは、すべてのイベントで共有されるプロパティを表し、各イベントの種類は、特定のイベントに固有の payload プロパティを表します。

イベントオブジェクトの共通プロパティ

Events APIエンドポイントから返されるイベントオブジェクトは、同じ構造を持ちます。

Event API属性名	タイプ	説明
`id`	`integer`	イベントの一意識別子。
`type`	`string`	イベントの種類。イベントの名前にはPascalCaseが使われます。
`actor`	`object`	イベントをトリガーしたユーザ。
`actor.id`	`integer`	アクターの一意の識別子。
`actor.login`	`string`	アクターのユーザ名。
`actor.display_login`	`string`	ユーザ名に特定の表示形式。
`actor.gravatar_id`	`string`	アクターのGravatarプロフィールの一意の識別子。
`actor.url`	`string`	追加のユーザ情報を含むユーザオブジェクトの取得に使われるREST APIのURL。
`actor.avatar_url`	`string`	アクターのプロフィール画像のURL。
`repo`	`object`	イベントが発生したリポジトリオブジェクト。
`repo.id`	`integer`	リポジトリの一意の識別子。
`repo.name`	`string`	リポジトリの名前。オーナーとリポジトリの名前が含まれる。たとえば、`octocat/hello-world` は、`hello-world` 個人用アカウントが所有する `octocat` リポジトリの名前です。
`repo.url`	`string`	追加のリポジトリ情報を含むリポジトリオブジェクトの取得に使われるREST APIのURL。
`payload`	`object`	イベントの種類に固有のイベントペイロードオブジェクト。イベント API `payload` オブジェクトについては、以下のイベントの種類を参照してください。
`public`	`boolean`	イベントがすべてのユーザーに表示されるかどうか。
`created_at`	`string`	イベントがトリガーされた日時。 ISO 8601 に従って形式設定されています。
`org`	`object`	イベントをトリガーするアクションを実行するためにアクターによって選択された組織。

          _このプロパティは、該当する場合にのみイベント オブジェクトに表示されます。_ |

WatchEventイベントのオブジェクトの例

この例では、Events API を使用するときの WatchEvent 応答の形式を示します。

HTTP/2 200
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"

[
  {
    "id": "12345",
    "type": "WatchEvent",
    "actor": {
      "id": 1,
      "login": "octocat",
      "display_login": "octocat",
      "gravatar_id": "",
      "url": "https://api.github.com/users/octocat",
      "avatar_url": "https://github.com/images/error/octocat_happy.gif"
    },
    "repo": {
      "id": 3,
      "name": "octocat/Hello-World",
      "url": "https://api.github.com/repos/octocat/Hello-World"
    },
    "payload": {
      "action": "started"
    },
    "public": false,
    "created_at": "2011-09-06T17:26:27Z",
    "org": {
      "id": 1,
      "login": "github",
      "gravatar_id": "",
      "url": "https://api.github.com/orgs/github",
      "avatar_url": "https://github.com/images/error/octocat_happy.gif"
    },
  }
]

CommitCommentEvent

コミットコメントが作成されました。アクティビティの種類は、ペイロードオブジェクトの action プロパティで指定されます。詳細については、「コミットコメント用 REST API エンドポイント」を参照してください。

イベントオブジェクトには、すべてのイベントに共通するプロパティが含まれています。各イベントオブジェクトには payload プロパティが含まれており、その値は各イベントの種類に固有です。このイベントの payload オブジェクトを以下に示します。

CommitCommentEvent のイベント `payload` オブジェクト

キー	タイプ	説明
`action`	`string`	実行されるアクション。

          `created` の可能性があります。

| | comment|object | 「コミットのコメント」リソース。

CreateEvent

Gitブランチもしくはタグが作成されました。詳しくは、「Git データベース用 REST API エンドポイント」をご覧ください。

CreateEvent のイベント `payload` オブジェクト

キー	タイプ	説明
`ref`	`string`

          [
          `git ref`
          ](/rest/git#get-a-reference) リソース ブランチ。`null`が`ref_type`されている場合は`repository`。

DeleteEvent

Gitブランチまたはタグが削除されました。詳細については、「Git データベース用 REST API エンドポイント」の REST API を参照してください。

DeleteEvent のイベント `payload` オブジェクト

キー	タイプ	説明
`ref`	`string`

          [
          `git ref`
          ](/rest/git#get-a-reference) リソース部門。

ディスカッションイベント

ディスカッションがリポジトリに作成されます。詳しくは、「GitHub Discussions のドキュメント」をご覧ください。

DiscussionEvent 用のイベント `payload` オブジェクト

Key	タイプ	Description
`action`	`string`	実行されるアクション。

          `created` の可能性があります。

discussion|object| 作成されたディスカッション。

ForkEvent

ユーザがリポジトリをフォークします。詳しくは、「リポジトリの REST API エンドポイント」をご覧ください。

ForkEvent のイベント `payload` オブジェクト

キー	タイプ	説明
`action`	`string`	実行されるアクション。

          `forked` の可能性があります。

| | forkee|object | 作成された repository リソース。

GollumEvent

データ再利用可能.webhooks.gollum_short_desc %}

GollumEvent のイベント `payload` オブジェクト

キー	タイプ	[説明]
`pages`	`array`	更新されたページ。
`pages[][page_name]`	`string`	ページの名前です。
`pages[][title]`	`string`	現在のページタイトル。
`pages[][summary]`	`string`	ページに関する省略可能なメモ。

          `null` の可能性があります。

IssueCommentEvent

IssueあるいはPull Requestコメントに関連するアクティビティ。アクティビティの種類は、ペイロードオブジェクトの action プロパティで指定されます。詳細については、「問題用の REST API エンドポイント」を参照してください。

IssueCommentEvent のイベント `payload` オブジェクト

キー	タイプ	説明
`action`	`string`	コメント上で実行されたアクション。

          `created` の可能性があります。

issue | object | コメントが属する Issue。

          `comment`
          |
          `object` | [コメント](/rest/issues#comments)自体。

IssuesEvent

Issueに関連するアクティビティ。アクティビティの種類は、ペイロードオブジェクトの action プロパティで指定されます。詳細については、「問題用の REST API エンドポイント」を参照してください。

IssuesEvent のイベント `payload` オブジェクト

キー	タイプ	[説明]
`action`	`string`	実行されたアクション。

          `opened`、`closed`、`reopened`のいずれかです。

          `assignees`
          |
          `array` |問題に関する担当者の詳細を示す、割り当て先オブジェクトの省略可能な配列。
          `label`              |              `object` | 問題に追加されたまたは問題から削除されるオプションのラベル。

          `labels`
          |
          `array` |問題のラベルを記述するラベル オブジェクトの省略可能な配列。

MemberEvent

リポジトリのコラボレータに関連するアクティビティ。アクティビティの種類は、ペイロードオブジェクトの action プロパティで指定されます。詳細については、「コラボレーターの REST API エンドポイント」を参照してください。

MemberEvent のイベント `payload` オブジェクト

キー	Type	[説明]
`action`	`string`	実行されたアクション。ユーザーがリポジトリへの招待を承認したことを示す、`added` を指定できます。
`member`

          |
          `object` | 追加された[ユーザー](/rest/users)。

PublicEvent

プライベートリポジトリがパブリックにされたとき。

PublicEvent のイベント `payload` オブジェクト

このイベントでは、空の payload オブジェクトが返されます。

PullRequestEvent

Pull Requestに関連するアクティビティ。アクティビティの種類は、ペイロードオブジェクトの action プロパティで指定されます。詳細については、「Pull request 用 REST API エンドポイント」を参照してください。

PullRequestEvent のイベント `payload` オブジェクト

キー	タイプ	[説明]
`action`	`string`	実行されたアクション。

          `opened`、`closed`、`merged`、`reopened`、`assigned`、`unassigned`、`labeled`、`unlabeled` のいずれかになります。

| | number | integer | pull request 番号。

          `pull_request`
          |
          `object` | [プルリクエスト](/rest/pulls) 自体。

| | assignee|object | 問題に割り当てられる、または割り当て解除される省略可能なユーザー。

          `assignees`
          |
          `array` |問題に関する担当者の詳細を示す、割り当て先オブジェクトの省略可能な配列。

          `label`
          |
          `object` | アクションが `labeled` または `unlabeled`された場合に問題から追加または削除された省略可能なラベル。

          `labels`
          |
          `array` |アクションが `labeled` または `unlabeled`された場合にプル要求のラベルを記述するラベル オブジェクトの省略可能な配列。

PullRequestReviewEvent

Pull Requestレビューに関連するアクティビティ。アクティビティの種類は、ペイロードオブジェクトの action プロパティで指定されます。詳細については、「Pull request 用 REST API エンドポイント」を参照してください。

PullRequestReviewEvent のイベント `payload` オブジェクト

Key	タイプ	Description
`action`	`string`	実行されたアクション。

          `created`、`updated`、または `dismissed` を指定できます。

PullRequestReviewCommentEvent

Pull Requestの統合diff中のPull Requestレビューコメントに関連するアクティビティ。アクティビティの種類は、ペイロードオブジェクトの action プロパティで指定されます。詳細については、「Pull request 用 REST API エンドポイント」を参照してください。

PullRequestReviewCommentEvent のイベント `payload` オブジェクト

キー	Type	説明
`action`	`string`	コメント上で実行されたアクション。 `created` の可能性があります。
`pull_request`

          |
          `object` | コメントが属する [pull request](/rest/pulls)。

          `comment`
          |
          `object` | [コメント](/rest/pulls#comments) 自体。

PushEvent

リポジトリのブランチもしくはタグに、1つ以上のコミットがプッシュされました。

PushEvent のイベント `payload` オブジェクト

Key	タイプ	Description
`repository_id`	`integer`	プッシュが発生したリポジトリのユニーク識別子。
`push_id`	`integer`	プッシュ用のユニークな識別子。
`ref`	`string`	プッシュされた完全な `git ref`。例: `refs/heads/main`。
`head`	`string`	プッシュ後の `ref` に対する最新のコミットの SHA。
`before`	`string`	プッシュ前の `ref` に対する最新のコミットの SHA。

ReleaseEvent

リリースに関連するアクティビティ。アクティビティの種類は、ペイロードオブジェクトの action プロパティで指定されます。詳細については、「リリースとリリース資産の REST API エンドポイント」の REST API を参照してください。

ReleaseEvent のイベント `payload` オブジェクト

キー	Type	[説明]
`action`	`string`	実行されたアクション。 `published` の可能性があります。
`release`

          |
          `object` | [リリース](/rest/releases/releases#get-a-release) オブジェクト。

WatchEvent

誰かがリポジトリにStarを付けたとき。アクティビティの種類は、ペイロードオブジェクトの action プロパティで指定されます。詳細については、「アクティビティ用 REST API エンドポイント」を参照してください。

WatchEvent のイベント `payload` オブジェクト

キー	Type	[説明]
`action`	`string`	実行されたアクション。現時点では、`started` のみが可能です。

この記事で