Class CalendarEvent

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
CalendarEvent

단일 캘린더 일정을 나타냅니다.

메서드

메서드반환 유형간략한 설명
addEmailReminder(minutesBefore)CalendarEvent일정에 새 이메일 알림을 추가합니다.
addGuest(email)CalendarEvent일정에 참석자를 추가합니다.
addPopupReminder(minutesBefore)CalendarEvent일정에 새로운 팝업 알림을 추가합니다.
addSmsReminder(minutesBefore)CalendarEvent일정에 새 SMS 알림을 추가합니다.
anyoneCanAddSelf()Boolean모든 사용자가 자신을 초대할 수 있는지 결정합니다.
deleteEvent()void일정을 삭제합니다.
deleteTag(key)CalendarEvent이벤트에서 키-값 태그를 삭제합니다.
getAllDayEndDate()Date이 종일 캘린더 일정이 종료되는 날짜를 가져옵니다.
getAllDayStartDate()Date이 종일 캘린더 일정이 시작하는 날짜를 가져옵니다.
getAllTagKeys()String[]이벤트에 설정된 태그의 모든 키를 가져옵니다.
getColor()String캘린더 일정의 색상을 반환합니다.
getCreators()String[]이벤트 제작자를 가져옵니다.
getDateCreated()Date이벤트가 만들어진 날짜를 가져옵니다.
getDescription()String이벤트 설명을 가져옵니다.
getEmailReminders()Integer[]일정에 대한 모든 이메일 알림의 분 값을 가져옵니다.
getEndTime()Date이 캘린더 이벤트가 종료되는 날짜와 시간을 가져옵니다.
getEventSeries()CalendarEventSeries이 이벤트가 속한 반복 일정을 가져옵니다.
getGuestByEmail(email)EventGuest이메일 주소로 참석자를 가져옵니다.
getGuestList()EventGuest[]일정 소유자를 제외한 일정의 참석자를 가져옵니다.
getGuestList(includeOwner)EventGuest[]일정 소유자를 비롯하여 일정의 참석자를 가져옵니다.
getId()String이벤트의 고유 iCalUID를 가져옵니다.
getLastUpdated()Date이벤트가 마지막으로 업데이트된 날짜를 가져옵니다.
getLocation()String이벤트의 위치를 가져옵니다.
getMyStatus()GuestStatus유효 사용자의 이벤트 상태 (참석 등)를 가져옵니다.
getOriginalCalendarId()String일정이 처음 만들어진 캘린더의 ID를 확인합니다.
getPopupReminders()Integer[]이벤트의 모든 팝업 리마인더의 분 값을 가져옵니다.
getSmsReminders()Integer[]이벤트에 대한 모든 SMS 알림의 분 값을 가져옵니다.
getStartTime()Date이 캘린더 일정이 시작되는 날짜와 시간을 가져옵니다.
getTag(key)String이벤트의 태그 값을 가져옵니다.
getTitle()String이벤트 제목을 가져옵니다.
getVisibility()Visibility이벤트의 공개 상태를 가져옵니다.
guestsCanInviteOthers()Boolean참석자가 다른 참석자를 초대할 수 있는지 결정합니다.
guestsCanModify()Boolean참석자가 일정을 수정할 수 있는지 결정합니다.
guestsCanSeeGuests()Boolean참석자가 다른 참석자를 볼 수 있는지 결정합니다.
isAllDayEvent()Boolean종일 일정인지 결정합니다.
isOwnedByMe()Boolean이벤트가 유효한 사용자 소유인지 확인합니다.
isRecurringEvent()Boolean이벤트가 이벤트 시리즈의 일부인지 결정합니다.
removeAllReminders()CalendarEvent일정에서 모든 알림을 삭제합니다.
removeGuest(email)CalendarEvent일정에서 참석자를 삭제합니다.
resetRemindersToDefault()CalendarEvent캘린더의 기본 설정을 사용하여 리마인더를 재설정합니다.
setAllDayDate(date)CalendarEvent이벤트 날짜를 설정합니다.
setAllDayDates(startDate, endDate)CalendarEvent이벤트 날짜를 설정합니다.
setAnyoneCanAddSelf(anyoneCanAddSelf)CalendarEvent비참석자가 일정에 자신을 추가할 수 있는지 여부를 설정합니다.
setColor(color)CalendarEvent캘린더 일정의 색상을 설정합니다.
setDescription(description)CalendarEvent이벤트 설명을 설정합니다.
setGuestsCanInviteOthers(guestsCanInviteOthers)CalendarEvent참석자가 다른 참석자를 초대할 수 있는지 여부를 설정합니다.
setGuestsCanModify(guestsCanModify)CalendarEvent참석자가 일정을 수정할 수 있는지를 설정합니다.
setGuestsCanSeeGuests(guestsCanSeeGuests)CalendarEvent참석자가 다른 참석자를 볼 수 있는지 여부를 설정합니다.
setLocation(location)CalendarEvent이벤트의 위치를 설정합니다.
setMyStatus(status)CalendarEvent유효 사용자의 이벤트 상태 (참석 등)를 설정합니다.
setTag(key, value)CalendarEvent맞춤 메타데이터를 저장하기 위해 이벤트에 키/값 태그를 설정합니다.
setTime(startTime, endTime)CalendarEvent이벤트의 시작 및 종료 날짜와 시간을 설정합니다.
setTitle(title)CalendarEvent일정 제목을 설정합니다.
setVisibility(visibility)CalendarEvent이벤트의 공개 상태를 설정합니다.

