이미 Gmail이나 캘린더를 확장할 수 있는 부가기능을 빌드하고 게시한 경우 Google Workspace 부가기능으로 업그레이드할 수 있습니다. 이 페이지의 안내에는 기존 Gmail 또는 Calendar 부가기능에 Google Workspace 기능을 추가하고 그런 다음 업그레이드된 부가기능을 검색하고 설치할 수 있도록 게시하세요.
새 기능을 원래 Google Workspace Marketplace 등록정보, 설치, 사용자를 유지할 수 있습니다. 업그레이드하면 새로운 Google Workspace 부가기능도 활용할 수 있습니다. 홈페이지 등).
1단계: 부가기능의 Apps Script 프로젝트 사본 만들기
업그레이드된 부가기능은 게시된 것과 동일한 Google Cloud 프로젝트를 사용합니다. 하지만 기본 앱 사본을 만들어 사용하는 것이 테스트하는 동안 기존 사용자에게 영향을 주지 않도록 프로젝트 스크립트 작성 확인할 수 있습니다 원본 스크립트 프로젝트의 사본을 업그레이드하면 즉, 언제든지 원본 코드에 액세스할 수 있으며 있습니다.
- 기존 Gmail 부가기능 또는 Calendar 회의 부가기능 Apps Script를 엽니다. 살펴보겠습니다
- 왼쪽에서 개요를 클릭합니다. 입니다.
- 오른쪽에서 사본 만들기 를 클릭합니다.
- 왼쪽에서 프로젝트 설정 > 프로젝트 변경을 클릭합니다.
- GCP 프로젝트 번호를 클릭합니다.
- 동일한 프로젝트 번호 연결된 기존 부가기능 Apps Script 프로젝트와 연결됩니다.
- 프로젝트 설정을 클릭합니다.
2단계: Google Workspace 부가기능 통합하기
추가하려는 Google Workspace 부가기능 기능을 설계하고 구현해야 합니다. 확인할 수 있습니다
- 부가기능에 표시할 콘텐츠를 계획하세요. 홈페이지 카드와 Gmail, Calendar, Drive 또는 이 세 가지의 조합에 표시되어야 합니다. 호스팅합니다 홈페이지를 둘 이상의 호스트에서 사용하려는 경우 동일한 홈페이지이거나 호스트별로 맞춤 홈페이지 카드를 원하는 경우에 사용할 수 있습니다.
- 복사한 부가기능 Apps Script 프로젝트에서 홈페이지를 만듭니다.
homepageTrigger
카드 함수와 일치해야 합니다. 코드 생성에 필요한 지원 함수 또는 로직은 제어할 수 있습니다. 예를 들어 Google 검색, YouTube, Facebook을 여는 등 사용자의 작업으로 트리거되는 Gmail 메시지 대화목록 또는 캘린더 일정
이벤트 객체의 액세스 업데이트 (위젯 콜백 함수 또는 문맥 트리거에서) 함수)를 사용하여 업데이트된 이벤트 객체 구조입니다. 새 구조에는 Gmail 및 캘린더 회의 부가기능에 적용되지만 원래 필드는 결국 삭제될 예정입니다
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 부가기능 버전의 경우 확인을 위해 새 범위를 제출해야 합니다. 확인을 완료하는 데 보통 며칠이 걸리므로 가능한 한 빨리 계속하기 전에 부가기능이 인증되었는지 확인하세요. 6단계로 이동합니다.
6단계: 업그레이드된 부가기능 사용 설정하기
Google Workspace Marketplace SDK를 엽니다.
왼쪽에서 구성을 클릭합니다. 이 패널에는 부가기능에 대한 정보를 제공합니다.
간단한 설명, 자세한 설명, 스크린샷을 에 Google Workspace 부가기능의 새로운 기능을 반영합니다.
확장 프로그램 아래에서 업그레이드 Google Workspace 부가기능 버튼을 클릭합니다. 표시되는 텍스트 상자에 새로 만든 배포 ID를 입력합니다. Google Workspace 부가기능에 대해 자세히 알아보세요. 배포 ID가 유효하면 지원되는 호스트 목록이 나타납니다.
Google Workspace 부가기능에 새 범위를 추가한 경우 해당 범위를 구성 페이지의 OAuth 2.0 범위 섹션을 참조하세요. 나열된 범위 이 섹션의 범위는 부가기능의 합니다.
양식에 입력한 정보가 올바른지 확인하세요. 그런 다음 변경사항 저장을 클릭합니다.
Google Workspace 부가기능 업그레이드 중에 궁금한 점이 있거나 문제가 발생하는 경우 Google에 문의해 주세요.
FAQ
다음은 부가기능 업그레이드와 관련하여 자주 묻는 질문(FAQ)입니다.
편집자 부가기능을 업그레이드할 수 있나요?
대부분의 편집자 부가기능은 Google Workspace 부가기능으로 이동할 수 있습니다. 하지만 Gmail 및 Google Workspace의 부가기능만큼 쉽게 Google Workspace 부가기능으로 업그레이드되며, 캘린더.
편집자 부가기능을 Google Workspace 부가기능으로 이전하려면 다음 요건을 충족해야 합니다. 부가기능의 UI를 HTML에서 카드 기반 인터페이스를 사용하고 JavaScript를 처리를 카드 서비스에 전달합니다.
기존 편집자 부가기능의 일부 서비스는 카드 서비스. 예를 들어 편집기 부가기능에 파일 선택 도구가 포함된 경우 Google Workspace 부가기능용 카드 서비스와 동등한 기능이 아닙니다.
별도의 Google Workspace 부가기능을 빌드하고 기존 부가기능을 유지할 수 있나요?
다른 브랜드 이름으로 Google Workspace 부가기능을 추가로 빌드할 수 있습니다. 그러나 개별 Gmail 또는 캘린더 회의용 부가기능은 Google Workspace 부가기능과 동일한 브랜드 이름을 사용해야 합니다. 질문 또는 요청 사항 Google에 문의하세요.
부가기능이 업그레이드된 후 사용자가 해당 부가기능을 다시 승인해야 하나요?
Google Workspace 부가기능이 동일한 기본 Cloud Platform (GCP) 프로젝트 연결된 OAuth 클라이언트 ID를 사용하면 사용자가 다시 인증할 필요가 없습니다. 권한을 부여할 수 있습니다. 그러나 업그레이드 프로세스 중에 새 범위를 추가하면 사용자가 해당 범위를 승인해야 합니다. 새로운 범위의 액세스 권한을 버전도 표시됩니다
Chrome 확장 프로그램을 Google Workspace 부가기능으로 업그레이드하고 사용자를 이전할 수 있나요?
아니요. Chrome 확장 프로그램의 사용자, 설치, 목록은 이전할 수 없습니다. 리뷰. 새 Google Workspace 부가기능을 만들고 Chrome 사용자를 안내해야 합니다. Google Workspace Marketplace로 확장되었습니다
Google Workspace 부가기능과 함께 여러 부가기능을 번들로 묶을 수 있나요?
앱 통합 함께 나열을 참고하세요.