이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class CalendarApp

스크립트가 사용자의 Google Calendar를 읽고 업데이트하도록 허용합니다. 이 클래스를 통해 사용자의 기본 캘린더에 직접 액세스할 수 있을 뿐만 아니라 사용자가 소유하거나 구독 중인 추가 캘린더를 검색할 수도 있습니다.

속성

속성	유형	설명
`Color`	`Color`	Calendar 서비스에서 사용할 수 있는 이름이 지정된 색상을 나타내는 enum입니다.
`EventColor`	`EventColor`	캘린더 서비스에서 사용할 수 있는, 이름이 지정된 일정 색상을 나타내는 enum입니다.
`GuestStatus`	`GuestStatus`	참석자가 이벤트에 대해 가질 수 있는 상태를 나타내는 enum입니다.
`Month`	`Month`	월을 나타내는 열거형입니다.
`Visibility`	`Visibility`	이벤트의 공개 상태를 나타내는 enum입니다.
`Weekday`	`Weekday`	요일을 나타내는 enum입니다.

방법

메서드	반환 유형	간략한 설명
`createAllDayEvent(title, date)`	`CalendarEvent`	새로운 종일 일정을 만듭니다.
`createAllDayEvent(title, startDate, endDate)`	`CalendarEvent`	여러 날에 걸쳐 새로운 종일 일정을 만듭니다.
`createAllDayEvent(title, startDate, endDate, options)`	`CalendarEvent`	여러 날에 걸쳐 새로운 종일 일정을 만듭니다.
`createAllDayEvent(title, date, options)`	`CalendarEvent`	새로운 종일 일정을 만듭니다.
`createAllDayEventSeries(title, startDate, recurrence)`	`CalendarEventSeries`	새로운 종일 일정 만들기
`createAllDayEventSeries(title, startDate, recurrence, options)`	`CalendarEventSeries`	새로운 종일 일정 만들기
`createCalendar(name)`	`Calendar`	사용자가 소유한 새 캘린더를 만듭니다.
`createCalendar(name, options)`	`Calendar`	사용자가 소유한 새 캘린더를 만듭니다.
`createEvent(title, startTime, endTime)`	`CalendarEvent`	새 이벤트를 만듭니다.
`createEvent(title, startTime, endTime, options)`	`CalendarEvent`	새 이벤트를 만듭니다.
`createEventFromDescription(description)`	`CalendarEvent`	자유 형식 설명으로 이벤트를 만듭니다.
`createEventSeries(title, startTime, endTime, recurrence)`	`CalendarEventSeries`	새 이벤트 시리즈를 만듭니다.
`createEventSeries(title, startTime, endTime, recurrence, options)`	`CalendarEventSeries`	새 이벤트 시리즈를 만듭니다.
`getAllCalendars()`	`Calendar[]`	사용자가 소유하거나 구독 중인 모든 캘린더를 가져옵니다.
`getAllOwnedCalendars()`	`Calendar[]`	사용자가 소유한 모든 캘린더를 가져옵니다.
`getCalendarById(id)`	`Calendar`	지정된 ID가 있는 캘린더를 가져옵니다.
`getCalendarsByName(name)`	`Calendar[]`	사용자가 소유하거나 구독 중인 특정 이름의 모든 캘린더를 가져옵니다.
`getColor()`	`String`	캘린더의 색상을 가져옵니다.
`getDefaultCalendar()`	`Calendar`	사용자의 기본 캘린더를 가져옵니다.
`getDescription()`	`String`	캘린더 설명을 가져옵니다.
`getEventById(iCalId)`	`CalendarEvent`	지정된 ID의 이벤트를 가져옵니다.
`getEventSeriesById(iCalId)`	`CalendarEventSeries`	지정된 ID가 있는 이벤트 시리즈를 가져옵니다.
`getEvents(startTime, endTime)`	`CalendarEvent[]`	지정된 시간 범위 내에 발생하는 모든 이벤트를 가져옵니다.
`getEvents(startTime, endTime, options)`	`CalendarEvent[]`	지정된 기간 내에 발생하고 지정된 기준을 충족하는 모든 이벤트를 가져옵니다.
`getEventsForDay(date)`	`CalendarEvent[]`	지정된 날짜에 발생하는 모든 이벤트를 가져옵니다.
`getEventsForDay(date, options)`	`CalendarEvent[]`	지정된 날짜에 발생한 모든 지정된 이벤트를 가져옵니다.
`getId()`	`String`	캘린더의 ID를 가져옵니다.
`getName()`	`String`	캘린더 이름을 가져옵니다.
`getOwnedCalendarById(id)`	`Calendar`	사용자가 ID를 소유한 경우 지정된 ID가 있는 캘린더를 가져옵니다.
`getOwnedCalendarsByName(name)`	`Calendar[]`	사용자가 소유한 지정된 이름의 모든 캘린더를 가져옵니다.
`getTimeZone()`	`String`	캘린더의 시간대를 가져옵니다.
`isHidden()`	`Boolean`	캘린더가 사용자 인터페이스에 숨겨져 있는지 확인합니다.
`isMyPrimaryCalendar()`	`Boolean`	캘린더가 유효 사용자의 기본 캘린더인지를 결정합니다.
`isOwnedByMe()`	`Boolean`	유효 사용자가 캘린더를 소유하고 있는지 확인합니다.
`isSelected()`	`Boolean`	캘린더의 일정을 사용자 인터페이스에 표시할지 결정합니다.
`newRecurrence()`	`EventRecurrence`	이벤트 반복 규칙을 만드는 데 사용할 수 있는 새 반복 객체를 만듭니다.
`setColor(color)`	`Calendar`	캘린더의 색상을 설정합니다.
`setDescription(description)`	`Calendar`	캘린더 설명을 설정합니다.
`setHidden(hidden)`	`Calendar`	캘린더를 사용자 인터페이스에 표시할지 설정합니다.
`setName(name)`	`Calendar`	캘린더 이름을 설정합니다.
`setSelected(selected)`	`Calendar`	캘린더의 일정을 사용자 인터페이스에 표시할지 설정합니다.
`setTimeZone(timeZone)`	`Calendar`	캘린더의 시간대를 설정합니다.
`subscribeToCalendar(id)`	`Calendar`	사용자가 구독하도록 허용된 경우 지정된 ID의 사용자로 사용자를 구독합니다.
`subscribeToCalendar(id, options)`	`Calendar`	사용자가 구독하도록 허용된 경우 지정된 ID의 사용자로 사용자를 구독합니다.

