사용자가 부가기능을 열고 사용하려면 먼저 부가기능을 설치하고 승인해야 합니다. 이 단계는 부가기능 사용자 환경의 첫 번째 부분이므로 자체 부가기능을 만들기 전에 이를 이해해야 합니다.
이 문서 섹션에서는 사용자가 부가기능을 설치, 승인, 시작하는 방법을 설명합니다.
부가기능 설치
부가기능을 사용하려면 먼저 설치해야 합니다. 설치된 부가기능은 확장하는 Google Workspace 호스트 애플리케이션에서 사용할 수 있습니다.
게시된 부가기능은 Google Workspace 호스트 애플리케이션 또는 Google Workspace Marketplace에서 설치할 수 있습니다. 도메인 관리자는 Google Workspace Marketplace에서 사용자를 대신하여 부가기능을 설치할 수도 있습니다. 개발 중인 게시되지 않은 부가기능을 설치하여 테스트할 수도 있습니다. 설치된 부가기능을 처음 사용하려면 먼저 승인해야 합니다.
자세한 내용은 부가기능 게시를 참고하세요.
부가기능 승인
부가기능을 설치하면 확장하는 Google Workspace 호스트 애플리케이션에서 사용할 수 있습니다. 사용자가 부가기능을 처음 사용하려고 하면 호스트 애플리케이션에서 승인 카드 또는 대화상자를 표시합니다. 이 카드에서는 부가기능이 사용자를 위해 수행하는 작업(예: 현재 Google 시트의 콘텐츠에 액세스)에 필요한 권한을 설명합니다. 그러면 사용자는 이러한 권한을 부여하고 부가기능을 진행하도록 허용할 수 있습니다. 사용자가 부가기능 승인을 거부하면 부가기능을 사용할 수 없습니다.
편집기 부가기능은 Google Workspace 부가기능과 다른 승인 모델을 사용합니다. 편집기 부가기능은 Google Drive 파일에서 작동하므로 편집기 승인 모델은 부가기능이 개별 파일과 함께 사용될 때 발생하는 다양한 승인 모드를 정의합니다. 편집기 부가기능을 개발할 때는 다양한 모드와 부가기능이 모드 간에 이동하는 방식을 이해하는 것이 중요합니다.
게시된 부가기능 승인
게시된 부가기능을 설치하면 승인 흐름이 즉시 시작됩니다.
- 부가기능을 설치할 계정을 선택하라는 메시지가 표시됩니다.
- 그러면 부가기능이 작동하는 데 필요한 승인 목록이 표시되므로 부가기능이 어떤 작업을 시도하는지 알 수 있습니다. 이 목록을 신중하게 검토한 후에도 승인하려면 허용을 클릭합니다. 이렇게 하면 부가기능을 사용할 수 있습니다.
- 이제 확장하는 호스트 애플리케이션에서 실행할 수 있습니다. 애플리케이션이 이미 브라우저 탭에 열려 있는 경우 부가기능을 사용하기 전에 탭을 새로고침해야 할 수 있습니다.
설치한 부가기능이 나중에 업데이트되어 아직 부여하지 않은 추가 승인이 필요한 경우 다음에 부가기능을 사용할 때 이러한 권한을 제공하라는 메시지가 표시됩니다.
게시되지 않은 Google Workspace 부가기능 승인
게시되지 않은 부가기능은 아직 Google Workspace Marketplace에 표시되지 않으므로 게시된 부가기능과 동일한 승인 흐름을 따르지 않습니다. 게시되지 않은 부가기능을 설치한 후에는 즉시 승인하라는 메시지가 표시되지 않습니다. 대신 부가기능을 처음 사용하려고 할 때 승인 흐름이 시작됩니다.
부가기능이 실행되면 사용자 승인이 필요한지 판단합니다. 승인이 필요한 경우 부가기능에 승인 카드가 표시됩니다. 부가기능이 처음 실행될 때는 항상 승인이 필요하며, 새 버전의 부가기능이 이전에 승인되지 않은 서비스를 사용하는 경우에도 승인이 필요할 수 있습니다. 액세스 승인 버튼을 누르면 사용자가 부가기능의 승인을 허용하거나 거부할 수 있는 대화상자가 표시됩니다.
Google Workspace 부가기능에 Google 이외의 서비스 승인하기
Google Workspace 부가기능이 자체적으로 승인이 필요한 서드 파티 서비스에 연결할 수 있습니다. 이러한 서비스에 연결되는 Google Workspace 부가기능을 사용하려면 사용자가 다음 두 가지 작업을 별도로 실행해야 합니다.
- 부가기능이 설치되거나 처음 시작될 때 부가기능 자체의 승인
- 비Google 서비스에 처음 액세스할 때 승인
개발 중인 Google Workspace 부가기능에서 OAuth를 사용하여 Google 이외의 서비스에 액세스해야 하는 경우 부가기능을 빌드할 때 해당 서비스의 연결을 구성해야 합니다.
자세한 내용은 Google Workspace 부가기능을 서드 파티 서비스에 연결하기를 참고하세요.
서드 파티 회의 시스템
Google Calendar를 확장하는 Google Workspace 부가기능은 사용자가 Google Calendar 일정을 수정할 때 서드 파티 회의 시스템을 선택할 수 있는 회의 솔루션을 추가할 수도 있습니다. 부가기능에서 사용자가 로그인해야 하는 회의 옵션을 제공하는 경우 부가기능에서 사용자에게 로그인할 수 있는 기능을 제공해야 합니다.
사용자가 필요한 로그인 없이 부가기능으로 회의를 만들려고 하면 회의 솔루션의 onCreateFunction 메서드는 인증 URL이 포함된 ConferenceError을 포함하는 ConferenceData 객체를 반환해야 합니다.
이 객체를 수신하면 Google Calendar는 일정 수정 UI에 부가기능에서 제공하는 인증 URL로 연결되는 로그인 버튼을 만듭니다. 그러면 사용자는 이 버튼을 사용하여 부가기능을 추가로 사용하기 전에 서드 파티 시스템에 로그인할 수 있습니다.
ConferenceError를 사용하여 승인을 처리하는 방법에 관한 자세한 내용은 서드 파티 회의 만들기를 참고하세요.
게시되지 않은 편집기 부가기능 승인
편집기 부가기능을 개발할 때 테스트하는 것이 좋습니다. 승인 흐름은 부가기능을 처음 테스트하려고 할 때 시작된다는 점을 제외하고 게시된 편집기 부가기능의 승인 흐름과 동일합니다. 나중에 동일한 부가기능을 다시 테스트하면 승인 메시지가 다시 표시되지 않습니다.
부가기능 승인 취소
부가기능을 개발할 때 승인 흐름을 재테스트할 수 있도록 승인을 취소하는 것이 유용할 수 있습니다.
다음 단계에 따라 부가기능의 승인을 취소할 수 있습니다.
- 계정 보안 콘솔을 엽니다.
- 승인 해제하려는 부가기능을 찾아 클릭합니다.
- 액세스 권한 삭제를 클릭합니다.
부가기능의 인증을 해제한 후 다시 실행하면 인증 흐름이 다시 표시됩니다.
부가기능 제거하기
Google Workspace Marketplace에서 설치한 부가기능을 제거하려면 Marketplace 앱 또는 부가기능 제거하기를 참고하세요.
Apps Script에 내장된 게시되지 않은 부가기능을 제거하려면 게시되지 않은 부가기능 제거를 참고하세요.