자세한 문서

addEmailReminder(minutesBefore)

일정에 새 이메일 알림을 추가합니다. 알림은 이벤트가 시작되기 최소 5분 전부터 최대 4주 (40320분)까지 진행되어야 합니다.

매개변수

이름유형설명
minutesBeforeInteger이벤트 시간(분) 전

Return

CalendarEvent: 체이닝용 CalendarEvent

예외 처리

Error: 이벤트에서 알림이 6회 이상이거나 시간이 법적 범위 내에 있지 않은 경우

승인

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

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

addGuest(email)

일정에 참석자를 추가합니다.

// Example 1: Add a guest to one event
function addAttendeeToEvent() {
  // Replace the below values with your own
  let attendeeEmail = 'user@example.com'; // Email address of the person you need to add
  let calendarId = 'calendar_123@group.calendar.google.com'; // ID of calendar containing event
  let eventId = '123abc'; // ID of event instance

  let calendar = CalendarApp.getCalendarById(calendarId);
  if (calendar === null) {
    // Calendar not found
    console.log('Calendar not found', calendarId);
    return;
    }
  let event = calendar.getEventById(eventId);
  if (event === null) {
    // Event not found
    console.log('Event not found', eventId);
    return;
    }
  event.addGuest(attendeeEmail);
  }

// Example 2: Add a guest to all events on a calendar within a specified timeframe
function addAttendeeToAllEvents(){
// Replace the following values with your own
  let attendeeEmail = 'user@example.com'; // Email address of the person you need to add
  let calendarId = 'calendar_123@group.calendar.google.com'; // ID of calendar with the events
  let startDate = new Date("YYYY-MM-DD"); // The first date to add the guest to the events
  let endDate = new Date("YYYY-MM-DD"); // The last date to add the guest to the events

  let calendar = CalendarApp.getCalendarById(calendarId);
    if (calendar === null) {
    // Calendar not found
    console.log('Calendar not found', calendarId);
    return;
  }
  // Get the events within the specified timeframe
  let calEvents = calendar.getEvents(startDate,endDate);
  console.log(calEvents.length); // Checks how many events are found
  // Loop through all events and add the attendee to each of them
  for (var i = 0; i < calEvents.length; i++) {
  let event = calEvents[i];
  event.addGuest(attendeeEmail);
  }
}

매개변수

이름유형설명
emailString참석자의 이메일 주소입니다.

Return

CalendarEvent: 체이닝용 CalendarEvent입니다.

승인

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

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

addPopupReminder(minutesBefore)

일정에 새로운 팝업 알림을 추가합니다. 알림은 이벤트가 시작되기 최소 5분 전부터 최대 4주 (40320분)까지 진행되어야 합니다.

매개변수

이름유형설명
minutesBeforeInteger이벤트 시간(분) 전

Return

CalendarEvent: 체이닝용 CalendarEvent

승인

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

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

addSmsReminder(minutesBefore)

일정에 새 SMS 알림을 추가합니다. 알림은 이벤트가 시작되기 최소 5분 전부터 최대 4주 (40320분)까지 진행되어야 합니다.

매개변수

이름유형설명
minutesBeforeInteger이벤트 시간(분) 전

Return

CalendarEvent: 체이닝용 CalendarEvent

예외 처리

Error: 이벤트에서 알림이 6회 이상이거나 시간이 법적 범위 내에 있지 않은 경우

승인

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

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

anyoneCanAddSelf()

모든 사용자가 자신을 초대할 수 있는지 결정합니다.

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

deleteEvent()

일정을 삭제합니다.

승인

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

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

deleteTag(key)

이벤트에서 키-값 태그를 삭제합니다.

매개변수

이름유형설명
keyString태그 키

Return