자세한 문서

`createAllDayEvent(title, date)`

새로운 종일 일정을 만듭니다.

// Creates an all-day event for the moon landing and logs the ID.
var event = CalendarApp.getDefaultCalendar().createAllDayEvent('Apollo 11 Landing',
    new Date('July 20, 1969'));
Logger.log('Event ID: ' + event.getId());

매개변수

이름	유형	설명
`title`	`String`	이벤트 제목입니다.
`date`	`Date`	이벤트 날짜입니다 (요일만 사용, 시간은 무시됨).

Return 키

CalendarEvent: 생성된 이벤트입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`createAllDayEvent(title, startDate, endDate)`

여러 날에 걸쳐 새로운 종일 일정을 만듭니다.

// Creates an all-day event for the Woodstock festival (August 15th to 17th) and logs the ID.
var event = CalendarApp.getDefaultCalendar().createAllDayEvent('Woodstock Festival',
    new Date('August 15, 1969'),
    new Date('August 18, 1969'));
Logger.log('Event ID: ' + event.getId());

매개변수

이름	유형	설명
`title`	`String`	이벤트 제목입니다.
`startDate`	`Date`	이벤트가 시작되는 날짜입니다. 날짜만 사용되며 시간은 무시됩니다.
`endDate`	`Date`	이벤트가 종료되는 날짜입니다 (요일만 사용, 시간은 무시됨). 종료일은 배타적입니다.

Return 키

CalendarEvent: 생성된 이벤트입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`createAllDayEvent(title, startDate, endDate, options)`

여러 날에 걸쳐 새로운 종일 일정을 만듭니다.

// Creates an all-day event for the Woodstock festival (August 15th to 17th) and logs the ID.
var event = CalendarApp.getDefaultCalendar().createAllDayEvent('Woodstock Festival',
    new Date('August 15, 1969'),
    new Date('August 18, 1969'),
    {location: 'Bethel, White Lake, New York, U.S.', sendInvites: true});
Logger.log('Event ID: ' + event.getId());

매개변수

이름	유형	설명
`title`	`String`	이벤트 제목입니다.
`startDate`	`Date`	이벤트가 시작되는 날짜입니다. 날짜만 사용되며 시간은 무시됩니다.
`endDate`	`Date`	이벤트가 종료되는 날짜입니다 (요일만 사용, 시간은 무시됨). 종료일은 배타적입니다.
`options`	`Object`	아래와 같이 고급 매개변수를 지정하는 자바스크립트 객체입니다.

고급 매개변수

