URL パラメータを使用して GitHub App を作成する

GitHub App URL パラメータについて

個人または Organization アカウントで、GitHub App の構成を事前設定する以下の URL をクエリパラメータに追� できます。

• Personal account: http(s)://[hostname]/settings/apps/new
• Organization アカウント: http(s)://[hostname]/organizations/:org/settings/apps/new

アプリケーションを作成するユーザは、アプリケーションをサブミットする前に GitHub App 登録ページから事前設定する値を編集できます。 URL クエリ文字列に name などの必� �の値を含めない� �合、アプリケーションを作成するユーザが、アプリケーションをサブミットする前に値を入力する必要があります。

以下の URL は、説明とコールバック URL が事前設定された、octocat-github-app という新しい公開アプリケーションを作成します。 また、この URL はchecks の読み取りおよび書き込み権限を選択し、check_run および check_suite webhook イベントにサブスクライブし、インストール時にユーザの認可 (OAuth) をリクエストするオプションを選択します。

http(s)://[hostname]/settings/apps/new?name=octocat-github-app&description=An%20Octocat%20App&callback_urls[]=https://example.com&request_oauth_on_install=true&public=true&checks=write&events[]=check_run&events[]=check_suite

使用可能なクエリパラメータ、権限、およびイベントの完全なリストを、以下のセクションに記載します。

GitHub App configuration parameters

名前	種類	説明
name	string	GitHub App の名前。 アプリケーションには簡潔で明快な名前を付けましょう。 アプリケーションの名前は、既存の GitHub ユーザと同じ名前にできません。た� し、その名前があなた自身のユーザ名や Organization 名である� �合は例外です。 インテグレーションが動作すると、ユーザインターフェース上にアプリケーション名のスラッグが表示されます。
説明	string	GitHub App の説明。
url	string	GitHub App のホー� ページの完全な URL。
callback_urls	array of strings	インストールの承認後にリダイレクトする完全な URL。 最大 10 個のコールバック URL を指定できます。 この URL は、アプリケーションがユーザからサーバへのリクエストを識別して承認する必要がある� �合に使用されます。 たとえば、callback_urls[]=https://example.com&callback_urls[]=https://example-2.comなどです。
request_oauth_on_install	boolean	アプリケーションが OAuth フローを使用してユーザを認可する� �合、このオプションを true にして、インストール時にアプリケーションを認可し、ステップを省略するように設定できます。 このオプションを選択した� �合、setup_url が利用できなくなり、アプリケーションのインストール後はあなたが設定した callback_url にリダイレクトされます。
setup_url	string	GitHub App アプリケーションをインストール後に追� セットアップが必要な� �合に、リダイレクトする完全な URL。
setup_on_update	boolean	true に設定すると、たとえばリポジトリが追� や削除された後など、インストールしたアプリケーションが更新された� �合に、ユーザをセットアップ URL にリダイレクトします。
public	boolean	GitHub App を公開する� �合には true に、アプリケーションの所有者のみがアクセスできるようにするには false を設定。
webhook_active	boolean	Set to false to disable webhook. Webhook is enabled by default.
webhook_url	string	webhook イベントペイロードを送信する完全な URL。
webhook_secret	string	webhook を保護するためのシークレットを指定できます。 詳細は「webhook を保護する」を参照。
events	array of strings	webhook イベント. 一部の webhook イベントでは、新しい GitHub App を登録する際、イベントを選択するためにread または write 権限が必要です。 利用可能なイベントと、それに必要な権限については、「GitHub App webhook イベント」セクションを参照してく� さい。 クエリ文字列では、複数のイベントを選択できます。 For example, events[]=public&events[]=label.
ドメイン	string	The URL of a content reference.
single_file_name	string	これは、アプリケーションが任意のリポジトリの単一のファイルにアクセスできるようにするための、スコープの狭い権限です。 single_file 権限を read または write に設定すると、このフィールドは GitHub App が扱う単一のファイルへのパスを指定します。 複数のファイルを扱う必要がある� �合、以下の single_file_paths を参照してく� さい。
single_file_paths	array of strings	アプリケーションが、リポジトリ内の指定した最大 10 ファイルにアクセスできるようにします。 single_file 権限を read または write に設定すると、この配列は GitHub App が扱う最大 10 個のファイルへのパスを� �納できます。 これらのファイルには、それぞれ別々の権限があたえられるでのではなく、すべて single_file が設定したものと同じ権限が与えられます。 2 つ以上のファイルが設定されている� �合、API は multiple_single_files=true を返し、それ以外の� �合は multiple_single_files=false を返します。

