Nota:
Este artículo se aplica solo a la publicación de aplicaciones en GitHub Marketplace. Para obtener más información sobre la publicación de GitHub Actions en GitHub Marketplace, consulta Publicar acciones en GitHub Marketplace.
Los requisitos para listar una app en GitHub Marketplace varían de acuerdo con si quieres ofrecer una app gratuita o de pago.
Requisitos para todos los listados de GitHub Marketplace.
Todas las listas de GitHub Marketplace deben ser para las herramientas que proporcionen valor a la comunidad de GitHub. Al enviar la oferta para su publicación, debes leer y aceptar los términos de Acuerdo para desarrolladores del Mercado GitHub.
Requisitos de la experiencia del usuario para todas las apps
Todas las listas deben cumplir con los siguientes requisitos, sin importar si son para una app gratuita o de pago.
- Las listas no deben persuadir activamente a los usuarios de que salgan de GitHub.
- Las listas deben incluir la información de contacto válida del publicador.
- Las listas deben tener una descripción relevante de la aplicación.
- Las listas deben especificar un plan de precios.
- Los listados deben tener un vínculo válido a una directiva de privacidad.
- Los listados deben proporcionar un método para recibir soporte técnico mediante un vínculo de soporte técnico válido o una dirección de correo electrónico de soporte técnico.
- Todos los vínculos adicionales de una lista, como términos de servicio o una página de estado, deben funcionar y resolverse en una página pertinente.
- Las apps deben proporcionar valor a los clientes e integrarse con la plataforma de alguna forma más allá de la autenticación.
- Las aplicaciones deben estar disponibles públicamente en GitHub Marketplace y no pueden estar en versión preliminar pública o disponibles solo por invitación.
- Las apps deben contar con eventos de webhook configurados para notificar al publicador sobre cualquier cancelación o cambio en el plan utilizando la API de GitHub Marketplace. Para más información, consulta Uso de la API de Marketplace de GitHub en la aplicación.
Para más información sobre cómo proporcionar una buena experiencia de cliente, consulta Mejores prácticas para la experiencia de los clientes con las apps.
Requisitos de marca y de listado para todas las apps
- Las aplicaciones que usan logotipos de GitHub deben seguir las instrucciones GitHub . Para más información, consulta Logotipos y uso de GitHub.
- Las aplicaciones deben tener un logotipo, una tarjeta de características e imágenes de capturas de pantalla que cumplan las recomendaciones proporcionadas en Escribir la descripción de un listado para tu app.
- Los listados deben incluir descripciones que estén bien escritas y no tengan errores gramaticales. Para una guía sobre cómo escribir la oferta, consulta Escribir la descripción de un listado para tu app.
Para proteger a tus clientes, te recomendamos que también sigas las mejores prácticas de seguridad. Para más información, consulta Procedimientos recomendados de seguridad para aplicaciones en GitHub Marketplace.
Consideraciones para las apps gratuitas
Se exhorta a que hayan aplicaciones gratuitas en GitHub Marketplace, y también son una gran forma de ofrecer servicios de código abierto. Si listas una versión de pago de tu app fuera de GitHub Marketplace después de un listado gratuito de la aplicación en Marketplace cumpla los requisitos de las aplicaciones de pago, deberás ofrecer por lo menos un plan de pago cuando la listas en GitHub Marketplace.
Requisitos para las apps de pago
Para publicar un plan de pago para su aplicación en GitHub Marketplace, esta debe pertenecer a una organización que sea un editor verificado. Para más información sobre el proceso de comprobación o la transferencia de la propiedad de la aplicación, consulta Solicitar una verificación del editor para tu organización.
Si tu app ya se publicó y eres un publicador verificado, entonces puedes publicar un plan de pago nuevo desde el editor de plan de precios. Para más información, consulta Configurar planes de precios para tu listado.
Para publicar una app de pago (o una app que te ofrece un plan de pago), también debes cumplir con los siguientes requisitos:
- Las GitHub Apps deben tener un mínimo de 100 instalaciones.
- Las OAuth apps deben tener un mínimo de 200 usuarios.
- Todas las apps de pago deben gestionar los eventos de compra de GitHub Marketplace para las compras nuevas, actualizaciones, degradaciones, cancelaciones y pruebas gratuitas. Para obtener más información, consulta debajo Requisitos de facturación para aplicaciones de pago.
Cuando estés listo para publicar la app en GitHub Marketplace, deberás solicitar la verificación de su listado.
Nota:
Si quieres vender una aplicación que pertenece a tu cuenta personal, primero necesitarás transferirla a una organización y luego solicitar la verificación de un listado que cree dicha organización. Para información sobre cómo transferir una aplicación a una organización, consulta Emitir tu listado para que se publique.
Requisitos de facturación para las apps de pago
Tu app no necesita administrar pagos, pero sí necesita utilizar los eventos de compra de GitHub Marketplace para administrar las compras nuevas, mejoras, retrocesos, cancelaciones y pruebas gratuitas. Para información sobre cómo integrar estos eventos en la aplicación, consulta Uso de la API de Marketplace de GitHub en la aplicación.
El uso de la API de facturación de GitHub permite a los clientes comprar una aplicación sin salir de GitHub y pagar por el servicio con la forma de pago que ya está asociada a su cuenta de GitHub.
- Las apps deben admitir facturación mensual y anual para la compra de suscripciones 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 más información, consulta Configurar planes de precios para tu listado.