Google Workspace Marketplace SDK에서 앱 구성

이 페이지에서는 Google Workspace Marketplace SDK를 사용하여 Google Workspace Marketplace에서 앱을 구성하고 관리하는 방법을 설명합니다.

앱을 사용할 수 있도록 하려면 Marketplace SDK에서 앱을 설정해야 합니다. Marketplace SDK는 Google Workspace Marketplace에서 앱을 만들고 제어할 수 있는 도구 키트입니다. Marketplace SDK를 사용하여 다음과 같은 마켓플레이스 설정을 관리합니다.

• 앱을 특정 Google Workspace 조직(비공개 앱)에서 사용할 수 있는지 또는 모든 Marketplace 사용자 (공개 앱)에서 사용할 수 있는지 여부
• 앱을 설치할 수 있는 Marketplace 사용자 유형
• 앱이 통합되는 Google Workspace 애플리케이션
• 앱에 필요한 OAuth 범위
• 앱을 빌드하고 유지 관리하는 사용자에 관한 정보

앱을 비공개로 게시하든 공개적으로 게시하든 Marketplace SDK를 사용하여 Marketplace에서 앱을 관리해야 합니다.

Marketplace SDK 사용 설정

아직 사용 설정하지 않았다면 Google Cloud 프로젝트에서 Google Workspace 마켓플레이스 SDK를 사용 설정합니다.

Google Cloud 콘솔에서 Cloud 프로젝트 열기

아직 열려 있지 않으면 이 샘플에 사용할 Cloud 프로젝트를 엽니다.

1. Google Cloud 콘솔에서 프로젝트 선택 페이지로 이동합니다.

   Cloud 프로젝트 선택

2. 사용할 Google Cloud 프로젝트를 선택합니다. 또는 프로젝트 만들기를 클릭하고 화면에 표시된 안내를 따릅니다. Google Cloud 프로젝트를 만드는 경우 프로젝트에 결제를 사용 설정해야 할 수 있습니다.

Google Workspace Marketplace SDK 사용 설정

Google API를 사용하려면 먼저 Google Cloud 프로젝트에서 사용 설정해야 합니다. 단일 Google Cloud 프로젝트에서 하나 이상의 API를 사용 설정할 수 있습니다.

• Google Cloud 콘솔에서 Google Workspace Marketplace SDK를 사용 설정합니다.

  SDK 사용 설정

앱의 구성 설정 결정

다음 참조에서는 마켓플레이스 SDK의 앱 구성 페이지에서 사용할 수 있는 설정을 설명합니다.

앱을 보고 설치할 수 있는 사용자 선택하기

앱을 구성할 때 다음 설정을 사용하여 앱에 액세스할 수 있는 사용자를 지정합니다.

• 앱 공개 상태: Google Workspace 조직 내에서 앱을 게시하는 경우 앱 등록정보가 공개 상태인지, 조직의 모든 사용자에게 표시되는지, Google Workspace를 사용하는 모든 사용자에게 표시되는지 여부를 지정합니다.
• 설치 설정: Google Workspace 관리자만 앱을 설치할 수 있는지 여부입니다.

앱 등록정보에 지정된 설정과 관계없이 Google Workspace 조직에 속한 사용자는 관리자가 설정한 설정에 따라 앱을 검색, 설치 또는 사용할 수 없을 수 있습니다. 관리자는 다음과 같은 방식으로 앱의 사용 가능 여부에 영향을 줄 수 있습니다.

• 사용자가 마켓플레이스에서 앱을 볼 수 있는지 여부를 제어하고 사용자를 대신하여 앱을 설치합니다.
• 허용 목록을 사용하여 조직의 앱을 관리하고 선별합니다. 허용 목록을 사용하는 조직의 앱을 개발하는 경우 관리자에게 허용 목록에 앱을 추가하는 방법을 확인하세요.
• Google Chat, Google Chat 앱 또는 둘 다에 대한 액세스 권한을 삭제하는 등 특정 Google Workspace 애플리케이션을 사용 중지합니다. 이 경우 사용자는 Marketplace에서 앱을 설치할 수 없습니다.