이름	유형	설명
`description`	`String`	이벤트에 대한 설명입니다.
`location`	`String`	이벤트의 위치입니다.
`guests`	`String`	참석자로 추가되어야 하는 쉼표로 구분된 이메일 주소 목록입니다.
`sendInvites`	`Boolean`	초대 이메일 전송 여부 (기본값: `false`)

Return 키

CalendarEvent: 생성된 이벤트입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`createAllDayEvent(title, date, options)`

새로운 종일 일정을 만듭니다.

// Creates an all-day event for the moon landing and logs the ID.
var event = CalendarApp.getDefaultCalendar().createAllDayEvent('Apollo 11 Landing',
    new Date('July 20, 1969'),
    {location: 'The Moon'});
Logger.log('Event ID: ' + event.getId());

매개변수

이름	유형	설명
`title`	`String`	이벤트 제목입니다.
`date`	`Date`	이벤트 날짜입니다 (요일만 사용, 시간은 무시됨).
`options`	`Object`	아래와 같이 고급 매개변수를 지정하는 자바스크립트 객체입니다.

고급 매개변수

이름	유형	설명
`description`	`String`	이벤트에 대한 설명입니다.
`location`	`String`	이벤트의 위치입니다.
`guests`	`String`	참석자로 추가되어야 하는 쉼표로 구분된 이메일 주소 목록입니다.
`sendInvites`	`Boolean`	초대 이메일 전송 여부 (기본값: `false`)

Return 키

CalendarEvent: 생성된 이벤트입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`createAllDayEventSeries(title, startDate, recurrence)`

새로운 종일 일정 만들기

// Creates an event series for a no-meetings day, taking place every Wednesday in 2013.
var eventSeries = CalendarApp.getDefaultCalendar().createAllDayEventSeries('No Meetings',
    new Date('January 2, 2013 03:00:00 PM EST'),
    CalendarApp.newRecurrence().addWeeklyRule()
        .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY)
        .until(new Date('January 1, 2014')));
Logger.log('Event Series ID: ' + eventSeries.getId());

매개변수

이름	유형	설명
`title`	`String`	반복되는 일정의 제목
`startDate`	`Date`	반복되는 첫 번째 이벤트의 날짜입니다 (요일만 사용, 시간은 무시됨).
`recurrence`	`EventRecurrence`	일정 시리즈의 반복 설정

Return 키

CalendarEventSeries: 생성된 이벤트 시리즈

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`createAllDayEventSeries(title, startDate, recurrence, options)`

새로운 종일 일정 만들기

// Creates an event series for a no-meetings day, taking place every Wednesday in 2013.
var eventSeries = CalendarApp.getDefaultCalendar().createAllDayEventSeries('No Meetings',
    new Date('January 2, 2013 03:00:00 PM EST'),
    CalendarApp.newRecurrence().addWeeklyRule()
        .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY)
        .until(new Date('January 1, 2014')),
    {guests: 'everyone@example.com'});
Logger.log('Event Series ID: ' + eventSeries.getId());

매개변수

이름	유형	설명
`title`	`String`	반복되는 일정의 제목
`startDate`	`Date`	반복되는 첫 번째 이벤트의 날짜입니다 (요일만 사용, 시간은 무시됨).
`recurrence`	`EventRecurrence`	일정 시리즈의 반복 설정
`options`	`Object`	아래와 같이 고급 매개변수를 지정하는 자바스크립트 객체

고급 매개변수

이름	유형	설명
`description`	`String`	반복 일정에 대한 설명
`location`	`String`	반복되는 일정의 위치
`guests`	`String`	반복 일정에 참석자로 추가할 이메일 주소를 쉼표로 구분한 목록입니다.
`sendInvites`	`Boolean`	초대 이메일 전송 여부 (기본값: `false`)

Return 키

CalendarEventSeries: 생성된 이벤트 시리즈

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`createCalendar(name)`

사용자가 소유한 새 캘린더를 만듭니다.

// Creates a new calendar named "Travel Plans".
var calendar = CalendarApp.createCalendar('Travel Plans');
Logger.log('Created the calendar "%s", with the ID "%s".',
    calendar.getName(), calendar.getId());

매개변수

이름	유형	설명
`name`	`String`	새 캘린더의 이름

Return 키

Calendar: 새로 생성된 캘린더

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`createCalendar(name, options)`

사용자가 소유한 새 캘린더를 만듭니다.

// Creates a new calendar named "Travel Plans" with a summary and color.
var calendar = CalendarApp.createCalendar('Travel Plans', {
  summary: 'A calendar to plan my travel schedule.',
  color: CalendarApp.Color.BLUE
});
Logger.log('Created the calendar "%s", with the ID "%s".',
    calendar.getName(), calendar.getId());

매개변수