CalendarEvent: 체이닝용 CalendarEvent

승인

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

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

getAllDayEndDate()

이 종일 캘린더 일정이 종료되는 날짜를 가져옵니다. (종일 이벤트가 아닌 경우 이 메서드가 예외를 발생시킵니다.) 반환된 Date는 이벤트가 스크립트의 시간대에서 끝난 후 자정부터 시작됩니다. 대신 캘린더의 시간대를 사용하려면 getEndTime()를 호출하세요.

Return

Date: 이 종일 캘린더 일정 종료일

예외 처리

Error: 이 일정이 종일 일정이 아닌 경우

승인

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

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

getAllDayStartDate()

이 종일 캘린더 일정이 시작하는 날짜를 가져옵니다. (종일 이벤트가 아닌 경우 이 메서드가 예외를 발생시킵니다.) 반환된 Date는 이벤트가 시작되는 스크립트의 시간대의 자정을 나타냅니다. 대신 캘린더의 시간대를 사용하려면 getStartTime()를 호출하세요.

Return

Date: 종일 캘린더 일정 시작일

예외 처리

Error: 이 일정이 종일 일정이 아닌 경우

승인

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

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

getAllTagKeys()

이벤트에 설정된 태그의 모든 키를 가져옵니다.

Return

String[] — 문자열 키 배열입니다.

승인

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

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

getColor()

캘린더 일정의 색상을 반환합니다.

Return

String: CalendarApp.EventColor의 값 색인 (1~11)으로 표시되는 이벤트 색상의 문자열 표현입니다.

승인

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

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

getCreators()

이벤트 제작자를 가져옵니다.

Return

String[]: 이벤트 작성자의 이메일 주소입니다.

승인

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

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

getDateCreated()

이벤트가 만들어진 날짜를 가져옵니다.

Return

Date — 만든 날짜

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 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

getEmailReminders()

일정에 대한 모든 이메일 알림의 분 값을 가져옵니다.

Return

Integer[]: 각 값이 알림이 트리거된 이벤트가 발생하기 전의 시간(분)에 해당하는 배열입니다.

승인

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

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

getEndTime()

이 캘린더 이벤트가 종료되는 날짜와 시간을 가져옵니다. 종일이 아닌 이벤트의 경우 이벤트가 종료되도록 정의된 즉각적인 시간입니다. 종료일 (날짜 및 시간이 아님)만 저장하는 종일 일정의 경우 이는 일정이 캘린더 시간대에서 끝난 후 자정부터 시작됩니다. 이렇게 하면 모든 이벤트 유형의 종료 시간을 의미 있게 비교할 수 있습니다. 하지만 반드시 수정되지 않은 기존 연도가 포함되는 것은 아닙니다.

종일 이벤트의 경우 이 메서드보다 거의 항상 getAllDayEndDate()를 호출해야 합니다.

Return

Date: 이 캘린더 일정의 종료 시간

승인

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

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

getEventSeries()

이 이벤트가 속한 반복 일정을 가져옵니다. 이 이벤트는 시리즈에 속하지 않더라도 CalendarEventSeries 객체가 반환되므로 새로운 반복 설정을 추가할 수 있습니다.

Return

CalendarEventSeries: 이 이벤트가 속한 이벤트 시리즈 또는 아직 시리즈에 속하지 않은 새 이벤트 시리즈입니다.

승인

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

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

getGuestByEmail(email)

이메일 주소로 참석자를 가져옵니다.

매개변수

이름유형설명
emailString게스트의 주소

Return

EventGuest: 참석자 또는 이메일 주소가 참석자와 일치하지 않는 경우 null

승인

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

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

getGuestList()

일정 소유자를 제외한 일정의 참석자를 가져옵니다.

Return

EventGuest[] — 참석자의 배열

승인

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

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

getGuestList(includeOwner)

일정 소유자를 비롯하여 일정의 참석자를 가져옵니다.

매개변수

이름유형설명
includeOwnerBoolean소유자를 게스트로 포함할지 여부

Return

EventGuest[] — 참석자의 배열

승인

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

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

getId()

이벤트의 고유 iCalUID를 가져옵니다. Calendar v3 APICalendar 고급 서비스에서 사용하는 iCalUID 및 이벤트 id는 동일하지 않으므로 서로 바꿔서 사용할 수 없습니다. 의미 체계의 한 가지 차이점은 반복 이벤트에서 한 이벤트의 모든 어커런스는 서로 다르지만 ids는 모두 동일한 iCalUID를 공유한다는 점입니다.

Return

String: 이벤트의 iCalUID

승인

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

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

getLastUpdated()