관리자가 Marketplace 액세스를 관리하는 방법을 알아보려면 Marketplace 관리자 도움말 문서를 참고하세요.

앱 공개 상태 설정

Google Workspace 계정 (직장 또는 학교 조직에서 만든 계정)을 사용하는 경우 앱 공개 상태 옵션이 표시됩니다. 일반 계정(@gmail.com으로 끝나는 계정)을 사용하는 경우 공개적으로만 게시할 수 있습니다.

• 공개: 도메인 외부의 사용자가 앱을 찾아 설치할 수 있습니다. 공개 공개 상태를 선택하면 앱 등록정보가 게시되기 전에 Google에서 검토 및 승인합니다.
• 비공개: 도메인 내의 사용자만 앱을 찾아 설치할 수 있습니다.

일부 공개로 게시하면 앱 등록정보가 둘러보기 또는 검색 결과에 표시되지 않습니다. 사용자는 직접 URL을 통해서만 앱의 스토어 페이지에 액세스할 수 있습니다.

앱을 사용할 수 있는 국가 및 지역을 제한하려면 스토어 등록정보를 만들 때 배포 섹션에서 설정합니다.

앱 설치 설정

설치 설정 옵션에 따라 사용자 또는 Google Workspace 관리자가 Google Workspace Marketplace의 스토어 등록정보 페이지에서 앱을 설치할 수 있는지 여부가 결정됩니다.

• 개별 + 관리자 설치 (기본값): 개별 사용자 또는 관리자가 도메인, 조직 단위 또는 사용자 그룹에 앱을 설치할 수 있습니다. 사용자의 도메인 정책에 따라 개별 설치가 사용 설정되어 있더라도 앱을 설치하지 못할 수 있습니다.
• 관리자만 설치: 관리자만 도메인, 조직 단위 또는 사용자 그룹에 앱을 설치할 수 있습니다. 앱은 관리자 및 Google 계정에 로그인하지 않은 사용자의 Google Workspace Marketplace 검색 결과에만 표시됩니다. 앱에 도메인 설치가 필요한 경우 이 옵션을 선택합니다.

일반적인 설치 및 공개 상태 설정

다음 표에는 설치 및 표시의 일반적인 앱 구성 옵션이 요약되어 있습니다.

대상 앱 사용자	앱 공개 상태 설정	앱 설치 설정	내 앱을 설치할 수 있는 사용자	내 앱은 누가 사용할 수 있나요?
Google Workspace 조직용으로 빌드된 앱
조직 내 특정 사용자	비공개 및 일부 공개	개인 + 관리자 설치	허용되는 경우 앱 등록정보 URL이 있는 조직의 모든 사용자	허용되는 경우 앱 등록정보 URL이 있는 조직의 모든 사용자
내 조직	비공개	개인 + 관리자 설치	허용되는 경우 조직의 모든 사용자	허용되는 경우 조직의 모든 사용자
내 조직	비공개	관리자만	관리자	관리자가 앱을 설치한 사용자입니다.
특정 Google Workspace 조직 외부의 사용자가 사용할 수 있는 앱
Google Workspace 조직의 사용자	공개	관리자만	관리자	관리자가 앱을 설치한 사용자입니다.
모든 Google Workspace 사용자	공개	개인 + 관리자 설치	Google Workspace 애플리케이션을 개인적으로 사용하는 모든 사용자 허용되는 경우 Google Workspace 조직의 사용자	Google Workspace 애플리케이션을 개인적으로 사용하는 모든 사용자 허용되는 경우 Google Workspace 조직의 사용자

앱이 Google Workspace 애플리케이션과 통합되는 방식 확인하기