이름	유형	설명
`name`	`String`	새 캘린더의 이름
`options`	`Object`	아래와 같이 고급 매개변수를 지정하는 자바스크립트 객체

고급 매개변수

이름	유형	설명
`location`	`String`	캘린더 위치
`summary`	`String`	캘린더 설명
`timeZone`	`String`	캘린더를 설정할 시간대로, 'long' 형식으로 지정됩니다 (예: 'America/New_York', Joda.org 제공)
`color`	`String`	16진수 색상 문자열('#rrggbb') 또는 `CalendarApp.Colors`의 값
`hidden`	`Boolean`	캘린더가 사용자 인터페이스에 숨겨져 있는지 여부 (기본값: `false`)
`selected`	`Boolean`	캘린더의 일정이 사용자 인터페이스에 표시되는지 여부 (기본값: `true`)

Return 키

Calendar: 새로 생성된 캘린더

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`createEvent(title, startTime, endTime)`

새 이벤트를 만듭니다.

시간대를 지정하지 않으면 스크립트 시간대의 컨텍스트에서 시간 값이 해석되며, 이는 캘린더의 시간대와 다를 수 있습니다.

// Creates an event for the moon landing and logs the ID.
var event = CalendarApp.getDefaultCalendar().createEvent('Apollo 11 Landing',
    new Date('July 20, 1969 20:00:00 UTC'),
    new Date('July 21, 1969 21:00:00 UTC'));
Logger.log('Event ID: ' + event.getId());

매개변수

이름	유형	설명
`title`	`String`	일정 제목
`startTime`	`Date`	이벤트가 시작되는 날짜 및 시간
`endTime`	`Date`	이벤트가 종료되는 날짜와 시간입니다.

Return 키

CalendarEvent: 생성된 이벤트

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`createEvent(title, startTime, endTime, options)`

새 이벤트를 만듭니다.

시간대를 지정하지 않으면 스크립트 시간대의 컨텍스트에서 시간 값이 해석되며, 이는 캘린더의 시간대와 다를 수 있습니다.

// Creates an event for the moon landing and logs the ID.
var event = CalendarApp.getDefaultCalendar().createEvent('Apollo 11 Landing',
    new Date('July 20, 1969 20:00:00 UTC'),
    new Date('July 20, 1969 21:00:00 UTC'),
    {location: 'The Moon'});
Logger.log('Event ID: ' + event.getId());

매개변수

이름	유형	설명
`title`	`String`	일정 제목
`startTime`	`Date`	이벤트가 시작되는 날짜 및 시간
`endTime`	`Date`	이벤트가 종료되는 날짜와 시간입니다.
`options`	`Object`	아래와 같이 고급 매개변수를 지정하는 자바스크립트 객체

고급 매개변수

이름	유형	설명
`description`	`String`	이벤트에 대한 설명
`location`	`String`	이벤트 위치
`guests`	`String`	참석자로 추가되어야 하는 쉼표로 구분된 이메일 주소 목록
`sendInvites`	`Boolean`	초대 이메일 전송 여부 (기본값: `false`)

Return 키

CalendarEvent: 생성된 이벤트

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`createEventFromDescription(description)`

자유 형식 설명으로 이벤트를 만듭니다.

설명은 UI의 '빠른 추가' 기능과 같은 형식을 사용해야 합니다.

// Creates a new event and logs its ID.
var event = CalendarApp.getDefaultCalendar()
    .createEventFromDescription('Lunch with Mary, Friday at 1PM');
Logger.log('Event ID: ' + event.getId());

매개변수

이름	유형	설명
`description`	`String`	이벤트에 대한 자유 형식 설명

Return 키

CalendarEvent: 생성된 이벤트

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`createEventSeries(title, startTime, endTime, recurrence)`

새 이벤트 시리즈를 만듭니다.

// Creates an event series for a team meeting, taking place every Tuesday and Thursday in 2013.
var eventSeries = CalendarApp.getDefaultCalendar().createEventSeries('Team Meeting',
    new Date('January 1, 2013 03:00:00 PM EST'),
    new Date('January 1, 2013 04:00:00 PM EST'),
    CalendarApp.newRecurrence().addWeeklyRule()
        .onlyOnWeekdays([CalendarApp.Weekday.TUESDAY, CalendarApp.Weekday.THURSDAY])
        .until(new Date('January 1, 2014')));
Logger.log('Event Series ID: ' + eventSeries.getId());

매개변수

이름	유형	설명
`title`	`String`	반복되는 일정의 제목
`startTime`	`Date`	반복 일정 중 첫 번째 일정이 시작되는 날짜와 시간입니다.
`endTime`	`Date`	반복 일정 중 첫 번째 일정이 종료되는 날짜와 시간입니다.
`recurrence`	`EventRecurrence`	일정 시리즈의 반복 설정

