Gmail 또는 Calendar를 확장하는 부가기능을 이미 빌드하고 게시했다면 Google Workspace 부가기능으로 업그레이드할 수 있습니다. 이 페이지의 안내는 기존 Gmail 또는 Calendar 부가기능에 Google Workspace 기능을 추가한 다음 업그레이드된 부가기능을 찾아 게시할 수 있도록 게시하는 방법을 자세히 설명합니다.
새 기능을 원래 부가기능으로 이전하여 Google Workspace Marketplace 등록정보, 설치 수, 사용자를 유지할 수 있습니다. 업그레이드하면 홈페이지와 같은 새로운 Google Workspace 부가기능도 활용할 수 있습니다.
1단계: 부가기능의 Apps Script 프로젝트 사본 만들기
업그레이드된 부가기능은 게시된 부가기능과 동일한 Google Cloud 프로젝트를 사용하지만 업그레이드된 버전을 테스트하는 동안 기존 사용자가 영향을 받지 않도록 기본 Apps Script 프로젝트의 사본을 만들고 사용하는 것이 중요합니다. 원본 스크립트 프로젝트의 사본을 업그레이드하면 언제든지 원본 코드에 액세스할 수 있고 필요한 경우 나중에 다시 배포할 수 있습니다.
- 기존 Gmail 부가기능 또는 캘린더 회의 부가기능 Apps Script 프로젝트를 엽니다.
- 왼쪽에서 Overview(개요) 를 클릭합니다.
- 오른쪽에서 사본 만들기 를 클릭합니다.
- 왼쪽에서 프로젝트 설정 > 프로젝트 변경을 클릭합니다.
- 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 부가기능으로 이전할 수 있습니다. 그러나 Google Workspace 부가기능으로는 Gmail 및 Calendar의 부가기능만큼 쉽게 업그레이드할 수 없습니다.
편집기 부가기능을 Google Workspace 부가기능으로 이전하려면 부가기능의 UI를 HTML에서 카드 기반 인터페이스로 다시 작성하고 자바스크립트 처리를 카드 서비스로 업데이트해야 합니다.
기존 편집기 부가기능의 일부 서비스는 카드 서비스에서 사용하지 못할 수 있습니다. 예를 들어 편집기 부가기능에 파일 선택 도구가 포함된 경우 Google Workspace 부가기능의 카드 서비스에서 이에 상응하는 항목을 사용할 수 없습니다.
별도의 Google Workspace 부가기능을 만들고 기존 부가기능을 유지할 수 있나요?
다른 브랜드 이름으로 Google Workspace 부가기능을 추가로 만들 수 있지만 Google Workspace 부가기능과 동일한 브랜드 이름으로 Gmail 또는 Calendar 회의 부가기능을 별도로 만들 수는 없습니다. 궁금한 점이 있거나 예외를 요청하려면 Google에 문의해 주세요.
부가기능이 업그레이드된 후 사용자가 부가기능을 다시 인증해야 하나요?
Google Workspace 부가기능이 동일한 기본 Cloud Platform (GCP) 프로젝트와 연결된 OAuth 클라이언트 ID를 사용하는 경우, 사용자가 이전에 원래 부가기능에 승인한 권한을 다시 승인할 필요가 없습니다. 그러나 업그레이드 프로세스 중에 새 범위를 추가하는 경우 사용자가 Google Workspace 버전의 부가기능을 처음 사용할 때 이러한 새 범위를 승인해야 합니다.
Chrome 확장 프로그램을 Google Workspace 부가기능으로 업그레이드하고 사용자를 이전할 수 있나요?
아니요. Chrome 확장 프로그램의 사용자, 설치, 등록정보 리뷰는 이전할 수 없습니다. 새 Google Workspace 부가기능을 만들고 Chrome 확장 프로그램 사용자를 Google Workspace Marketplace로 안내해야 합니다.
여러 부가기능을 Google Workspace 부가기능과 번들로 묶을 수 있나요?
앱 통합과 함께 나열을 참고하세요.