이벤트가 마지막으로 업데이트된 날짜를 가져옵니다.

Return

Date: 최종 업데이트 날짜

승인

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

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

getLocation()

이벤트의 위치를 가져옵니다.

Return

String: 이벤트 위치

승인

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

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

getMyStatus()

유효 사용자의 이벤트 상태 (참석 등)를 가져옵니다. 실제 사용자가 이벤트 소유자인 경우 항상 GuestStatus.OWNER를 반환합니다.

Return

GuestStatus — 상태

승인

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

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

getOriginalCalendarId()

일정이 처음 만들어진 캘린더의 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

getPopupReminders()

이벤트의 모든 팝업 리마인더의 분 값을 가져옵니다.

Return

Integer[]: 각 값이 알림이 트리거된 이벤트가 발생하기 전의 시간(분)에 해당하는 배열입니다.

승인

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

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

getSmsReminders()

이벤트에 대한 모든 SMS 알림의 분 값을 가져옵니다.

Return

Integer[]: 각 값이 알림이 트리거된 이벤트가 발생하기 전의 시간(분)에 해당하는 배열입니다.

승인

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

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

getStartTime()

이 캘린더 일정이 시작되는 날짜와 시간을 가져옵니다. 종일이 아닌 이벤트의 경우 이벤트가 시작되도록 정의된 즉각적인 시간입니다. 시작일과 날짜 및 시간이 아닌 하루 종일 이벤트의 경우 캘린더의 시간대에서 이벤트가 시작되는 날의 자정에 시작됩니다. 이렇게 하면 모든 이벤트 유형의 시작 시간을 의미 있게 비교할 수 있습니다. 하지만 반드시 수정되지 않은 기존 연도가 포함되는 것은 아닙니다.

종일 이벤트의 경우 이 메서드보다 거의 항상 getAllDayStartDate()를 호출해야 합니다.

Return

Date: 이 캘린더 일정의 시작 시간입니다.

승인

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

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

getTag(key)

이벤트의 태그 값을 가져옵니다.

매개변수

이름유형설명
keyString

Return

String: 태그 값

승인

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

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

getTitle()

이벤트 제목을 가져옵니다.

Return

String — 제목

승인

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

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

getVisibility()

이벤트의 공개 상태를 가져옵니다.

Return

Visibility: 공개 상태 값

승인

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

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

guestsCanInviteOthers()

참석자가 다른 참석자를 초대할 수 있는지 결정합니다.

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

guestsCanModify()

참석자가 일정을 수정할 수 있는지 결정합니다.

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

guestsCanSeeGuests()

참석자가 다른 참석자를 볼 수 있는지 결정합니다.

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

isAllDayEvent()

종일 일정인지 결정합니다.

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

isRecurringEvent()

이벤트가 이벤트 시리즈의 일부인지 결정합니다.

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

removeAllReminders()

일정에서 모든 알림을 삭제합니다.

Return

CalendarEvent: 체이닝용 CalendarEvent

승인

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

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

removeGuest(email)

일정에서 참석자를 삭제합니다.

// Example 1: Remove a guest from one event
function removeGuestFromEvent() {
  // Replace the below values with your own
  let attendeeEmail = 'user@example.com'; // Email address of the person you need to remove
  let calendarId = 'calendar_123@group.calendar.google.com'; // ID of calendar containing event
  let eventId = '123abc'; // ID of event instance

  let calendar = CalendarApp.getCalendarById(calendarId);
  if (calendar === null) {
    // Calendar not found
    console.log('Calendar not found', calendarId);
    return;
    }
  let event = calendar.getEventById(eventId);
  if (event === null) {
    // Event not found
    console.log('Event not found', eventId);
    return;
    }
  event.removeGuest(attendeeEmail);
  }

// Example 2: Remove a guest from all events on a calendar within a specified timeframe
function removeGuestFromAllEvents(){
// Replace the following values with your own
  let attendeeEmail = 'user@example.com'; // Email address of the person you need to remove
  let calendarId = 'calendar_123@group.calendar.google.com'; // ID of calendar with the events
  let startDate = new Date("YYYY-MM-DD"); // The first date to remove the guest from the events
  let endDate = new Date("YYYY-MM-DD"); // The last date to remove the attendee from the events

  let calendar = CalendarApp.getCalendarById(calendarId);
    if (calendar === null) {
    // Calendar not found
    console.log('Calendar not found', calendarId);
    return;
  }
  // Get the events within the specified timeframe
  let calEvents = calendar.getEvents(startDate,endDate);
  console.log(calEvents.length); // Checks how many events are found
  // Loop through all events and remove the attendee from each of them
  for (var i = 0; i < calEvents.length; i++) {
  let event = calEvents[i];
  event.removeGuest(attendeeEmail);
  }
}

