# APIバージョンをGitHubにプッシュ

APIをGitHubリポジトリーにリンクし、OAS/SwaggerまたはRAMLでAPI定義をプッシュします。

## 始める前に

* GitHubアカウントとリポジトリーがあること。
* お使いのブラウザーはGitHubでサポートされています(Internet Explorer 11はGitHubでサポートされなくなったため、このフィーチャーは IE11ではTalend Cloud API Designerでサポートされていません)。

## 手順

1. GitHubアカウントがまだTalend Cloud API Designerアカウントにリンクされていない場合は、[API Designer settings] (API Designerの設定)に移動します。
2. [Link your GitHub account] (GitHubアカウントのリンク)をクリックします。

   ![\[API Designer settings\] (API Designerの設定)の\[GitHub account\] ( GitHubアカウント)セクション。](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/link-your-github-account.png)
3. 開いたウィンドウで、GitHubにサインインし、[Authorize Talend] (Talendを承認)をクリックして、Talend Cloud API DesignerがGitHubアカウントにアクセスできるようにします。

   情報メモ警告: Internet Explorer 11を使用している場合は、Microsoft Edge、Google Chrome、またはFirefoxの最新バージョンにアップグレードするように求められます。

   GitHubアカウントがTalend Cloud API Designerアカウントにリンクされ、API定義のプッシュを開始できるようになりました。
4. GitHubにプッシュするAPIバージョンを開きます。
5. 右上のリンクをクリックします。
6. [Edit GitHub settings] (GitHubの設定を編集)セクションで、オプションを有効にし、次のフィールドを編集します。
   * 所有者
   * リポジトリー
   * [Branch] (ブランチ)
   * [Path] (パス)
   * [Format] (形式)

   [Format] (フォーマット)ドロップダウンリストでは、Talend拡張機能またはAPIゲートウェイ互換モードで定義をエクスポートできます。

   情報メモ注: APIに複数のバージョンがある場合は、各バージョンでGitHubの設定を変更できます。

   ![\[API Settings\] (APIの設定)ビューの\[Edit GitHub settings\] (GitHubの設定を編集)セクション。](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/push_to_github_01_link.png)
7. 設定が保存されたら、[Push] (プッシュ)をクリックします。

   プロジェクトにGitHubにプッシュされていない変更が含まれている場合は、[Push] (プッシュ)の右側に緑色のドットが表示されます。 ![GitHubにプッシュされていない変更がプロジェクトに含まれている場合のスクリーンショット。](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/push_to_github_03_push.png)
8. コミットメッセージを(必要であればタグも)入力し、[Push] (プッシュ)をクリックします。

   タグは一意であり、次のルールに従うことが必要です。
   * タグに含めることができるのは、英数字と特殊文字である\_、-、.、/のみです。
   * タグの冒頭と末尾に特殊文字を使うことはできません。
   * ..、//、/.という文字パターンを含めることはできません。

## タスクの結果

選択されたバージョンのAPI定義がリポジトリーにプッシュされます。生成されたファイル名にはAPIの名前とバージョンが含められます。

[View on GitHub] (GitHubで表示)をクリックすると、選択されたGitHubリポジトリーが開きます。

### このセクション内

* [GitHubアカウントをリンク解除](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Cloud/unlinking-github-account)