Instalando um Aplicativo GitHub por meio do GitHub Marketplace em sua conta pessoal

Sobre o GitHub Marketplace

Este artigo se aplica à instalação e compra de GitHub App do GitHub Marketplace. Para obter mais informações sobre como instalar GitHub App de uma fonte diferente do GitHub Marketplace, confira "Instalando um Aplicativo GitHub de terceiros".

Se você instalar um GitHub App em seu conta pessoal e escolher um plano pago, pagará pela assinatura do aplicativo na data de cobrança atual do conta pessoal usando sua forma de pagamento existente.

Se você escolher um plano pago com um teste gratuito, você pode cancelar a qualquer momento durante o seu período de teste sem ser cobrado, mas você perderá o acesso automaticamente ao aplicativo. A assinatura paga começará a ser contada no fim da versão de avaliação de 14 dias. Para obter mais informações, confira "Sobre a cobrança do GitHub Marketplace".

Para mais informações sobre como instalar um OAuth App do GitHub Marketplace, confira "Como instalar um aplicativo do OAuth na sua conta pessoal."

Sobre instalação de GitHub App

Para usar um GitHub App em seus repositórios ou sua organização, você deve instalar o aplicativo.

Ao instalar um aplicativo, você concede ao aplicativo a permissão para acessar a organização e os recursos do repositório solicitados. Durante o processo de instalação, o GitHub informará a você quais permissões o GitHub App solicitou. Para obter mais informações sobre as solicitações da API REST que o GitHub App pode fazer com essas permissões, confira "Permissões necessárias para os aplicativos GitHub".

Ao instalar um aplicativo, você também escolherá a quais repositórios o GitHub App receberá acesso.

Antes de instalar um GitHub App, você deve garantir que confia no proprietário do GitHub App. Você também deve examinar as permissões que o GitHub App está solicitando e confirmar que você está de acordo com a concessão dessas permissões. Para obter mais informações sobre as solicitações da API REST que o GitHub App pode fazer com essas permissões, confira "Permissões necessárias para os aplicativos GitHub".

Não há limite na quantidade de aplicativos que você pode instalar.

Diferença entre instalação e autorização

Depois de instalar um GitHub App, você também poderá ser solicitado a autorizar o aplicativo.

Ao instalar um GitHub App em sua conta ou organização, você concede ao aplicativo permissão para acessar os recursos de organização e repositório solicitados. Você também especifica quais repositórios o aplicativo pode acessar.

Ao autorizar um GitHub App, você concede a ele acesso à sua conta do GitHub, com base nas permissões de conta solicitadas. Você também concede permissão ao aplicativo para realizar tarefas em seu nome.

É possível instalar um GitHub App sem autorizar o aplicativo. Da mesma forma, é possível autorizar o aplicativo sem instalá-lo.

Para obter mais informações sobre como autorizar GitHub Apps, confira "Autorizando aplicativos GitHub".

Instalar um GitHub App em sua conta pessoal

1. Na barra de navegação, na parte superior de qualquer página, clique em Marketplace.

   1. . Navegue até o app que gostaria de instalar e clique no nome do app. 1. Na página do aplicativo, em "Preços e configuração", clique no plano de preços que você gostaria de usar. 1. Clique em Instalá-lo gratuitamente, Comprar com o GitHub ou Experimentar gratuitamente por 14 dias. 1. Em "Examinar seu pedido", no menu suspenso Conta, confirme se você está instalando o aplicativo para sua conta pessoal. 1. Se você escolher um plano pago, na seção "Forma de Pagamento", confira sua forma de pagamento.

   • Para alterar a forma de pagamento existente registrada para sua conta pessoal, clique em Editar e preencha o formulário para adicionar uma nova forma de pagamento.
   • Se não houver uma forma de pagamento registrada para sua conta pessoal, preencha o formulário para adicionar um cartão de crédito ou uma conta do PayPal. 1. Selecione Concluir pedido e iniciar instalação.

2. Caso o aplicativo exija o acesso aos repositórios, selecione Todos os repositórios ou Selecionar apenas repositórios.

   Se o aplicativo cria algum repositório, ele também terá acesso a esses repositórios automaticamente.

3. Se você escolheu dar acesso ao aplicativo para repositórios limitados em vez de todos os seus repositórios, digite o nome de cada repositório que você deseja dar acesso ao aplicativo e, em seguida, clique no nome do repositório para selecioná-lo. 1. Revise as permissões de acesso do aplicativo e clique em Instalar.

Leitura adicional

• "Adicionar ou editar a forma de pagamento"
• "Instalando um Aplicativo GitHub por meio do GitHub Marketplace em suas organizações"