매개변수

이름유형설명
emailString참석자의 이메일 주소

Return

CalendarEvent: 체이닝용 CalendarEvent

승인

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

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

resetRemindersToDefault()

캘린더의 기본 설정을 사용하여 리마인더를 재설정합니다.

Return

CalendarEvent: 체이닝용 CalendarEvent

승인

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

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

setAllDayDate(date)

이벤트 날짜를 설정합니다. 이 메서드를 적용하면 일반 이벤트가 종일 일정으로 변경됩니다.

매개변수

이름유형설명
dateDate이벤트 날짜 (시간은 무시됨)

Return

CalendarEvent — 체이닝을 위한 이 CalendarEvent

승인

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

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

setAllDayDates(startDate, endDate)

이벤트 날짜를 설정합니다. 이 메서드를 적용하면 일반 이벤트가 종일 일정으로 변경됩니다.

매개변수

이름유형설명
startDateDate이벤트가 시작되는 날짜입니다 (시간은 무시됨).
endDateDate이벤트가 종료되는 날짜 (시간은 무시됨)

Return

CalendarEvent — 체이닝을 위한 이 CalendarEvent

승인

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

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

setAnyoneCanAddSelf(anyoneCanAddSelf)

비참석자가 일정에 자신을 추가할 수 있는지 여부를 설정합니다.

매개변수

이름유형설명
anyoneCanAddSelfBoolean모든 사용자가 자신을 초대할 수 있는지 여부

Return

CalendarEvent: 체이닝용 CalendarEvent

승인

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

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

setColor(color)

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

매개변수

이름유형설명
colorString문자열 형태의 정수 색상 색인 또는 CalendarApp.EventColor의 값입니다.

Return

CalendarEvent: 체인을 위한 이 캘린더 일정입니다.

승인

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

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

setDescription(description)

이벤트 설명을 설정합니다.

매개변수

이름유형설명
descriptionString새 설명

Return

CalendarEvent: 체이닝용 CalendarEvent

승인

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

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

setGuestsCanInviteOthers(guestsCanInviteOthers)

참석자가 다른 참석자를 초대할 수 있는지 여부를 설정합니다.

매개변수

이름유형설명
guestsCanInviteOthersBoolean참석자의 다른 사용자 초대 가능 여부

Return

CalendarEvent: 체이닝용 CalendarEvent

승인

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

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

setGuestsCanModify(guestsCanModify)

참석자가 일정을 수정할 수 있는지를 설정합니다.

매개변수

이름유형설명
guestsCanModifyBoolean참석자가 일정을 수정할 수 있는지 여부

Return

CalendarEvent: 체이닝용 CalendarEvent

승인

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

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

setGuestsCanSeeGuests(guestsCanSeeGuests)

참석자가 다른 참석자를 볼 수 있는지 여부를 설정합니다.

매개변수

이름유형설명
guestsCanSeeGuestsBoolean참석자의 공개 상태

Return

CalendarEvent: 체이닝용 CalendarEvent

승인

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

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

setLocation(location)

이벤트의 위치를 설정합니다.

매개변수

이름유형설명
locationString새 위치

Return

CalendarEvent: 체이닝용 CalendarEvent

승인

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

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

setMyStatus(status)

유효 사용자의 이벤트 상태 (참석 등)를 설정합니다.

매개변수

이름유형설명
statusGuestStatus새 상태

Return

CalendarEvent: 체이닝용 CalendarEvent

승인

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

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

setTag(key, value)

맞춤 메타데이터를 저장하기 위해 이벤트에 키/값 태그를 설정합니다.

매개변수

이름유형설명
keyString태그 키
valueString태그 값

Return

CalendarEvent: 체이닝용 CalendarEvent

승인

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

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

setTime(startTime, endTime)

이벤트의 시작 및 종료 날짜와 시간을 설정합니다. 이 메서드를 적용하면 종일 이벤트가 일반 이벤트로 변경됩니다.

매개변수

이름유형설명
startTimeDate일정의 새 시작
endTimeDate이벤트의 새 종료

Return

CalendarEvent — 체이닝을 위한 이 CalendarEvent

승인

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

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

setTitle(title)

일정 제목을 설정합니다.

매개변수

이름유형설명
titleString새 제목

Return

CalendarEvent: 체이닝용 CalendarEvent

승인

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

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

setVisibility(visibility)

이벤트의 공개 상태를 설정합니다.

매개변수

이름유형설명
visibilityVisibility

Return

CalendarEvent: 체이닝용 CalendarEvent

승인

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

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