GitHubをNotionに接続する

GitHubの管理型同期では、選択したプルリクエストやイシュー、またはその両方をNotionに取り込めます。Notionは既存のレコードをインポートし、バックグラウンドでGitHubの更新を確認します。

このガイドでは、GitHubの接続設定にあるデータベース同期について説明します。同期されたプロパティは読み取り専用です。プルリクエストやイシューを変更する場合は、GitHubで行ってください。

GitHub Appをインストールして利用できるリポジトリから、Notionに取り込む対象（プルリクエスト、イシュー、またはその両方）を選択します。選択したリポジトリから、指定した対象のデータがNotionに取り込まれます。

作成者（GitHub）プロパティにはGitHubのユーザー名が含まれます。作成者は、作成者の公開メールアドレスがワークスペースメンバーと一致する場合のNotionのユーザープロパティです。

説明プロパティは、プルリクエストの説明をプレインテキストとして同期し、GitHubに記述された通りにコピーされます。Markdownとしてはレンダリングされません。

GitHubイシューは、単独で同期することも、プルリクエストと合わせて同期することもできます。この同期には、プルリクエストのコメントやレビューの詳細は含まれません。

必要なもの：

• Notionワークスペースへのメンバーシップ。

• 同期したいリポジトリにアクセスできるGitHubアカウント。

• それらのリポジトリにアクセスできるGitHub Appのインストール。

• ビジネスプラン（モバイルビジネスプランも対象）。GitHub同期は他のプランでは利用できません。

GitHubアカウントとアプリのインストールの両方にアクセス権が必要です。GitHub組織によっては、オーナーによるアプリの承認やインストールが必要になる場合があります。

1. Notionで、設定 → コネクション → GitHubの順に開きます。

2. データベース同期を開き、まだ接続していない場合はGitHubアカウントを接続します。

3. GitHubの認証とインストールの手順を完了します。

4. 同期したいリポジトリが含まれる組織またはアカウントを選択します。別のインストールを追加する必要がある場合は、組織を追加…を使用します。

5. 含めるリポジトリを選択します。

6. 同期に名前を付け、Notionに取り込む対象（プルリクエスト、イシュー、またはその両方）を選択します。

7. 利用可能なすべての履歴、または特定の期間の履歴を選択します。

8. Create sync を選択します。

Notionはサイドバーの「プライベート」セクションに同期データベースを作成し、一致するレコードのインポートを開始します。

初回インポート時、Notionは選択した各リポジトリから、同期対象として選んだプルリクエストとイシューを、更新日時が新しいレコードから順に、選択した履歴の範囲にわたって読み込みます。

インポート後、Notionは定期的に各リポジトリをチェックし、新規または更新されたレコードがないか確認します。新しいラベル、プルリクエストのクローズ、イシューの再オープンなどの変更は、Notion内の対応するプロパティに反映されます。

同期はNotionを閉じている間も実行されます。大規模なリポジトリ、GitHubのリクエスト制限、一時的なサービスの問題により、更新が遅れることがあります。同期のステータスを確認して、進捗状況やエラーがないか確認してください。

すべての履歴、過去30日間、過去90日間、または過去365日間から選択します。すべての履歴を同期するオプションがトグルで提供されている場合は、利用可能なすべての履歴を同期をオンのままにすると、利用可能なすべてのプルリクエストが含まれます。

この期間は、プルリクエストの更新日時に基づきます。プルリクエストが作成された日時や、オープン、クローズ、マージのいずれの状態であるかは関係ありません。

例えば、90日以上変更されていないオープンなプルリクエストやイシューは、90日間の対象期間から外れる可能性があります。

設定 → コネクション → GitHub → データベース同期から同期を開きます。

• イシューまたはプルリクエストを追加・削除するには、同期対象を変更して「変更を保存」を選択します。種類を追加すると、該当するレコードがインポートされます。種類を削除すると、その種類のページが削除されます。引き続き同期する種類のインポート済みレコードはそのまま残ります。

• リポジトリを追加: 選択内容を編集して変更を保存を選択します。Notionは、追加されたリポジトリから一致するプルリクエストをインポートします。

• リポジトリを削除: リポジトリの選択を解除して保存します。同期されていたプルリクエストページはNotionから削除されます。

• 変更履歴: ウィンドウを長くすると、追加のレコードがインポートされます。ウィンドウを短くすると、新しいウィンドウの外側にあるレコードが削除されます。

• 更新の一時停止:同期を一時停止を選択します。既存のデータと設定は保持されます。

• 更新の再開:同期を再開を選択して、同期を続行します。

リポジトリを削除したり履歴を短縮したりする前に、影響を受けるページから必要なNotion固有の情報を保存してください。

リポジトリ、状態、作成者、またはラベルごとにビューを作成します。独自のプロパティを追加してリリースの準備状況を追跡したり、プルリクエストやイシューをチームの計画プロセスと連携させたりできます。独自のプロパティ値はNotion内に保持されます。

GitHubプロパティを変更するには、GitHub URLを使用してレコードを開き、GitHubで変更を行ってください。

データベースは最初はプライベートで作成されます。共有する場合、インポートされたデータを誰が閲覧できるかはNotionの共有設定によって決まります。閲覧者全員がソースリポジトリにアクセスできる必要はないため、プライベートリポジトリの情報を共有する前にデータベースの権限を確認してください。

正しいGitHubアカウントとアプリのインストールが選択されていることを確認してください。アカウントとアプリの両方にリポジトリへのアクセス権があることを確認します。組織がアプリのインストールを制限している場合は、オーナーにアクセス権の承認を依頼してください。

同期のリポジトリ設定を開き、リポジトリ選択を確認後、再度保存してください。別の組織に移動している場合は、新しい場所でその接続がアクセスできるか確認してください。

GitHubのユーザー名には、Notionワークスペースのメンバーと一致する公開メールアドレスが常に利用できるとは限りません。プロパティが空の場合は、作成者 (GitHub)を使用して作成者を特定してください。作成者のメールアドレスやワークスペースのメンバーシップを変更しても、古い同期済みプルリクエストが自動的に更新されない場合があります。

その種類が同期対象に含まれていること、リポジトリが選択されていること、最終更新日が選択した対象期間内にあること、Notionのビューで除外されていないことを確認してください。初回インポートがまだ実行中の可能性もあります。

同期のステータス詳細を開いてください。メッセージが表示されたら、GitHubアカウントを再接続するか、リポジトリへのアクセス権を復元してください。GitHubのリクエスト制限や一時的な停止により、Notionが再試行している間、更新が遅れることがあります。

Workersとの比較や共有のトラブルシューティングガイダンスについては、他のツールからNotionへデータを同期する →をご覧ください。