GitHub Marketplace入門:開発者向けアプリとツールの公開方法を徹底解説

自作のGitHub Marketplaceアプリで、開発者のワークフローをもっと便利にしたいと考えていませんか?GitHub Marketplaceは、無料・有料の各種ツールを開発者が利用できる公式マーケットプレイスです。プラットフォームでは「Actions」や「Apps」など複数の種類のツールが提供されており、それぞれ登録・公開までの手順が異なります。本記事では、GitHub Marketplaceを使い始めるための基本ステップをわかりやすく解説します。

パブリッシャー確認(Publisher Verification)の申請

まずはパブリッシャー確認の申請から始めましょう。GitHub画面の右上にあるプロフィール写真をクリックし、「Your organizations(自分の組織)」を選択します。次に、対象の組織の横にある「Settings(設定)」をクリックします。左側のサイドバーから「Developer settings(開発者設定)」を開き、「Developer settings」配下の「Publisher Verification(パブリッシャー確認)」を選択してください。チェックリストに記載された必要事項をすべて入力したら、「Request Verification(確認をリクエスト)」をクリックします。その後、GitHub側で内容が審査され、パブリッシャー確認が完了すると通知が届きます。

リスティングのメトリクスを確認する

GitHub Marketplace Insightsにアクセスするには、サイト右上のプロフィール写真をクリックし、ドロップダウンメニューから「Settings(設定)」を選択します。続いて、左側のサイドバーメニューで「Developer settings(開発者設定)」をクリックしましょう。

管理したいMarketplaceリスティングに応じて、「OAuth Apps」または「GitHub Apps」を選択します。アプリの設定ページを下にスクロールし、Marketplaceセクションにある「List in Marketplace(Marketplaceに掲載)」をクリックしてください。すでにMarketplaceの下書きリスティングを作成済みの場合は、「Edit Marketplace listing(Marketplaceリスティングを編集)」を選びます。

「Insightsタブ」を開くと、ページ右上の「Period(期間)」ドロップダウンから任意の期間を選択して、各種メトリクスを確認できます。

リスティングの取引情報を確認する

GitHub Marketplaceの取引履歴を確認する場合も、まず任意のページ右上でプロフィール写真をクリックし、「Settings(設定)」→左サイドバーの「Developer settings(開発者設定)」と進みます。

左サイドバーで、管理対象のMarketplaceリスティングに応じて「OAuth Apps」または「GitHub Apps」を選択します。GitHub Marketplace用のアプリを作成している場合は、取引を確認したい「GitHub App」を選択してください。

アプリの設定ページを下へスクロールしてMarketplaceセクションを表示し、「List in Marketplace」をクリックします。すでにMarketplaceの下書きがある場合は「Edit Marketplace listing」を選びましょう。なお、アプリ登録時に「どのユーザーや組織でもインストール可能」と設定していない場合、このMarketplaceセクションは表示されない点に注意が必要です。

続いて「Transactionタブ」を開きます。Transactionsページ右上の「Period(期間)」ドロップダウンから、任意の期間を選択することも可能です。

アプリのテストを行う

GitHub Marketplaceでは、リスティングを下書き状態のまま保存し、実際の課金フローをシミュレーションできます。テストシナリオによっては、無料トライアル付きのプランを用意したり、無料プランと有料プランを切り替えたりする必要もあるでしょう。

GitHubには開発者専用の「Apply Pending Change(保留中の変更を適用)」機能が用意されています。下書きのMarketplaceリスティングを作成したうえで、保留サイクルページ(https://github.com/settings/billing#pending-cycle:)からアクセスできます。

アプリのリスティング下書きを作成する

左サイドバーの「Developer settings(開発者設定)」セクションをクリックします。続いて、GitHub Marketplaceで公開するアプリの種類に応じて「OAuth Apps」または「GitHub Apps」を選択し、Marketplaceに追加したいアプリを選びましょう。

アプリの設定ページを下にスクロールし、Marketplaceセクションの「List in Marketplace」をクリックします。すでに下書きリスティングを作成済みであれば、その内容を編集できます。

下書きリスティングを作成すると、GitHub Marketplaceでの公開完了までに埋めるべき各セクションの概要が表示されます。順番に項目を完成させていきましょう。

リスティングの料金プランを設定する

GitHub Marketplaceリスティングの料金プランを作成するには、リスティングページの左サイドバーにある「Plans and pricing(プランと料金)」をクリックします。

料金プランが不要になった場合や、価格の詳細を調整したい場合は、プランを削除して再設定することも可能です。

リスティングを公開に向けて申請する

アプリのリスティングがGitHub Marketplaceの要件を満たしたら、いよいよ申請です。アプリのリスティングページ左上にある「Overview(概要)」をクリックします。

完成したリスティングを提出するには、「Request review(レビューをリクエスト)」をクリックします。その後、GitHubのオンボーディング担当者から追加情報について連絡が届きます。

まとめ

GitHub Marketplaceは、無料・有料の豊富なツールやアプリケーションを通じて、開発者がソフトウェアプロジェクトのワークフローを拡張・改善できるオープンなプラットフォームです。あなたが公開したツールによって他の開発者の作業がどう改善されたのか、ぜひ体験談を聞かせてください。これからGitHubを学び始めたばかりの方には、シリーズ記事「Getting Started with GitHub – Hello World」「同 – ソース管理の基礎」「同 – 無料アカウントと有料アカウントの違い」「同 – 役立つTips & Tricks」、そしてWindowsアプリの収益化に役立つ「Getting Started with GitHub Sponsors Program」もおすすめです。GitHub Marketplaceの詳細については、公式ドキュメントをご覧ください。