고급 Calendar 서비스를 사용하면 Apps Script에서 공개 Google Calendar API를 사용할 수 있습니다. Apps Script의 기본 제공 Calendar 서비스와 마찬가지로 이 API를 사용하면 스크립트에서 사용자의 구독 중인 캘린더를 비롯하여 사용자의 Google Calendar에 액세스하고 수정할 수 있습니다. 대부분의 경우 기본 제공 서비스는 더 사용하기 쉽지만 이 고급 서비스는 개별 이벤트의 배경색 설정 등 몇 가지 추가 기능을 제공합니다.
참조
이 서비스에 대한 자세한 내용은 공개 Google Calendar API에 관한 참조 문서를 확인하세요. Apps Script의 모든 고급 서비스와 마찬가지로 고급 Calendar 서비스는 공개 API와 동일한 객체, 메서드, 매개변수를 사용합니다. 자세한 내용은 메서드 서명이 결정되는 방법을 참고하세요.
문제를 보고하고 다른 지원을 받으려면 캘린더 지원 가이드를 참고하세요.
HTTP 요청 헤더
고급 캘린더 서비스는 HTTP 요청 헤더 If-Match
및 If-None-Match
를 사용할 수 있습니다. 자세한 내용은 참조 문서를 확인하세요.
샘플 코드
아래 샘플 코드는 API의 버전 3을 사용합니다.
이벤트 만들기
다음 예는 사용자의 기본 캘린더에서 이벤트를 만드는 방법을 보여줍니다.
캘린더 나열
다음 예는 사용자의 캘린더 목록에 표시된 캘린더에 대한 세부정보를 검색하는 방법을 보여줍니다.
이벤트 나열
다음 예에서는 사용자의 기본 캘린더에 예정된 다음 일정 10개를 나열하는 방법을 보여줍니다.
조건부로 이벤트 수정
다음 예는 If-Match
헤더를 사용하여 Calendar 일정을 조건부로 업데이트하는 방법을 보여줍니다. 이 스크립트는 새 이벤트를 만들고 30초 동안 기다린 후 이벤트 생성 이후 이벤트 세부정보가 변경되지 않은 경우에만 이벤트를 업데이트합니다.
조건부로 이벤트 검색
다음 예는 If-None-Match
헤더를 사용하여 Calendar 일정을 조건부로 가져오는 방법을 보여줍니다. 스크립트는 새 이벤트를 만든 후 30초 동안 변경사항을 폴링합니다. 이벤트가 변경될 때마다 새 버전을 가져옵니다.
동기화 일정
다음 예시에서는 동기화 토큰을 사용하여 이벤트를 검색하는 방법을 보여줍니다. Calendar 고급 서비스 요청에 동기화 토큰을 포함하면 토큰이 생성된 이후에 변경된 항목만 결과에 포함됩니다. 따라서 더 효율적인 처리가 가능합니다. 동기화 프로세스에 관한 자세한 내용은 리소스를 효율적으로 동기화를 참고하세요.
다음 예에서는 위 예에서 정의된 것과 동일한 getRelativeDate(daysOffset, hour)
메서드를 사용합니다.