Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Requisitos para listar una app

Las apps en Mercado GitHub deben cumplir con los requisitos detallados en esta página antes de que nuestros especialistas de incorporación a Mercado GitHub aprueben el listado.

En este artículo

¿Te ayudó este documento?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.

Antes de que emias tu app para revisión, debes leer y aceptar las condiciones del "Acuerdo de desarrollador de Mercado GitHub". Aceptarás las condiciones dentro de tu borrador de listado en GitHub. Una vez que hayas emitido tu app, uno de los especialistas de incorporación de Mercado GitHub te contactará y te dará más información sobre el proceso de incorporación, y revisará tu app asegurarse de que cumple con estos requisitos:

Experiencia del usuario

  • Las App GitHub deben contar con un mínimo de 100 instalaciones.

  • Las App OAuth deben tener un mínimo de 200 usuarios.

  • Las apps deben proporcionar valor a los clientes e integrarse con la plataforma de alguna forma más allá de la autenticación.

  • Las apps deben estar disponibles al público en Mercado GitHub y no pueden estar en fase beta o únicamente disponibles con invitación.

  • Las apps no pueden persuadir activamente a los usuarios para salir de GitHub.

  • Los materiales de marketing para la app deben representar con precisión el comportamiento de ésta.

  • Las apps deben incluir enlaces para la documentación de cara al cliente que describa cómo configurarlas y configurarlas.

  • Cuando un cliente compra una app y GitHub los redirige a la URL de instalación de la misma, la app debe comenzar inmediatamente con el flujo de OAuth. Para encontrar más detalles, consulta la sección "Gestionar las compras nuevas y los periodos de prueba gratuitos".

  • Los clientes deben poder instalar tu app y seleccionar repositorios tanto en una cuenta personal como en una organizacional. Debe poder ver y administrar esas cuentas por separado.

Marca y listado

Seguridad

Las apps pasarán por una revisión de seguridad antes de que se listen en Mercado GitHub. Para tener una revisión exitosa, se debe cumplir con los requisitos y seguir las mejores prácticas de seguridad listadas en "Proceso de revisión de seguridad". Para obtener información sobre el proceso de revisión, contacta a marketplace@github.com.

Flujos de facturación

Tu app debe integrar flujos de facturación utilizando el evento de webhook de Mercado GitHub.

Apps gratuitas

Se exhorta a que hayan aplicaciones gratuitas en Mercado GitHub, y también son una gran forma de ofrecer servicios de código abierto. Si listas una versión de paga de tu app fuera de Mercado GitHub, deberás ofrecer por lo menos un plan de pago cuando la lsitas en Mercado GitHub. Si estás listando una app gratuita, necesitarás cumplir con estos requisitos:

  • Los clientes deben poder ver que tienen un plan gratuito en la sección de configuración de facturación, perfil o cuenta de la app.
  • Cuando un cliente cancela tu app, debes seguir el flujo de cancelación de planes.

Apps de pago

Para ofrecer tu app como un servicio de pago, necestiarás cumplir con estos requisitos para listar la app en Mercado GitHub:

  • Para vender tu app en Mercado GitHub, esta debe utilizar el sistema de facturación de GigtHub. Tu app no necesita gestionar pagos, pero sí necesita utilizar los "eventos de compra de Mercado GitHub" para administrar las compras, actualizaciones, decrementos, cancelaciones y periodos de prueba gratuitos nuevos. Consulta la sección "Flujos de facturación" para aprender más sobre cómo integrar estos eventos en tu app. Utilizar el sistema de facturación de GitHub permite a los clientes comprar una app sin salir de GitHub y pagar por el servicio con el método de pago que ya está adjunto a su cuenta de GitHub.
  • Las apps deben permitir facturación mensual y anual para las compras de sus sucripciones de pago.
  • Los listados pueden ofrecer cualquier combienación de planes gratuitos y de pago. Los planes gratuitos son opcionales, pero se les fomenta. Para obtener más información, consulta la sección "Configurar un plan de precios para los listados de Mercado GitHub".
  • Los clientes que cancelan un plan de pago que se haya comprado en Mercado GitHub deben degradar su versión automáticamente al plan gratuito de la app en caso de que éste exista. Se recomienda ampliamente la Cuando un cliente cancela una suscripción de Mercado GitHub, GitHub no desinstala la app automáticamente, así que el cliente puede esperar que las características gratuitas sigan funcionando. para permitir a los usuarios el rehabilitar su plan previo.
  • Los clientes deben poder mejorar la versión de tu app desde la IU de la misma si proporcionas una URL de mejora en este formato: https://www.github.com/marketplace/<LISTING_NAME>/upgrade/<LISTING_PLAN_NUMBER>/<CUSTOMER_ACCOUNT_ID>
  • Los clientes deben poder modificar qué usuarios tienen acceso a tu app desde el sitio web de la misma si compraron plazas (plan de precios por unidad) o si el plan ofrece colaboradores ilimitados.
  • Los clientes deben poder ver los siguientes cambios a su cuenta inmediatamente en la sección de facturación, perfil, o configuración de cuenta del sitio web de la app:
    • Plan y precios actuales.
    • Nuevos planes comprados.
    • Mejoras, degradaciones, cancelaciones y la cantidad de días restantes del periodo de prueba gratuito.
    • Cambios en los ciclos de facturación (mensual o anual).
    • Uso y recursos restantes para los planes por unidad y de tasa fija. Por ejemplo, si el plan de precios es por unidad, el sitio de tu app debería mostrar las unidades que se utilizan y las que quedan disponibles.

¿Te ayudó este documento?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.