Remarque : cet article s’applique à la publication d’applications dans GitHub Marketplace uniquement. Pour plus d’informations sur la publication de GitHub Actions dans GitHub Marketplace, consultez « Publication d’actions dans GitHub Marketplace ».
Les exigences pour le référencement d’une application sur GitHub Marketplace varient selon que vous souhaitez proposer une application gratuite ou payante.
Exigences pour toutes les référencements GitHub Marketplace
Tous les référencements sur GitHub Marketplace devraient avoir trait à des outils qui apportent de la valeur à la communauté GitHub Enterprise Cloud. Lorsque vous soumettez votre référencement pour publication, vous devez lire et accepter les termes du « Contrat de développement de la place de marché GitHub ».
Exigences relatives à l’expérience utilisateur pour toutes les applications
Tous les référencements doivent répondre aux exigences suivantes, qu’ils aient trait à une application gratuite ou payante.
- Les référencements ne doivent pas détourner activement les utilisateurs de GitHub Enterprise Cloud.
- Les référencements doivent inclure des informations de contact valides pour l’éditeur.
- Les référencements doivent présenter une description pertinente de l’application.
- Les référencements doivent spécifier un plan tarifaire.
- Les applications doivent apporter de la valeur aux clients, et s’intégrer avec la plateforme d’une manière ou d’une autre au-delà de l’authentification.
- Les applications doivent être publiquement disponibles dans GitHub Marketplace et ne peuvent pas être en version bêta ou disponibles uniquement par invitation.
- Les applications doivent avoir des événements webhook configurés pour informer l’éditeur de tout changement ou annulation de plan à l’aide de l’API GitHub Marketplace. Pour plus d’informations, consultez « Utilisation de l’API GitHub Marketplace dans votre application ».
Pour plus d’informations sur la fourniture d’une bonne expérience client, consultez « Bonnes pratiques d’expérience utilisateur pour les applications ».
Exigences relatives à la marque et au référencement pour toutes les applications
- Les applications qui utilisent des logos GitHub doivent suivre les directives GitHub . Pour plus d’informations, consultez « Logos GitHub et utilisation ».
- Les applications doivent avoir un logo, une carte de fonctionnalité et des captures d’écran répondant aux recommandations énoncées dans « Écrire une description de référencement pour votre application ».
- Les référencements doivent inclure des descriptions rédigées correctement et exemptes d’erreurs grammaticales. Pour obtenir des conseils sur la rédaction de votre offre, consultez « Écrire une description de référencement pour votre application ».
Pour protéger vos clients, nous vous recommandons également de suivre les meilleures pratiques en matière de sécurité. Pour plus d’informations, consultez « Meilleures pratiques de sécurité pour les applications sur la Place de marché GitHub ».
Considérations relatives aux applications gratuites
Les applications gratuites sont encouragées dans GitHub Marketplace et constituent un excellent moyen d’offrir des services open source. Si vous listez une version payante de votre application en dehors de GitHub Marketplace, vous devez proposer au moins un plan payant lors du référencement de l’application dans GitHub Marketplace.
Exigences pour les applications payantes
Pour publier un plan payant pour votre application sur GitHub Marketplace, votre application doit appartenir à une organisation qui est un éditeur vérifié. Pour plus d’informations sur le processus de vérification ou le transfert de la propriété de votre application, consultez « Demande de vérification d’éditeur pour votre organisation ».
Si votre application est déjà publiée et que vous êtes un éditeur vérifié, vous pouvez publier un nouveau plan payant à partir de l’éditeur de plan tarifaire. Pour plus d’informations, consultez « Définition des plans tarifaires pour votre référencement ».
Pour publier une application payante (ou une application qui offre un plan payant), vous devez également répondre aux exigences suivantes :
- Les GitHub Apps devraient avoir au moins 100 installations.
- Les OAuth apps devraient avoir au moins 200 utilisateurs.
- Toutes les applications payantes doivent gérer les événements d’achat GitHub Marketplace pour les nouveaux achats, les mises à niveau, les retours à une version antérieure, les annulations et les essais gratuits. Pour plus d’informations, consultez « Exigences de facturation pour les applications payantes ».
Lorsque vous êtes prêt à publier l’application sur GitHub Marketplace, vous devez demander la vérification du référencement de l’application.
Remarque : Si vous souhaitez vendre une application appartenant à votre compte personnel, vous devez d’abord la transférer à une organisation, puis demander une vérification de la liste créée par l’organisation. pour des informations sur le transfert d’une application à une organisation, consultez : « Soumission de votre référencement pour publication ».
Exigences pour les applications payantes
Votre application n’a pas besoin de gérer les paiements, mais elle doit utiliser des événements d’achat GitHub Marketplace pour gérer les nouveaux achats, les mises à niveau, les retours à une version antérieure, les annulations et les essais gratuits. Pour plus d’informations sur l’intégration de ces événements dans votre application, consultez « Utilisation de l’API GitHub Marketplace dans votre application ».
L’utilisation de l’API Facturation de GitHub permet aux clients d’acheter une application sans quitter GitHub, et de payer le service avec le mode de paiement déjà associé à leur compte sur GitHub.com.
- Les applications doivent prendre en charge la facturation mensuelle et annuelle pour les achats d’abonnements payants.
- Les référencements peuvent offrir n’importe quelle combinaison de plans gratuits et payants. Les plans gratuits sont facultatifs mais encouragés. Pour plus d’informations, consultez « Définition des plans tarifaires pour votre référencement ».