GitHub App の権限

以下の表にある権限名をクエリパラメータ名として、権限タイプをクエリの値として使用することで、クエリ文字列で権限を設定できます。 たとえば、contents のユーザインターフェースに Read & write 権限を設定するには、クエリ文字列に &contents=write を含めます。 blocking のユーザインターフェースに Read-only 権限を設定するには、クエリ文字列に &blocking=read を含めます。 checks のユーザインターフェースに no-access を設定するには、クエリ文字列に checks 権限を含めないようにします。

権限	説明
administration	Organization およびリポジトリ管理のためのさまざまなエンドポイントにアクセス権を付与します。 none、read、write のいずれかです。
checks	Checks API へのアクセス権を付与します。 none、read、write のいずれかです。
content_references	「コンテンツ添付の作成」エンドポイントへのアクセス権を付与します。 none、read、write のいずれかです。
contents	さまざまなエンドポイントにアクセス権を付与し、リポジトリのコンテンツを変更できるようにします。 none、read、write のいずれかです。
deployments	Deployments API へのアクセス権を付与します。 none、read、write のいずれかです。
emails	Emails API へのアクセス権を付与します。 none、read、write のいずれかです。
followers	Followers API へのアクセス権を付与します。 none、read、write のいずれかです。
gpg_keys	GPG Keys API へのアクセス権を付与します。 none、read、write のいずれかです。
issues	Issues API へのアクセス権を付与します。 none、read、write のいずれかです。
keys	Public Keys API へのアクセス権を付与します。 none、read、write のいずれかです。
members	Organization のメンバーへのアクセス権を付与します。 none、read、write のいずれかです。
organization_hooks	Organization Webhooks API へのアクセス権を付与します。 none、read、write のいずれかです。
organization_plan	「Organization の取得」エンドポイントを使用して Organization のプランについての情� �を取得するためのアクセス権を付与します。 none、read のいずれかです。
organization_projects	Projects API へのアクセス権を付与します。 none、read、write、admin のいずれかです。
pages	Pages API へのアクセス権を付与します。 none、read、write のいずれかです。
plan	「ユーザの取得」エンドポイントを使用してユーザの GitHub プランについての情� �を取得するためのアクセス権を付与します。 none、read のいずれかです。
pull_requests	さまざまなプルリクエストエンドポイントへのアクセス権を付与します。 none、read、write のいずれかです。
repository_hooks	Repository Webhooks API へのアクセス権を付与します。 none、read、write のいずれかです。
repository_projects	Projects API へのアクセス権を付与します。 none、read、write、admin のいずれかです。
secret_scanning_alerts	Secret scanning API へのアクセス権を付与します。 none、read、write のいずれかです。
security_events	Code scanning API へのアクセス権を付与します。 none、read、write のいずれかです。
single_file	Contents API へのアクセス権を付与します。 none、read、write のいずれかです。
starring	Starring API へのアクセス権を付与します。 none、read、write のいずれかです。
statuses	Statuses API へのアクセス権を付与します。 none、read、write のいずれかです。
team_discussions	Team Discussions API および Team Discussion Comments API へのアクセス権を付与します。 none、read、write のいずれかです。
vulnerability_alerts	Grants access to receive Dependabotアラート in a repository. See "About Dependabotアラート" to learn more. none、read のいずれかです。
Watch	リストへのアクセス権を付与し、ユーザがサブスクライブするリポジトリの変更を許可します。 none、read、write のいずれかです。

GitHub App webhook イベント