Return 키

CalendarEventSeries: 생성된 이벤트 시리즈

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`createEventSeries(title, startTime, endTime, recurrence, options)`

새 이벤트 시리즈를 만듭니다.

// Creates an event series for a team meeting, taking place every Tuesday and Thursday in 2013.
var eventSeries = CalendarApp.getDefaultCalendar().createEventSeries('Team Meeting',
    new Date('January 1, 2013 03:00:00 PM EST'),
    new Date('January 1, 2013 04:00:00 PM EST'),
    CalendarApp.newRecurrence().addWeeklyRule()
        .onlyOnWeekdays([CalendarApp.Weekday.TUESDAY, CalendarApp.Weekday.THURSDAY])
        .until(new Date('January 1, 2014')),
    {location: 'Conference Room'});
Logger.log('Event Series ID: ' + eventSeries.getId());

매개변수

이름	유형	설명
`title`	`String`	반복되는 일정의 제목
`startTime`	`Date`	반복 일정 중 첫 번째 일정이 시작되는 날짜와 시간입니다.
`endTime`	`Date`	반복 일정 중 첫 번째 일정이 종료되는 날짜와 시간입니다.
`recurrence`	`EventRecurrence`	일정 시리즈의 반복 설정
`options`	`Object`	아래와 같이 고급 매개변수를 지정하는 자바스크립트 객체

고급 매개변수

이름	유형	설명
`description`	`String`	반복 일정에 대한 설명
`location`	`String`	반복되는 일정의 위치
`guests`	`String`	반복 일정에 참석자로 추가할 이메일 주소를 쉼표로 구분한 목록입니다.
`sendInvites`	`Boolean`	초대 이메일 전송 여부 (기본값: `false`)

Return 키

CalendarEventSeries: 생성된 이벤트 시리즈

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`getAllCalendars()`

사용자가 소유하거나 구독 중인 모든 캘린더를 가져옵니다.

// Determines how many calendars the user can access.
var calendars = CalendarApp.getAllCalendars();
Logger.log('This user owns or is subscribed to %s calendars.',
    calendars.length);

Return 키

Calendar[]: 사용자가 액세스할 수 있는 모든 캘린더

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getAllOwnedCalendars()`

사용자가 소유한 모든 캘린더를 가져옵니다.

// Determines how many calendars the user owns.
var calendars = CalendarApp.getAllOwnedCalendars();
Logger.log('This user owns %s calendars.', calendars.length);

Return 키

Calendar[]: 사용자가 소유한 모든 캘린더

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getCalendarById(id)`

지정된 ID가 있는 캘린더를 가져옵니다.

// Gets the public calendar "US Holidays" by ID.
var calendar = CalendarApp.getCalendarById(
    'en.usa#holiday@group.v.calendar.google.com');
Logger.log('The calendar is named "%s".', calendar.getName());

매개변수

이름	유형	설명
`id`	`String`	캘린더 ID

Return 키

Calendar: 지정된 ID가 있는 캘린더 또는 캘린더가 없는 경우, 사용자가 캘린더에 액세스할 수 없는 경우, 사용자가 캘린더를 구독하지 않는 경우 null

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getCalendarsByName(name)`

사용자가 소유하거나 구독 중인 특정 이름의 모든 캘린더를 가져옵니다. 이름은 대소문자를 구분하지 않습니다.

// Gets the public calendar named "US Holidays".
var calendars = CalendarApp.getCalendarsByName('US Holidays');
Logger.log('Found %s matching calendars.', calendars.length);

매개변수

이름	유형	설명
`name`	`String`	캘린더 이름

Return 키

Calendar[]: 사용자가 액세스할 수 있는 이 이름의 모든 캘린더

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getColor()`

캘린더의 색상을 가져옵니다.

Return 키

String: 16진수 색상 문자열('#rrggbb')입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getDefaultCalendar()`

사용자의 기본 캘린더를 가져옵니다.

// Determines the time zone of the user's default calendar.
var calendar = CalendarApp.getDefaultCalendar();
Logger.log('My default calendar is set to the time zone "%s".',
    calendar.getTimeZone());

Return 키

Calendar: 사용자의 기본 캘린더

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getDescription()`

캘린더 설명을 가져옵니다.

Return 키

