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