Google Workspace 부가기능은 사용자가 캘린더 및 캘린더 일정을 보거나 수정할 때 맞춤설정된 인터페이스를 제공할 수 있습니다. 이를 통해 사용자에게 추가 관련 정보를 제공하고, 작업을 자동화하고, 타사 시스템을 Google Calendar에 연결할 수 있습니다.
Google Calendar용 부가기능 인터페이스를 구축할 때 홈페이지를 제공할 수 있습니다. 여러 호스트에 동일한 홈페이지를 사용하거나 Google Calendar용으로 특정 홈페이지를 디자인할 수 있습니다.
부가기능은 사용자가 캘린더 일정을 연 경우 표시되는 인터페이스를 정의할 수도 있습니다.
부가기능 UI에 액세스
Google Workspace 부가기능은 열리는 방식에 따라 홈페이지 인터페이스, Google Calendar 일정 인터페이스, 첨부파일 선택 인터페이스 또는 이 세 가지 모두를 정의할 수 있습니다.
- 사용자가 캘린더 뷰에서 부가기능 아이콘을 클릭하면 부가기능은 상응하는
calendar.homepageTrigger함수 (있는 경우)를 실행합니다. 이 함수는 홈페이지 카드를 빌드하고 캘린더에 반환하여 표시합니다.calendar.homepageTrigger함수가 정의되지 않으면 일반 홈페이지 카드가 대신 표시됩니다. - 사용자가 Calendar 일정을 연 후 부가기능 아이콘을 클릭하거나 이벤트를 열 때 부가기능이 열려 있는 경우 부가기능은 상응하는
eventOpenTrigger함수 (있는 경우)를 실행합니다. 이 함수는 부가기능의 캘린더 이벤트 인터페이스를 빌드하고 표시하기 위해 Google Calendar로 반환합니다. - 부가기능에서
eventAttachmentTrigger함수를 정의하는 경우 사용자가 Calendar 일정을 수정하는 동안 첨부파일 추가를 클릭하면 부가기능이 첨부파일 제공업체로 표시됩니다. 부가기능이 선택되면eventAttachmentTrigger함수가 부가기능의 첨부파일 선택 인터페이스를 빌드하고 표시하기 위해 Google Calendar에 반환합니다.
부가기능 캘린더 인터페이스 빌드
다음 단계에 따라 Google Workspace 부가기능으로 Google Calendar를 확장할 수 있습니다.
- 부가기능에 캘린더별 홈페이지를 포함할지 여부를 결정합니다. 또한 사용자가 캘린더 이벤트를 수정하는 동안 맞춤 인터페이스를 제공할지 여부를 결정합니다.
- 필요한 범위를 포함하여 적절한
addOns.common및addOns.calendar필드를 부가기능 스크립트 프로젝트 매니페스트에 추가합니다. - 캘린더별 홈페이지를 제공하는 경우
calendar.homepageTrigger함수를 구현하여 이 인터페이스를 빌드합니다. 여러 Google Workspace 호스트에common.homepageTrigger인터페이스를 사용할 수도 있습니다. - 캘린더 이벤트 인터페이스를 제공하는 경우
calendar.eventOpenTrigger함수를 구현하여 이 인터페이스를 빌드해야 합니다. 자세한 내용은 캘린더 이벤트 인터페이스 확장을 참고하세요. - 버튼 클릭과 같은 사용자의 UI 상호작용에 응답하는 데 필요한 연결된 콜백 함수를 구현합니다.
Calendar 홈페이지
Google Calendar에서는 Google Workspace 부가기능 홈페이지를 표시할 수 있습니다.
Google Calendar에 부가기능의 일반적인 홈페이지를 표시하려면 부가기능의 매니페스트에 addOns.calendar 필드가 있는지 확인하기만 하면 됩니다.
또는 부가기능 매니페스트에 calendar.homepageTrigger를 추가하여 Calendar별 홈페이지를 제공합니다.
두 경우 모두 부가기능의 스크립트 프로젝트에 홈페이지 트리거 함수의 이름을 제공해야 합니다. 이 함수는 필요할 때 Google 캘린더 홈페이지를 빌드하기 위해 자동으로 호출됩니다. 이 함수를 구현하여 단일 Card 또는 홈페이지를 구성하는 Card 객체의 배열을 빌드하고 반환해야 합니다. 홈페이지 트리거 함수에는 클라이언트의 플랫폼과 같은 일부 일반 정보가 포함된 매개변수로 이벤트 객체가 전달됩니다. 이벤트 객체 데이터를 사용하여 홈페이지 구성을 맞춤설정할 수
있습니다.
캘린더 일정 인터페이스 확장
Google Calendar는 컨텍스트 트리거를 사용하여 사용자가 캘린더 이벤트를 수정할 때 표시할 인터페이스(있는 경우)를 결정합니다. 트리거가 실행되면 부가기능 매니페스트의 calendar.eventOpenTrigger 필드에서 지정한 컨텍스트 트리거 함수를 실행합니다.
calendar.eventOpenTrigger 필드에 이름이 지정된 함수를 구현해야 합니다. 이 함수는 이벤트 객체를 인수로 허용하며 사용자가 이벤트를 열어 둔 동안 Calendar에 표시할 단일 Card 객체 또는 Card 객체의 배열을 반환해야 합니다.
이벤트 객체
사용자가 Calendar 이벤트를 열면 이벤트 객체가 생성되어 calendar.eventOpenTrigger 문맥 트리거 함수에 전달됩니다. 트리거 함수는 이 이벤트 객체의 정보를 사용하여 부가기능 카드를 구성하는 방법이나 부가기능 동작을 제어하는 방법을 결정할 수 있습니다. 부가기능이 처음 열릴 때와 사용자가 대화형 위젯을 클릭하거나 선택할 때 이벤트 객체가 생성되고 homepageTrigger 함수에 전달됩니다.
이벤트 객체의 전체 구조는 이벤트 객체에 설명되어 있습니다. Calendar가 부가기능의 호스트 앱인 경우 컨텍스트 트리거와 위젯 상호작용 이벤트 객체에는 Calendar 관련 클라이언트 정보를 전달하는 Calendar 이벤트 객체 필드가 포함됩니다.
캘린더 일정 업데이트
사용자가 수정을 위해 Calendar 일정을 열 때 실행되는 컨텍스트 calendar.eventOpenTrigger 외에도 사용자가 Calendar 일정을 업데이트하고 저장할 때 실행되는 calendar.eventUpdateTrigger를 정의할 수 있습니다. 이 트리거는 사용자가 다음 중 하나 이상을 수정하는 경우에만 실행됩니다.
- 한 명 이상의 참석자를 추가합니다.
- 한 명 이상의 참석자를 삭제합니다.
- 다른 회의 솔루션으로 추가 또는 전환
이 트리거가 실행되면 calendar.eventUpdateTrigger 매니페스트 필드에 지정된 트리거 함수가 실행됩니다. 이 함수는 캘린더 이벤트 edit이 저장되기 전에 실행됩니다.
calendar.eventUpdateTrigger는 일반적으로 다음 중 하나 이상을 실행하는 데 사용됩니다.
- Calendar 이벤트의 사용자 변경에 따라 부가기능의 캘린더 이벤트 인터페이스를 업데이트합니다.
- 캘린더 일정 데이터를 Google Calendar에 연결된 회의 시스템 등 서드 파티 시스템과 동기화
부가기능에서 Calendar 일정 데이터 (예: 참석자 목록)를 조정해야 하는 경우 부가기능 calendar.currentEventAccess 매니페스트 필드를 WRITE 또는 READ_WRITE로 설정해야 합니다. 또한 부가기능에 https://www.googleapis.com/auth/calendar.addons.current.event.write
범위가 있어야 합니다.
회의 솔루션 추가
회의 솔루션은 사용자가 Google Calendar 일정에 연결할 수 있는 타사 회의 옵션을 나타냅니다. 타사 회의 개요 문서에서는 새 회의 솔루션을 추가하는 부가기능을 빌드하는 방법을 자세히 설명합니다. 이러한 유형의 확장 프로그램에는 UI를 빌드할 필요가 없습니다. 추가된 솔루션은 Google Calendar 이벤트 UI의 드롭다운 메뉴에 옵션으로 표시됩니다.