String: 이 캘린더에 대한 설명

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getEventById(iCalId)`

지정된 ID의 이벤트를 가져옵니다. 반복 일정이 기본 캘린더와 다른 캘린더에 속할 경우 이 메서드는 이 캘린더에서 호출해야 합니다. getEventById(iCalId)를 호출하면 기본 캘린더에 있는 일정만 반환됩니다.

이벤트 시리즈의 일부인 경우 여러 이벤트의 ID가 같을 수 있습니다. 이 경우 이 메서드는 해당 시리즈의 첫 번째 이벤트만 반환합니다.

매개변수

이름	유형	설명
`iCalId`	`String`	이벤트 ID

Return 키

CalendarEvent: 지정된 ID가 있는 이벤트 또는 이벤트가 존재하지 않거나 사용자가 이벤트에 액세스할 수 없는 경우 null입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getEventSeriesById(iCalId)`

지정된 ID가 있는 이벤트 시리즈를 가져옵니다. 지정된 ID가 단일 CalendarEvent에 해당하면 CalendarEventSeries가 시리즈에서 단일 이벤트와 함께 반환됩니다. 일정 시리즈가 기본 캘린더가 아닌 다른 캘린더에 속해 있는 경우 이 메서드는 CalendarApp에서 호출해야 합니다. getEventSeriesById(iCalId)를 호출하면 기본 캘린더에 있는 일정 시리즈만 직접 반환됩니다.

매개변수

이름	유형	설명
`iCalId`	`String`	이벤트 시리즈의 ID

Return 키

CalendarEventSeries - 지정된 ID가 있는 시리즈 또는 시리즈가 존재하지 않거나 사용자가 시리즈에 액세스할 수 없는 경우 null

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getEvents(startTime, endTime)`

지정된 시간 범위 내에 발생하는 모든 이벤트를 가져옵니다.

이 메서드는 지정된 기간 동안 시작되거나, 기간 중에 종료되거나, 기간을 포함하는 이벤트를 반환합니다. 시간대를 지정하지 않으면 스크립트 시간대의 컨텍스트에서 시간 값이 해석되며, 이는 캘린더의 시간대와 다를 수 있습니다.

// Determines how many events are happening in the next two hours.
var now = new Date();
var twoHoursFromNow = new Date(now.getTime() + (2 * 60 * 60 * 1000));
var events = CalendarApp.getDefaultCalendar().getEvents(now, twoHoursFromNow);
Logger.log('Number of events: ' + events.length);

매개변수

이름	유형	설명
`startTime`	`Date`	기간의 시작
`endTime`	`Date`	기간 종료(해당 기간 제외)

Return 키

CalendarEvent[]: 기간 내에 발생하는 이벤트입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getEvents(startTime, endTime, options)`

지정된 기간 내에 발생하고 지정된 기준을 충족하는 모든 이벤트를 가져옵니다.

author, search 또는 statusFilters 필터링은 start 및 max 적용 후 실행됩니다. 즉, 추가 이벤트가 기준을 충족하더라도 반환되는 이벤트 수는 max개 미만일 수 있습니다.

// Determines how many events are happening in the next two hours that contain the term
// "meeting".
var now = new Date();
var twoHoursFromNow = new Date(now.getTime() + (2 * 60 * 60 * 1000));
var events = CalendarApp.getDefaultCalendar().getEvents(now, twoHoursFromNow,
    {search: 'meeting'});
Logger.log('Number of events: ' + events.length);

매개변수

이름	유형	설명
`startTime`	`Date`	기간의 시작
`endTime`	`Date`	기간 종료(해당 기간 제외)
`options`	`Object`	아래와 같이 고급 매개변수를 지정하는 자바스크립트 객체

고급 매개변수

이름	유형	설명
`start`	`Integer`	반환할 첫 번째 이벤트의 색인입니다.
`max`	`Integer`	반환할 최대 이벤트 수입니다.
`author`	`String`	이벤트 작성자의 결과를 필터링하는 데 사용되는 이메일 주소
`search`	`String`	결과를 필터링하는 데 사용되는 전체 텍스트 검색어
`statusFilters[]`	`GuestStatus`	결과를 필터링하는 데 사용되는 상태 배열

Return 키

CalendarEvent[]: 기간 내에 발생하여 기준과 일치하는 이벤트입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getEventsForDay(date)`

지정된 날짜에 발생하는 모든 이벤트를 가져옵니다.

이 메서드는 지정된 날에 시작하거나 하루 중에 끝나거나 그날에 종료되는 경우 이벤트를 반환합니다.

날짜 객체의 날짜 부분만 사용되며 시간 부분은 무시됩니다. 날짜는 캘린더 시간대에서 그날 자정부터 다음 날 자정으로 해석됩니다.

// Determines how many events are happening today.
var today = new Date();
var events = CalendarApp.getDefaultCalendar().getEventsForDay(today);
Logger.log('Number of events: ' + events.length);

매개변수

이름	유형	설명
`date`	`Date`	이벤트를 가져올 날짜 (날짜만 사용, 시간은 무시됨)

Return 키

CalendarEvent[]: 지정된 날짜에 발생하는 이벤트입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getEventsForDay(date, options)`

