GitHubの非同期マージAPIが一般提供開始GitHub async merge API generally available
匿名の公開いいねです。記事の保存・お気に入りではなく、Featured、Top 3、重要度、掲載順位には影響しません。仕組みとプライバシーAnonymous public likes are reactions, not saved articles or bookmarks. They do not affect Featured, Top 3, importance, or listing order.How it works and privacy
- GitHubの非同期マージAPIが一般提供となり、単独またはスタックされたプルリクエストの処理、マージキューへの追加、直接マージに対応した。
- 結果をポーリングで確認でき、混雑したリポジトリでも自動化を効率よく運用できる。
GitHub's asynchronous merge API is now generally available for single or stacked pull requests, merge queues, and direct merges, keeping automation responsive in busy repositories.
本ページの本文と要約は AI による自動生成です。日本語版と英語版は言語ごとに独立して生成されるため、表現や詳しさが異なる場合があります。正確性は元記事 (github.blog) をご確認ください。The body and summaries are AI-generated independently for each language, so wording and detail may differ. Verify accuracy at the original source (github.blog).
要約と収集メタデータに基づく AI 解説。元記事全文の転載・翻訳ではありません。AI explainer based on the summaries and collected metadata, not a copy or translation of the full source article.
GitHubの非同期マージAPIが一般提供となった。単独またはスタックされたプルリクエストを扱え、混雑したリポジトリでマージ処理を自動化する際に、複雑な処理の完了を一つのリクエスト内で待たずに済む。
一般提供開始
非同期マージAPIでは、個別のプルリクエストと、複数を積み重ねたスタック形式のプルリクエストをマージできる。スタックされたプルリクエストをサポートするマージAPIは、この非同期マージAPIのみと説明されている。
マージキュー
処理方法としては、プルリクエストをマージキューへ追加する方法と、直接マージする方法の両方に対応する。また、必要な権限を持っている場合は、ルールを任意でバイパスすることも可能とされる。単独のプルリクエストだけでなく、異なるマージ方法を同じAPIから扱える構成だ。
PUTとGET
利用時は、まずPUTでマージリクエストを送信する。APIから返されたリクエストIDを使い、その後はGETによるポーリングで処理状況を確認する。マージ自体が非同期で進むため、自動化処理は、一回のリクエストで複雑なマージが終了するまで待機する必要がない。これにより、処理が集中するリポジトリでも自動化を応答可能な状態に保ちやすい。
推奨API
プルリクエストをプログラムからマージする場合、非同期マージAPIが推奨される経路となった。従来の同期RESTエンドポイントやGraphQL mutationsの代わりに利用する位置付けで、リクエストパラメーターと使用例は非同期マージAPIのドキュメントで確認できる。
Generally available
GitHub’s async merge API is now generally available for programmatically merging pull requests. It matters for automations operating in busy repositories because merge processing happens asynchronously, so they do not have to wait for a complex merge to finish within a single request.
The API can handle individual pull requests, stacked pull requests, merge-queue operations, and direct merges. It can also optionally bypass rules when the caller has the required permission.
Individual or stacked pull requests
The API supports merging either a single pull request or a stack of pull requests. It is the only GitHub merge API identified as supporting stacked pull requests.
Automations can also use the API to add pull requests to a merge queue. Alternatively, they can request that pull requests be merged directly. These options place individual, stacked, queued, and direct merge workflows within the same asynchronous API.
Processes merges asynchronously
Using the API involves submitting a merge request with PUT. GitHub returns a request ID, which the automation can then use when polling with GET to check the merge request’s status.
This request-and-polling model avoids requiring a complex merge to complete as part of one request. As a result, automations can continue handling work in busy repositories while GitHub processes the merge asynchronously, then check the result through subsequent status requests.
Recommended path
The async merge API is now GitHub’s recommended path for programmatic pull-request merging. It replaces the synchronous REST endpoint or GraphQL mutations as the recommended approach.
GitHub’s async merge API documentation provides the available request parameters and examples for implementing the workflow.
ポコとTECHガイドPoko & TECH Guide
ポコと当サイトのTECHガイドが、記事の要約と収集した情報から読みどころを語るAI生成の対話です。Poko and TECH Dashboard's own TECH Guide discuss the article's highlights in an AI-generated conversation based on its summary and collected source details.
- ポコPoko混み合うリポジトリでマージを自動化していると、普段の作業はどう変わるの？If merges are automated in a busy repository, how does this change the day-to-day workflow?
- TECHガイドTECH Guide複雑なマージの完了を1回のリクエスト内で待たず、自動化を応答しやすく保てるよ。PUTで依頼し、返ったIDをGETで確認するんだ。Automation no longer has to wait for a complex merge to finish in one request. Send it with PUT, then use the returned ID to check the status with GET.
- ポコPoko前のAPIではできなかったの？ 待つ仕組みだったのかな。Couldn’t the previous APIs do that? Did they have to wait for the merge?
- TECHガイドTECH Guide従来の選択肢は同期RESTエンドポイントやGraphQLミューテーションだったよ。スタックされたプルリクエストに対応するマージAPIは、これだけなんだ。The previous options were the synchronous REST endpoint and GraphQL mutations. This is the only merge API that supports stacked pull requests.
- ポコPokoいちばんの収穫は、マージ依頼と結果確認を分けて、混雑時も自動化を動かしやすくできることなんだね。So the big takeaway is that separating the merge request from the status check helps automation stay responsive when repositories are busy.
- TECHガイドTECH Guideそうだね。次はドキュメントでリクエストのパラメータと例を確認したいね。Right. Next, it’s worth checking the documentation for request parameters and examples.
