참고: 이 문서는 GitHub Marketplace의 앱 게시에만 적용됩니다. GitHub Actions의 GitHub Actions 배포에 대한 자세한 내용은 "GitHub Marketplace에서 작업 게시"을(를) 참조하세요.
GitHub Marketplace에 앱을 나열하기 위한 요구 사항은 무료 또는 유료 앱을 제공할지 여부에 따라 달라집니다.
모든 GitHub Marketplace 목록에 대한 요구 사항
GitHub Marketplace의 모든 목록은 GitHub 커뮤니티에 가치를 제공하는 도구에 대한 목록이어야 합니다. 게시 목록을 제출할 때 "GitHub Marketplace 개발자 계약"의 약관을 읽고 동의해야 합니다.
모든 앱에 대한 사용자 환경 요구 사항
모든 목록은 무료 또는 유료 앱용인지 관계없이 다음 요구 사항을 충족해야 합니다.
- 목록은 GitHub에서 사용자를 적극적으로 설득해서는 안 됩니다.
- 목록에는 게시자에 대한 유효한 연락처 정보가 포함되어야 합니다.
- 목록에는 애플리케이션에 대한 관련 설명이 있어야 합니다.
- 목록은 가격 책정 플랜을 지정해야 합니다.
- 앱은 고객에게 가치를 제공하고 인증 이외의 방식으로 플랫폼과 통합해야 합니다.
- 앱은 GitHub Marketplace에서 공개적으로 사용할 수 있어야 하며, Copilot Extensions를 제외하고 공개 미리 보기 버전이거나 초대를 통해서만 사용할 수 없습니다.
- 앱에는 GitHub Marketplace API를 사용하여 게시자에게 플랜 변경 또는 취소를 알리도록 웹후크 이벤트가 설정되어 있어야 합니다. 자세한 내용은 "앱에서 GitHub Marketplace API 사용"을(를) 참조하세요.
좋은 고객 환경을 제공하는 방법에 대한 자세한 내용은 "앱에 대한 고객 환경 모범 사례"을(를) 참조하세요.
모든 앱에 대한 브랜드 및 목록 요구 사항
- GitHub 로고를 사용하는 앱은 GitHub 지침을 따라야 합니다. 자세한 내용은 “GitHub의 로고 및 사용 현황”을 참조하세요.
- 앱에는 로고, 기능 카드 및 "앱에 대한 목록 설명 작성"에서 제공되는 권장 사항을 충족하는 스크린샷 이미지가 있어야 합니다.
- 목록에는 문법 오류가 없고 잘 작성된 설명이 포함되어야 합니다. 목록 작성에 대한 지침은 "앱에 대한 목록 설명 작성"을(를) 참조하세요.
고객을 보호하려면 보안 모범 사례도 따르는 것이 좋습니다. 자세한 내용은 "GitHub Marketplace의 앱에 대한 보안 모범 사례"을(를) 참조하세요.
무료 앱에 대한 고려 사항
무료 앱은 GitHub Marketplace에서 권장되며 오픈 소스 서비스를 제공하는 좋은 방법입니다. GitHub Marketplace 이외에 유료 버전의 앱을 나열하는 경우 GitHub Marketplace에 앱을 나열할 때 하나 이상의 유료 플랜을 제공해야 합니다.
GitHub Copilot Extensions의 요구 사항
Copilot Extensions는 기본적으로 Copilot Chat에 대한 추가 읽기 액세스, Copilot API와의 통합 및 다른 LLM에 대한 선택적 통합이 있는 GitHub Apps입니다.
확장을 게시하려면 확인된 작성자 상태의 조직 계정이 해당 확장을 소유해야 합니다. 확인 프로세스 또는 앱 소유권 이전에 대한 자세한 내용은 "조직에 대한 게시자 확인 신청"을(를) 참조하세요.
Copilot Extension을(를) 게시하기 위한 요구 사항은 무료 앱에 대한 요구 사항과 동일하며 다음과 같은 예외가 있습니다.
-
확장은 "무엇을 할 수 있습니까?" 또는 "기능 나열"과 같은 프롬프트에 명확하고 설명적인 응답을 제공해야 합니다.
-
목록 설명에 명확하게 전달되는 한 확장은 공개 미리 보기 버전일 수 있습니다. 대기 목록을 사용하는 경우 설명 맨 위에 등록할 링크도 포함되어야 합니다. GitHub 검토 팀의 누군가가 대기 목록에 합류하여 기술 책임자에게 이메일을 보내 테스트를 위한 액세스 권한을 요청할 것입니다.
-
다음을 보여 주는 두 개의 비디오에 대한 링크를 포함해야 합니다.
- 확장의 몇 가지 프롬프트 및 응답 예시
- 새 사용자가 첫 번째 프롬프트를 설치, 인증 및 확장에 전송
이러한 비디오는 GitHub에 비공개이며 목록 제출을 검토하는 데만 사용됩니다. 비디오는 간단할 수 있으며 편집할 필요가 없습니다.
-
확장은 안정적이고 안정적인 사용자 환경을 제공하고 설명에 나열된 기능을 수행할 수 있어야 합니다.
-
새 사용자가 최소한의 마찰로 확장을 설치, 설정, 인증할 수 있는 경로를 제공해야 합니다. GitHub 검토 팀이 확장을 성공적으로 테스트할 수 없는 경우 게시가 승인되지 않습니다.
유료 앱에 대한 요구 사항
GitHub Marketplace의 앱에 대한 유료 플랜을 게시하려면 확인된 게시자 조직에서 앱을 소유해야 합니다. 확인 프로세스 또는 앱 소유권 이전에 대한 자세한 내용은 "조직에 대한 게시자 확인 신청"을(를) 참조하세요.
앱이 이미 게시되어 있고 확인된 게시자인 경우 가격 책정 플랜 편집기에서 새 유료 플랜을 게시할 수 있습니다. 자세한 내용은 "목록에 대한 가격 책정 플랜 설정"을(를) 참조하세요.
유료 앱(또는 유료 플랜을 제공하는 앱)을 게시하려면 다음 요구 사항도 충족해야 합니다.
- GitHub Apps에는 최소 100개의 설치가 있어야 합니다.
- OAuth apps 에는 최소 200명의 사용자가 있어야 합니다.
- 모든 유료 앱은 새 구매, 업그레이드, 다운그레이드, 취소 및 무료 평가판에 대한 GitHub Marketplace 구매 이벤트를 처리해야 합니다. 자세한 내용은 아래의 “유료 앱에 대한 청구 요구 사항”을 참조하세요.
GitHub Marketplace에 앱을 게시할 준비가 되면 앱 목록에 대한 확인을 요청해야 합니다.
참고: 개인 계정이 소유한 앱을 판매하려면 먼저 앱을 조직으로 이전한 다음, 조직에서 만든 목록에 대한 확인을 요청해야 합니다. 조직에 앱을 전송하는 방법에 대한 자세한 내용은 “게시를 위해 목록 제출”을(를) 확인하세요.
유료 앱에 대한 청구 요구 사항
앱은 결제를 처리할 필요가 없지만 GitHub Marketplace 구매 이벤트를 사용하여 새 구매, 업그레이드, 다운그레이드, 취소 및 무료 평가판을 관리해야 합니다. 이러한 이벤트를 앱에 통합하는 방법에 대한 자세한 내용은 "앱에서 GitHub Marketplace API 사용"을(를) 참조하세요.
GitHub의 청구 API를 사용하면 고객이 GitHub를 떠나지 않고 앱을 구매하고 GitHub의 계정에 이미 연결된 결제 방법으로 서비스에 대한 비용을 지불할 수 있습니다.
- 앱은 유료 구독 구매에 대한 월간 및 연간 청구를 모두 지원해야 합니다.
- 목록은 무료 및 유료 플랜의 조합을 제공할 수 있습니다. 무료 플랜은 선택 사항이지만 권장됩니다. 자세한 내용은 "목록에 대한 가격 책정 플랜 설정" 항목을 참조하세요.