이미 Gmail 또는 Calendar를 확장하기 위해 부가기능을 빌드하고 게시한 경우 Google Workspace 부가기능으로 업그레이드할 수 있습니다. 이 페이지의 안내에서는 Google Workspace 기능을 기존 Gmail 또는 Calendar 부가기능에 추가한 다음 업그레이드된 부가기능을 게시하여 검색 및 설치할 수 있도록 하는 방법을 자세히 설명합니다.
새 기능을 원래 부가기능으로 이전하여 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 메시지 대화목록 또는 캘린더 일정 열기와 같이 사용자의 작업에 따라 트리거되는 컨텍스트 카드를 추가하는 것이 좋습니다.
업데이트된 이벤트 객체 구조를 사용하도록 부가기능 (위젯 콜백 함수 또는 컨텍스트 트리거 함수)의 이벤트 객체 액세스를 업데이트합니다. 새 구조에는 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
다음은 부가기능 업그레이드와 관련하여 자주 묻는 질문(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 부가기능과 함께 여러 부가기능을 번들로 묶을 수 있나요?
앱 통합 함께 나열을 참고하세요.