Webhook イベント名	必要な権限	説明
check_run	checks	チェックランのアクティビティが発生しました。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「check runs」 REST APIを参照してく� さい。
check_suite	checks	チェックスイートのアクティビティが発生しました。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「check suites」 REST APIを参照してく� さい。
commit_comment	contents	コミットコメントが作成されました。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「コミットコメント」 REST APIを参照してく� さい。
content_reference	content_references	新しいコンテンツ参照が作成されました。 新しいコンテンツ参照は、IssueもしくはPull Requestのボディあるいはコメントが、設定されたコンテンツ参照ドメインにマッチする� �合に作成されます。 詳しい情� �については「コンテンツの添付ファイルの使用」を参照して、コンテンツ参照と添付ファイルについて学んでく� さい。
create	contents	Gitブランチもしくはタグが作成されました。 For more information, see the "Git database" REST API.
delete	contents	Gitブランチまたはタグが削除されました。 For more information, see the "Git database" REST API.
deployment	deployments	デプロイメントが作成されました。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「デプロイメント」 REST APIを参照してく� さい。
deployment_status	deployments	デプロイメントが作成されました。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 For more information, see the "deployments" REST API.
フォーク	contents	ユーザがリポジトリをフォークします。 詳しい情� �については「forks」 REST APIを参照してく� さい。
gollum	contents	wikiページが作成もしくは更新されました。 詳細は「ウィキについて」を参照してく� さい。
issues	issues	Issueに関連するアクティビティ。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「Issue」 REST APIを参照してく� さい。
issue_comment	issues	IssueあるいはPull Requestコメントに関連するアクティビティ。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「Issueコメント" REST APIを参照してく� さい。
ラベル	メタデータ	ラベルに関連するアクティビティ。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「ラベル」 REST APIを参照してく� さい。
メンバー	members	リポジトリのコラボレータに関連するアクティビティ。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「コラボレータ」 REST APIを参照してく� さい。
membership	members	Teamのメンバーシップに関連するアクティビティ。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「Teamメンバー」 REST APIを参照してく� さい。
マイルストーン	pull_request	マイルストーンに関連するアクティビティ。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「マイルストーン」 REST APIを参照してく� さい。
Organization	members	Organization及びそのメンバーと関連するアクティビティ。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「Organization」 REST APIを参照してく� さい。
page_build	pages	成功か否かにかかわらず、GitHub Pagesサイトの試行されたビルドを表します。 GitHub Pagesが有効化されたブランチ（プロジェクトのPagesならgh-pages、ユーザ及びOrganizationのPagesならデフォルトブランチ）へのプッシュがこのイベントをトリガーします。
project	repository_projects または organization_projects	プロジェクトボードに関連するアクティビティ。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「プロジェクト」 REST APIを参照してく� さい。
project_card	repository_projects または organization_projects	プロジェクトカードに関連するアクティビティ。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「プロジェクトカード」 REST APIを参照してく� さい。
project_column	repository_projects または organization_projects	プロジェクトボード内の列に関連するアクティビティ。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「プロジェクトの列」 REST APIを参照してく� さい。
public	メタデータ	プライベートリポジトリがパブリックにされたとき。 間違いなく: 最高のGitHub Enterprise Serverイベント。
pull_request	pull_requests	Pull Requestに関連するアクティビティ。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「Pull Request」 REST APIを参照してく� さい。
pull_request_review	pull_request	Pull Requestレビューに関連するアクティビティ。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「Pull Requestレビュー」 REST APIを参照してく� さい。
pull_request_review_comment	pull_request	Pull Requestの統合diff中のPull Requestレビューコメントに関連するアクティビティ。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「Pull Requestのレビューコメント」 REST APIを参照してく� さい。
pull_request_review_thread	pull_request	Activity related to a comment thread on a pull request being marked as resolved or unresolved. アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。
プッシュ	contents	リポジトリのブランチもしくはタグに、1つ以上のコミットがプッシュされました。
リリース	contents	リリースに関連するアクティビティ。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「リリース」 REST APIを参照してく� さい。
リポジトリ	メタデータ	リポジトリに関連するアクティビティ。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「リポジトリ」 REST APIを参照してく� さい。
ステータス	statuses	Gitコミットのステータスが変化したとき。 For more information, see the "statuses" REST API.
Team	members	OrganizationのTeamに関連するアクティビティ。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「Team」 REST APIを参照してく� さい。
team_add	members	リポジトリがTeamに追� された。
Watch	メタデータ	誰かがリポジトリにStarを付けたとき。 アクティビティのタイプは、ペイロードオブジェクトのactionプロパティで指定されます。 詳しい情� �については「Star付け」 REST APIを参照してく� さい。