Google Workspace Marketplace SDK에서 앱 구성

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

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

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

앱을 공개 또는 비공개로 게시하는지에 관계없이 Google Workspace Marketplace SDK를 사용하여 Marketplace에서 앱을 관리해야 합니다.

Google Workspace Marketplace SDK 사용 설정

아직 사용 설정하지 않은 경우 Google Cloud 프로젝트에서 Google Workspace Marketplace SDK를 사용 설정합니다.

  1. Google Cloud 콘솔을 엽니다. 
  2. 상단에서 프로젝트 선택을 클릭합니다. 다른 Google Cloud 프로젝트가 이미 열려 있는 경우 Cloud 프로젝트 이름을 클릭하여 Cloud 프로젝트를 전환합니다.
  3. 앱의 Cloud 프로젝트를 선택하고 열기를 클릭합니다.
  4. 상단의 검색창에 Google Workspace Marketplace SDK를 입력하고 Enter 키를 누릅니다.
  5. Google Workspace Marketplace SDK 페이지를 엽니다.

  6. Google Workspace Marketplace SDK를 아직 사용 설정하지 않은 경우 사용 설정을 클릭합니다.

Google Workspace Marketplace SDK에 앱 설정 입력

  1. Google Workspace Marketplace SDK를 엽니다.
  2. 앱 구성 탭으로 이동합니다.
  3. 각 섹션에 앱에 관한 정보를 입력합니다. 각 설정에 관한 자세한 내용은 다음 섹션인 앱 구성 설정을 참고하세요.
  4. 저장을 클릭합니다.
  5. (선택사항) Google 애널리틱스에서 앱 사용에 대한 분석을 확인할 수 있습니다. 이렇게 하려면 Google Workspace Marketplace SDK에서 Google 애널리틱스 ID를 추가합니다.
    1. 분석 탭으로 이동합니다.
    2. Google 애널리틱스 ID를 입력합니다.
    3. 저장을 클릭합니다.

앱 구성 설정

다음 참조에서는 Google Workspace Marketplace SDK의 앱 구성 페이지에서 사용할 수 있는 설정을 설명합니다.

앱 공개 상태

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

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

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

앱을 사용할 수 있는 국가 및 지역을 제한하려면 스토어 등록정보를 생성할 때 배포 섹션에서 설정하세요.

설치 설정

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

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

앱 통합

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

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

Google Workspace 부가기능 (Apps Script)

Google Workspace 부가기능을 게시하려면 부가기능의 배포 ID를 제공해야 합니다. 배포 ID를 찾으려면 다음 단계를 따르세요.

  1. Apps Script 편집기에서 Google Workspace 부가기능을 엽니다.
  2. 배포 > 배포 관리를 클릭합니다.
  3. 배포 ID에서 복사를 클릭합니다.

Google Workspace 부가기능 (대체 런타임)

Google Apps Script가 아닌 코딩 언어로 Google Workspace 부가기능을 빌드한 경우 다음 단계에 따라 Google Cloud 배포 리소스에서 배포 ID를 가져옵니다.

  1. 앱 구성 페이지의 'Google Workspace 부가기능'에서 클라우드 배포 리소스를 사용하여 배포 > 배포 선택을 클릭합니다.
  2. 게시할 배포를 선택합니다.
  3. 선택을 클릭합니다.

편집기 부가기능 (Docs, Sheets, Slides, Forms)

편집자 부가기능을 게시하려면 게시할 프로젝트 스크립트 ID버전을 제공해야 합니다.

프로젝트 스크립트 ID를 찾으려면 다음 단계를 따르세요.

  1. Apps Script 편집기에서 부가기능을 엽니다.
  2. 왼쪽에서 프로젝트 설정 을 클릭합니다.
  3. 'ID'에서 스크립트 ID를 복사합니다.

버전을 확인하려면 다음 단계를 따르세요.

  1. Apps Script 편집기에서 부가기능을 엽니다.
  2. 오른쪽 상단에서 배포 > 배포 관리를 클릭합니다.
  3. 버전 번호는 '구성'에 있습니다.

Google Chat 앱

Google Chat 앱을 게시하려면 Google Chat API를 구성해야 합니다. 앱 게시를 참조하세요.

Drive 앱

드라이브 앱을 게시하려면 Drive API를 사용 설정하고 구성해야 합니다.

웹 앱

웹 앱을 게시하려면 Google 앱 메뉴 에서 웹 앱으로 연결되는 URL인 범용 탐색 URL을 제공해야 합니다. 웹 앱은 프로덕션 단계이며 제대로 작동해야 합니다.

스토어 등록정보 페이지를 작성할 때 96x96 및 48x48픽셀 크기의 추가 아이콘을 제공해야 합니다.

Apps Script에서 웹 앱을 빌드한 경우 범용 탐색 URL을 가져오려면 다음 단계를 따르세요.

  1. Apps Script 편집기에서 Google Workspace 부가기능을 엽니다.
  2. 배포 > 새 배포를 클릭합니다.
  3. '유형 선택'에서 웹 앱을 클릭합니다.
  4. 옵션을 작성하고 배포를 클릭합니다.
  5. 복사를 클릭합니다.

OAuth 범위

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

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

항상 가능한 가장 좁은 범위를 사용합니다. 예를 들어 읽기 전용 범위만 필요한 경우 전체 드라이브 범위를 포함하지 않습니다.

Apps Script 프로젝트에 대한 자세한 내용은 범위를 참조하세요.

개발자 정보

이 필드는 앱의 스토어 등록정보 페이지에 표시됩니다.

필드
사업자 상태

소비자 보호법에 따라 유럽 경제 지역 (EEA)에 거주하는 소비자에게 Google Workspace Marketplace의 판매자가 판매자인지 비사업자인지 알려야 합니다.

  • 사업자 - 사업자란 무역, 비즈니스, 공예, 직종과 관련된 목적을 위해 행동하거나 사업자를 대신하여 행동하는 사람입니다.
  • 비사업자—비사업자 (소비자)는 비전문적인 목적으로 행동하는 사람입니다.

지정하지 않으면 앱의 스토어 등록정보 페이지에 '사업자 상태 미지정'이 표시됩니다.

개발자 우편 주소

판매자의 경우 필수사항입니다. 비판매자인 경우 수집되지 않습니다.

사업장의 위치입니다. 연락할 수 있는 유효한 우편 주소를 입력하세요.

개발자 이름 앱의 작성자로 표시할 이름입니다. 사업자인 경우 상호 또는 법적 이름을 입력합니다.
개발자 웹사이트 URL 본인 (또는 내 조직)을 개발자로 설명하는 웹사이트입니다.
개발자 이메일

담당자로 사용할 이메일 주소입니다. 앱 등록정보에 포함되어 있지 않습니다. 이 이메일 주소는 다음과 같이 최신 상태로 유지되어야 합니다.

  • Google이 개발자에게 문의해야 하는 경우(예: 앱 검토 과정 중)
  • 스토어 등록정보 페이지에 문제 신고 URL이 없는 경우 에디터 부가기능에서 의견을 보낼 수 있습니다.
애플리케이션 웹사이트 URL 선택사항입니다. 앱에 관해 자세히 설명하는 웹사이트입니다.