지정된 날짜에 발생한 모든 지정된 이벤트를 가져옵니다.

이 메서드는 지정된 날에 시작하거나 하루 중에 끝나거나 그날에 종료되는 경우 이벤트를 반환합니다.

날짜 객체의 날짜 부분만 사용되며 시간 부분은 무시됩니다. 날짜는 캘린더 시간대에서 그날 자정부터 다음 날 자정으로 해석됩니다.

// Determines how many events are happening today and contain the term "meeting".
var today = new Date();
var events = CalendarApp.getDefaultCalendar().getEventsForDay(today, {search: 'meeting'});
Logger.log('Number of events: ' + events.length);

매개변수

이름	유형	설명
`date`	`Date`	이벤트를 가져올 날짜 (날짜만 사용, 시간은 무시됨)
`options`	`Object`	고급 필터링 옵션

고급 매개변수

이름	유형	설명
`start`	`Integer`	반환할 첫 번째 이벤트의 색인입니다.
`max`	`Integer`	반환할 최대 이벤트 수입니다.
`author`	`String`	이벤트 작성자의 결과를 필터링하는 데 사용되는 이메일 주소
`search`	`String`	결과를 필터링하는 데 사용되는 전체 텍스트 검색어
`statusFilters[]`	`GuestStatus`	결과를 필터링하는 데 사용되는 상태 배열

Return 키

CalendarEvent[]: 지정된 날짜에 발생하고 기준과 일치하는 이벤트

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getId()`

캘린더의 ID를 가져옵니다. 사용자의 기본 캘린더 ID는 사용자의 이메일 주소입니다.

Return 키

String: 캘린더의 ID입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getName()`

캘린더 이름을 가져옵니다.

Return 키

String: 이 캘린더의 이름

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getOwnedCalendarById(id)`

사용자가 ID를 소유한 경우 지정된 ID가 있는 캘린더를 가져옵니다.

캘린더 ID를 찾으려면 Google Calendar에서 캘린더 이름 옆에 있는 화살표를 클릭하고 Calendar 설정을 선택합니다. ID는 설정 페이지 하단 근처에 표시됩니다.

// Gets a (non-existent) private calendar by ID.
var calendar = CalendarApp.getOwnedCalendarById(
    '123456789@group.calendar.google.com');
Logger.log('The calendar is named "%s".', calendar.getName());

매개변수

이름	유형	설명
`id`	`String`	캘린더 ID

Return 키

Calendar: 지정된 ID가 있는 캘린더 또는 캘린더가 존재하지 않거나 사용자가 소유하지 않은 경우 null입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getOwnedCalendarsByName(name)`

사용자가 소유한 지정된 이름의 모든 캘린더를 가져옵니다. 이름은 대소문자를 구분하지 않습니다.

// Gets a private calendar named "Travel Plans".
var calendars = CalendarApp.getOwnedCalendarsByName('Travel Plans');
Logger.log('Found %s matching calendars.', calendars.length);

매개변수

이름	유형	설명
`name`	`String`	캘린더 이름

Return 키

Calendar[]: 사용자가 소유한 이 이름을 가진 모든 캘린더

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`getTimeZone()`

캘린더의 시간대를 가져옵니다.

Return 키

String: 'long' 형식 (예: 'America/New_York', Joda.org 제공)

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`isHidden()`

캘린더가 사용자 인터페이스에 숨겨져 있는지 확인합니다.

Return 키

Boolean — 캘린더가 사용자 인터페이스에 숨겨져 있으면 true, 숨기지 않으면 false입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`isMyPrimaryCalendar()`

캘린더가 유효 사용자의 기본 캘린더인지를 결정합니다.

Return 키

Boolean: 캘린더가 유효 사용자의 기본 캘린더인 경우 true, 아닌 경우 false입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`isOwnedByMe()`

유효 사용자가 캘린더를 소유하고 있는지 확인합니다.

Return 키

Boolean: 유효 사용자가 캘린더를 소유한 경우 true, 아닌 경우 false

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`isSelected()`

캘린더의 일정을 사용자 인터페이스에 표시할지 결정합니다.

Return 키

Boolean — 캘린더 일정이 사용자 인터페이스에 표시되는 경우 true, 표시되지 않는 경우 false

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`newRecurrence()`

