从 GitHub Marketplace 为你的组织安装 GitHub 应用

关于 GitHub Marketplace

本文适用于从 GitHub Marketplace 安装和购买 GitHub 应用。有关从 GitHub Marketplace 以外的来源安装 GitHub 应用的更多信息，请参阅“从第三方安装 GitHub 应用”。

如果您在组织帐户上安装 GitHub 应用并选择付费计划，您将使用组织的现有付款方式在组织当前的账单日期支付应用订阅费用。

如果您选择包含免费试用的付费计划，您可以在试用期内随时取消而无需付费，但您将自动失去对应用的访问权限。您的付费订阅将在 14 天试用期结束后开始。更多信息，请参阅“GitHub Marketplace 的计费说明”。

有关从 GitHub Marketplace 安装 OAuth 应用而不是 GitHub 应用的更多信息，请参阅“在您的组织中安装 OAuth 应用”。

关于安装 GitHub 应用

为了在您的代码库或组织中使用 GitHub 应用，您必须在您的组织或个人帐户上安装该应用。您可以在多个帐户上安装同一个 GitHub 应用。例如，如果您在您的个人帐户和您拥有的几个组织上安装该应用，您将能够在您的个人代码库、安装了该应用的组织以及这些组织拥有的代码库上使用该应用。

安装应用时，您授予应用访问其请求的组织和代码库资源的权限。在安装过程中，GitHub 将告知您 GitHub 应用请求了哪些权限。有关 GitHub 应用可以使用这些权限执行的 REST API 请求的更多信息，请参阅“GitHub 应用所需的权限”。

安装应用时，您还将选择授予 GitHub 应用访问权限的代码库。

在安装 GitHub 应用之前，您应该确保您信任 GitHub 应用的所有者。您还应该查看 GitHub 应用请求的权限，并确保您同意授予这些权限。有关 GitHub 应用可以使用这些权限执行的 REST API 请求的更多信息，请参阅“GitHub 应用所需的权限”。

您可以安装的应用数量没有限制。

安装和授权的区别

安装 GitHub 应用后，您可能还会被要求授权该应用。

当您**安装** GitHub 应用到您的帐户或组织时，您授予该应用访问其请求的组织和代码库资源的权限。您还指定该应用可以访问哪些代码库。在安装过程中，GitHub 应用将指示您正在授予哪些代码库和组织权限。有关不同权限使 GitHub 应用能够执行的操作的更多信息，请参阅“选择 GitHub 应用的权限”。

例如，您可以授予 GitHub 应用读取代码库元数据和编写问题的权限，并且您可以授予 GitHub 应用访问您所有代码库的权限。

当您**授权** GitHub 应用时，您根据应用请求的帐户权限授予该应用访问您 GitHub 帐户的权限。在授权过程中，应用将指示该应用可以访问您帐户上的哪些资源。授权 GitHub 应用时，您还授予该应用代表您采取行动的权限。

例如，您可以授予 GitHub 应用读取您的电子邮件地址和编写 gist 的权限。

您可以安装 GitHub 应用而无需授权该应用。同样，您可以授权该应用而无需安装该应用。

有关授权 GitHub 应用的更多信息，请参阅“授权 GitHub 应用”。

在组织中安装 GitHub 应用的要求

组织所有者可以在其组织中安装 GitHub 应用。

对于使用信用卡付费的企业，也是组织所有者的企业所有者可以在其企业内的组织中安装 GitHub 应用。

如果组织拥有的代码库的管理员只授予应用访问他们担任管理员的代码库的权限，并且应用未请求任何组织权限或“代码库管理”权限，则他们也可以在组织中安装 GitHub 应用。组织所有者可以阻止担任代码库管理员的外部协作者安装 GitHub 应用。

组织中的“应用管理员”角色不会赋予用户在组织中安装 GitHub 应用的能力。更多信息，请参阅“关于 GitHub 应用管理员”。

在您的组织中安装 GitHub 应用

1. 要打开 GitHub Marketplace，请在 GitHub 的左上角选择，然后点击 Marketplace.

   

2. 浏览到您想要安装的应用，然后点击应用名称。

3. 在应用页面上的“定价和设置”下，点击您想要使用的定价计划。

4. 点击**免费安装**、**使用 GitHub 购买**或**免费试用 14 天**。

5. 为应用选择一个安装组织。根据您组织的服务条款，此过程略有不同。

   • 如果您已授权 GitHub 收集您组织的姓名和地址信息，请在“计费信息”部分选择**切换计费帐户**下拉菜单，然后点击您想要安装应用的组织。
   
   • 否则，在“查看您的订单”下，选择**帐户**下拉菜单，然后点击您想要安装应用的组织。
   

6. 如果您选择了付费计划，请查看您的付款方式。

   • 要更改组织中已有的付款方式，请点击**编辑**，然后填写表格以添加新的付款方式。
   • 如果组织中没有已有的付款方式，请点击**添加付款方式**，然后填写表格以添加信用卡或 PayPal 帐户。

7. 点击**完成订单并开始安装**。

8. 如果应用需要访问代码库，请选择**所有代码库**或**仅选择代码库**。

   如果应用创建任何代码库，则应用也将自动获得对这些代码库的访问权限。

9. 如果您选择向应用授予对有限代码库的访问权限而不是所有代码库的访问权限，请键入您想要授予应用访问权限的每个代码库的名称，然后点击代码库名称进行选择。

10. 查看应用的访问权限，然后点击**安装**。

进一步阅读

• “添加或编辑付款方式”
• “从 GitHub Marketplace 为您的个人帐户安装 GitHub 应用”