Gmail 또는 Calendar를 확장하는 부가기능을 이미 빌드하고 게시한 경우 이를 Google Workspace 부가기능으로 업그레이드할 수 있습니다. 이 페이지의 안내는 기존 Gmail 또는 Calendar 부가기능에 Google Workspace 기능을 추가한 후 업그레이드된 부가기능을 검색하고 설치할 수 있도록 게시하는 방법을 자세히 설명합니다.
새 기능을 원래 부가기능으로 이전하여 Google Workspace Marketplace 등록정보, 설치, 사용자를 유지할 수 있습니다. 업그레이드하면 홈페이지와 같은 새로운 Google Workspace 부가기능도 활용할 수 있습니다.
1단계: 부가기능의 Apps Script 프로젝트 사본 만들기
업그레이드된 부가기능은 게시된 부가기능과 동일한 Google Cloud 프로젝트를 사용하지만, 업그레이드된 버전을 테스트하는 동안 기존 사용자가 영향을 받지 않도록 기본 Apps Script 프로젝트의 사본을 만들고 사용해야 합니다. 원본 스크립트 프로젝트의 사본을 업그레이드하면 언제든지 원본 코드에 액세스할 수 있으며 필요한 경우 나중에 다시 배포할 수 있습니다.
- 기존 Gmail 부가기능 또는 Calendar 회의 부가기능 Apps Script 프로젝트를 엽니다.
- 왼쪽에서 개요 를 클릭합니다.
- 오른쪽에서 사본 만들기 를 클릭합니다.
- 왼쪽에서 프로젝트 설정 > 프로젝트 변경을 클릭합니다.
- GCP 프로젝트 번호를 클릭합니다.
- 기존에 게시된 부가기능 Apps Script 프로젝트와 연결된 것과 동일한 프로젝트 번호를 입력합니다.
- 프로젝트 설정을 클릭합니다.
2단계: Google Workspace 부가기능 통합
부가기능에 추가하려는 Google Workspace 부가기능 기능을 설계하고 구현해야 합니다.
- 부가기능의 홈페이지 카드에 표시할 콘텐츠와 Gmail, Calendar, Drive 또는 이 세 호스트의 조합에 표시할지 여부를 계획합니다. 두 개 이상의 호스트에 홈페이지를 표시하려면 동일한 홈페이지를 사용할지 아니면 각 호스트에 맞게 맞춤 홈페이지 카드를 사용할지 결정합니다.
- 복사한 부가기능 Apps Script 프로젝트에서
homepageTrigger함수를 사용하여 홈페이지 카드를 빌드합니다. 새 홈페이지 인터페이스를 제어하는 데 필요한 모든 지원 함수 또는 로직을 포함해야 합니다. Gmail 메시지 대화목록 또는 Calendar 일정 열기와 같이 사용자의 작업에 의해 트리거되는 문맥 카드를 추가해 보세요.
업데이트된 이벤트 객체 구조를 사용하도록 부가기능의 이벤트 객체 액세스 (위젯 콜백 함수 또는 문맥 트리거 함수)를 업데이트합니다. 새 구조에는 Gmail 및 Calendar 회의 부가기능에서 사용하는 동일한 일정 객체 필드가 계속 포함되지만 이러한 원래 필드는 지원 중단되어 궁극적으로 삭제됩니다.
3단계: 부가기능의 매니페스트 업데이트
Google Workspace 부가기능의 매니페스트 구조에 구성 정보가 저장되는 방식은 Gmail 부가기능 및 Calendar 회의 부가기능에서 사용하는 구조와 크게 달라졌습니다. 부가기능을 업그레이드할 때는 아래 표에 따라 부가기능의 Apps Script 프로젝트 매니페스트 필드를 업데이트해야 합니다. 모든 관련 하위 속성을 새 addOns 속성으로 업데이트해야 합니다.
업데이트된 부가기능에 필요한 권한을 반영하도록 필요에 따라 매니페스트의 oauthScopes 필드도 업데이트해야 합니다.
Google Workspace 부가기능 매니페스트에 관해 자세히 알아보려면 매니페스트를 참고하세요.
Gmail 부가기능
| 원본 매니페스트 필드 | 조치 필요 |
|---|---|
gmail.composeTrigger |
addOns.gmail.composeTrigger로 이동합니다. |
gmail.contextualTriggers[] |
목록을 addOns.gmail.contextualTriggers[]로 이동합니다. |
gmail.logoUrl |
addOns.common.logoUrl(으)로 이동합니다. |
gmail.name |
addOns.common.name로 이동합니다. |
gmail.openLinkUrlPrefixes[] |
목록을 addOns.common.openLinkUrlPrefixes[]로 이동합니다.
|
gmail.primaryColor |
addOns.common.layoutProperties.primaryColor로 이동합니다. |
gmail.secondaryColor |
addOns.common.layoutProperties.secondaryColor로 이동합니다.
|
gmail.universalActions[] |
목록을 addOns.common.universalActions[]로 이동합니다. |
gmail.universalActions[].text |
각 gmail.universalActions[].text 필드를 상응하는 addOns.common.universalActions[].label 필드로 이동합니다. |
gmail.useLocalFromApp |
addOns.common.useLocaleFromApp(으)로 이동합니다. |
Calendar 회의 부가기능
| 원본 매니페스트 필드 | 조치 필요 |
|---|---|
calendar.createSettingsUrlFunction |
addOns.calendar.createSettingsUrlFunction로 이동합니다. |
calendar.conferenceSolution[] |
addOns.calendar.conferenceSolution[]로 이동합니다. |
calendar.logoUrl |
addOns.common.logoUrl로 이동합니다. |
calendar.name |
addOns.common.name(으)로 이동합니다. |
4단계: 업그레이드된 부가기능 테스트
게시하기 전에 업그레이드된 부가기능을 테스트하려면 Google Workspace 부가기능 테스트를 참고하세요.
5단계: 업그레이드된 부가기능 검토 요청
업그레이드된 부가기능이든 처음부터 빌드된 부가기능이든 모든 Google Workspace 부가기능은 승인을 받아야 Google Workspace Marketplace에 등록될 수 있습니다.
부가기능을 제출하여 검토받으려면 다음 단계를 따르세요.
부가기능이 모든 부가기능 게시 요구사항을 충족하는지 확인합니다.
게시하려는 코드 버전을 사용하여 새 Apps Script 프로젝트에서 Google Workspace 부가기능의 버전별 배포를 만듭니다. 헤드 배포를 사용하여 게시하지 마세요.
부가기능을 업그레이드하는 동안 새 범위를 추가한 경우 OAuth 인증을 요청해야 합니다. 예를 들어 Gmail 부가기능이 Google Workspace 부가기능 버전에서 새 Drive 또는 Calendar 범위를 사용하는 경우 확인을 위해 새 범위를 제출해야 합니다. 인증을 완료하는 데 며칠이 걸리는 경우가 많으므로 최대한 빨리 절차를 시작하세요. 6단계로 진행하기 전에 부가기능이 인증되었는지 확인합니다.
6단계: 업그레이드된 부가기능 사용 설정
Google Workspace Marketplace SDK를 엽니다.
왼쪽에서 구성을 클릭합니다. 이 패널에는 부가기능에 관한 정보를 입력할 수 있는 양식이 있습니다.
Google Workspace 부가기능의 새로운 기능을 반영하도록 등록정보의 간단한 설명, 자세한 설명, 스크린샷을 업데이트합니다.
확장 프로그램에서 Google Workspace 부가기능으로 업그레이드 버튼을 클릭합니다. 표시되는 텍스트 상자에 이전 단계에서 Google Workspace 부가기능에 대해 만든 새 배포 ID를 입력합니다. 배포 ID가 유효하면 지원되는 호스트 목록이 표시됩니다.
Google Workspace 부가기능에 새 범위를 추가한 경우 구성 페이지의 OAuth 2.0 범위 섹션에 범위를 추가해야 합니다. 이 섹션에 나열된 범위는 부가기능의 매니페스트에 나열된 범위와 정확하게 일치해야 합니다.
양식에 입력한 정보가 올바른지 확인합니다. 그런 다음 변경사항 저장을 클릭합니다.
Google Workspace 부가기능 업그레이드 과정에서 궁금한 점이 있거나 문제가 발생하면 Google에 문의하세요.
FAQ
다음은 부가기능 업그레이드와 관련하여 자주 묻는 질문입니다.
편집기 부가기능을 업그레이드할 수 있나요?
대부분의 편집기 부가기능은 Google Workspace 부가기능으로 이전할 수 있습니다. 하지만 Gmail 및 Calendar용 부가기능만큼 쉽게 Google Workspace 부가기능으로 업그레이드할 수는 없습니다.
편집기 부가기능을 Google Workspace 부가기능으로 이전하려면 부가기능의 UI를 HTML에서 카드 기반 인터페이스로 재작성하고 JavaScript 처리를 카드 서비스로 업데이트해야 합니다.
기존 편집기 부가기능의 일부 서비스는 카드 서비스에서 사용할 수 없습니다. 예를 들어 편집기 부가기능에 파일 선택 도구가 포함되어 있는 경우 Google Workspace 부가기능용 카드 서비스에서 이에 상응하는 기능을 사용할 수 없습니다.
별도의 Google Workspace 부가기능을 빌드하고 기존 부가기능을 유지할 수 있나요?
다른 브랜드 이름으로 Google Workspace 부가기능을 추가로 빌드할 수 있지만 Google Workspace 부가기능과 동일한 브랜드 이름으로 별도의 Gmail 또는 Calendar 회의 부가기능을 제공하는 것은 허용되지 않습니다. 궁금한 점이 있거나 예외를 요청하려면 Google에 문의하세요.
업그레이드 후 사용자는 부가기능을 다시 승인해야 하나요?
Google Workspace 부가기능이 연결된 OAuth 클라이언트 ID와 함께 동일한 기본 Cloud Platform (GCP) 프로젝트를 사용하는 한 사용자는 이전에 원래 부가기능에 승인한 권한을 다시 승인할 필요가 없습니다. 하지만 업그레이드 프로세스 중에 새 범위를 추가하는 경우 사용자는 부가기능의 Google Workspace 버전을 처음 사용할 때 새 범위를 승인해야 합니다.
Chrome 확장 프로그램을 Google Workspace 부가기능으로 업그레이드하고 사용자를 이전할 수 있나요?
아니요. Chrome 확장 프로그램의 사용자, 설치, 등록정보 리뷰는 이전할 수 없습니다. 새 Google Workspace 부가기능을 만들고 Chrome 확장 프로그램 사용자를 Google Workspace Marketplace로 안내해야 합니다.
Google Workspace 부가기능과 여러 개의 부가기능을 번들로 묶을 수 있나요?
앱 통합 함께 나열을 참고하세요.