Note
Este artículo se aplica solo a la publicación de aplicaciones en GitHub Marketplace. Para 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 todas las listas 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.
- 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 al público en GitHub Marketplace y no pueden estar en versión preliminar pública o únicamente disponibles con invitación, a excepción de Copilot Extensions.
- 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 obtener más información, vea «Utilizar la API de GitHub Marketplace en tu app».
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 apps que utilizan los logos de GitHub deben seguir los lineamientos de GitHub. Para más información, vea "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 obtener más información, vea «Procedimientos recomendados de seguridad para las aplicaciones del marketplace de GitHub».
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 paga de tu app fuera de GitHub Marketplace, deberás ofrecer por lo menos un plan de pago cuando la lsitas en GitHub Marketplace.
Requisitos para GitHub Copilot Extensions
Copilot Extensions son básicamente GitHub Apps con acceso de lectura adicional a Copilot Chat, integración con la API Copilot e integración opcional en otras LLM.
Para publicar una extensión, debe ser propiedad de una cuenta de la organización con el estado de autor comprobado. 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 de publicador para tu organización".
Los requisitos para publicar un Copilot Extension son los mismos que los requisitos de las aplicaciones gratuitas, con las siguientes excepciones:
-
La extensión debe proporcionar una respuesta clara y descriptiva a un mensaje como "¿Qué puede hacer?" o "Enumerar sus funcionalidades".
-
La extensión puede estar en versión preliminar pública siempre que se comunique claramente en la descripción de la lista. Si usa una lista de espera, también debe incluir un vínculo para registrarse en la parte superior de la descripción. Alguien del equipo de revisión de GitHub se unirá a la lista de espera y enviará un correo electrónico al responsable técnico que solicita acceso para las pruebas.
-
Debe incluir vínculos a dos vídeos que muestren lo siguiente:
- Algunos ejemplos de solicitudes y respuestas de la extensión
- Un nuevo usuario neto que instala, autentica y envía su primer mensaje a la extensión
Estos vídeos son privados para GitHub y se usan únicamente para revisar el envío de la descripción. Los vídeos pueden ser breves y no es necesario editarlos.
-
La extensión debe proporcionar una experiencia de usuario estable y fiable y poder realizar las funcionalidades enumeradas en la descripción.
-
Debe proporcionar una ruta para que los nuevos usuarios instalen, configuren y autoricen la extensión con una fricción mínima. Si el equipo de revisión de GitHub no puede probar correctamente su extensión, no se aprobará para su publicación.
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 de publicador 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 obtener más información, vea «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 gestinar los eventos de compra de GitHub Marketplace para las compras nuevas, mejoras, retrocesos, cancelaciones y pruebas gratuitas. Para obtener más información, vea 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.
Note
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 "Utilizar la API de GitHub Marketplace en tu app".
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 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, vea «Configurar planes de precios para tu listado».