앱 또는 부가기능이 작동하도록 설계된 Google Workspace 서비스를 선택합니다(예: Google Workspace 부가기능 또는 Google Chat 앱). 하나 이상의 옵션을 선택해야 합니다. 경우에 따라 앱 등록정보에 여러 앱 통합을 포함할 수 있습니다. 앱 통합을 함께 나열을 참고하세요.

선택하는 앱 통합에 따라 Google Cloud 프로젝트에서 추가 정보를 제공하고 관련 API를 사용 설정해야 할 수 있습니다. 다음 표에서는 각 경우에 필요한 추가 설정을 설명합니다.

앱에 필요한 액세스 수준 지정

OAuth 범위에서 앱에 필요한 OAuth 2.0 범위의 전체 목록을 제공합니다. 여기에 입력하는 OAuth 범위는 OAuth 동의 화면 및 해당하는 경우 Apps Script 매니페스트에 표시되는 범위와 일치해야 합니다.

앱 통합을 두 개 이상 포함하는 경우 Marketplace SDK 앱 구성 페이지와 OAuth 동의 화면에 각 통합의 범위를 추가해야 합니다.

항상 가능한 한 가장 좁은 범위를 사용하세요. 예를 들어 읽기 전용 범위만 필요한 경우 전체 Drive 범위를 포함하지 마세요.

Apps Script 프로젝트의 경우 승인 범위에서 자세한 내용을 확인하세요.

앱 개발자 정보 제공

개발자 정보에서 연락처 정보 및 기타 세부정보를 입력합니다. 이 필드는 앱의 스토어 등록정보 페이지에 표시됩니다.

필드
거래자 상태	소비자 보호법에 따라 유럽 경제 지역 (EEA)에 거주하는 소비자에게 Google Workspace 마켓의 판매자가 사업자인지 비사업자인지 알려야 합니다. 판매자: 판매자는 거래, 비즈니스, 공예, 직업과 관련된 목적을 위해 행동하거나 판매자를 대신하여 행동하는 사람입니다. 비판매자: 비판매자 (소비자)는 전문적이지 않은 목적으로 행동하는 사람입니다. 지정하지 않으면 앱의 스토어 등록정보 페이지에 '상인 상태 지정되지 않음'이 표시됩니다.
개발자 이름	앱 작성자로 표시할 이름입니다. 판매자인 경우 사업자 이름 또는 법적 이름을 입력하세요.
개발자 우편 주소	거래자에게 필수입니다. 비거래자의 경우 수집되지 않습니다. 업체 위치 연락할 수 있는 올바른 우편 주소를 입력하세요.
개발자 웹사이트 URL	개발자 (또는 조직)를 설명하는 웹사이트입니다.
개발자 이메일	담당자로 사용할 이메일 주소입니다. 앱 등록정보에 포함되어 있지 않습니다. 이 이메일 주소는 사용 시 최신 상태로 유지해야 합니다. Google에서 개발자에게 문의해야 하는 경우(예: 앱 검토 절차 중) 스토어 등록정보 페이지에 문제 신고 URL이 제공되지 않은 경우 편집기 부가기능에서 의견을 보냅니다.
애플리케이션 웹사이트 URL	선택사항입니다. 앱을 자세히 설명하는 웹사이트입니다.

Marketplace SDK에 앱 구성 설정 저장

이전 섹션의 정보를 사용하여 Marketplace SDK에 앱 구성을 저장합니다.

1. Google Cloud 콘솔에서 Marketplace SDK 구성 페이지로 이동합니다.

   마켓플레이스 SDK 구성 페이지로 이동

2. 이전 섹션에서 확인한 내용을 바탕으로 각 섹션을 작성합니다.

3. 저장을 클릭합니다.

4. (선택사항) Google 애널리틱스에서 앱 사용에 대한 분석을 확인할 수 있습니다. 이렇게 하려면 마켓플레이스 SDK에 Google 애널리틱스 ID를 추가합니다.

   1. 분석 탭으로 이동합니다.
   2. Google 애널리틱스 ID를 입력합니다.
   3. 저장을 클릭합니다.