이벤트 반복 규칙을 만드는 데 사용할 수 있는 새 반복 객체를 만듭니다.

// Creates an event series for a no-meetings day, taking place every Wednesday in 2013.
var recurrence = CalendarApp.newRecurrence().addWeeklyRule()
    .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY)
    .until(new Date('January 1, 2014'));
var eventSeries = CalendarApp.getDefaultCalendar().createAllDayEventSeries('No Meetings',
    new Date('January 2, 2013 03:00:00 PM EST'),
    recurrence);
Logger.log('Event Series ID: ' + eventSeries.getId());

Return 키

EventRecurrence: 규칙이 설정되지 않은 새 반복 객체 (주간 반복으로 작동)

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.google.com/calendar/feeds

`setColor(color)`

캘린더의 색상을 설정합니다.

매개변수

이름	유형	설명
`color`	`String`	16진수 색상 문자열('#rrggbb') 또는 `CalendarApp.Color`의 값입니다.

Return 키

Calendar: 이 일정을 연결하는 데 사용하는 캘린더입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`setDescription(description)`

캘린더 설명을 설정합니다.

매개변수

이름	유형	설명
`description`	`String`	이 캘린더의 설명

Return 키

Calendar — 이 일정을 연결하는 데 사용하는 캘린더입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`setHidden(hidden)`

캘린더를 사용자 인터페이스에 표시할지 설정합니다.

매개변수

이름	유형	설명
`hidden`	`Boolean`	`true`: 사용자 인터페이스에서 캘린더 숨기기, `false` 표시: 캘린더

Return 키

Calendar — 이 일정을 연결하는 데 사용하는 캘린더입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`setName(name)`

캘린더 이름을 설정합니다.

매개변수

이름	유형	설명
`name`	`String`	새 이름

Return 키

Calendar — 이 일정을 연결하는 데 사용하는 캘린더입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`setSelected(selected)`

캘린더의 일정을 사용자 인터페이스에 표시할지 설정합니다.

매개변수

이름	유형	설명
`selected`	`Boolean`	`true`: 사용자 인터페이스에 캘린더의 일정을 표시하고 `false`: 숨기기

Return 키

Calendar — 이 일정을 연결하는 데 사용하는 캘린더입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`setTimeZone(timeZone)`

캘린더의 시간대를 설정합니다.

매개변수

이름	유형	설명
`timeZone`	`String`	'long' 형식으로 지정된 시간대 (예: 'America/New_York', Joda.org 제공)

Return 키

Calendar — 이 일정을 연결하는 데 사용하는 캘린더입니다.

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`subscribeToCalendar(id)`

사용자가 구독하도록 허용된 경우 지정된 ID의 사용자로 사용자를 구독합니다.

// Subscribe to the calendar "US Holidays".
var calendar = CalendarApp.subscribeToCalendar(
    'en.usa#holiday@group.v.calendar.google.com');
Logger.log('Subscribed to the calendar "%s".', calendar.getName());

매개변수

이름	유형	설명
`id`	`String`	구독할 캘린더의 ID입니다.

Return 키

Calendar: 새로 구독한 캘린더

생성 값

Error: 이 ID를 사용하는 캘린더가 없는 경우

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds

`subscribeToCalendar(id, options)`

사용자가 구독하도록 허용된 경우 지정된 ID의 사용자로 사용자를 구독합니다.

// Subscribe to the calendar "US Holidays", and set it to the color blue.
var calendar = CalendarApp.subscribeToCalendar(
    'en.usa#holiday@group.v.calendar.google.com',
    { color: CalendarApp.Color.BLUE });
Logger.log('Subscribed to the calendar "%s".', calendar.getName());

매개변수

이름	유형	설명
`id`	`String`	구독할 캘린더의 ID입니다.
`options`	`Object`	아래와 같이 고급 매개변수를 지정하는 자바스크립트 객체

고급 매개변수

이름	유형	설명
`color`	`String`	16진수 색상 문자열('#rrggbb') 또는 `CalendarApp.Colors`의 값
`hidden`	`Boolean`	캘린더가 사용자 인터페이스에 숨겨져 있는지 여부 (기본값: `false`)
`selected`	`Boolean`	캘린더의 일정이 사용자 인터페이스에 표시되는지 여부 (기본값: `true`)

Return 키

Calendar: 새로 구독한 캘린더

생성 값

Error: 이 ID를 사용하는 캘린더가 없는 경우

확인할 내용

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위를 사용하여 승인이 필요합니다.

https://www.googleapis.com/auth/calendar
https://www.google.com/calendar/feeds