Class 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 Получите идентификатор календаря, в котором изначально было создано это событие.
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 недели (40 320 минут) до мероприятия.

Параметры

Имя Тип Описание
minutesBefore Integer количество минут до события

Возвращаться

CalendarEvent — это событие CalendarEvent для цепочки

Броски

Error — если по событию больше 5 напоминаний или время вне допустимого диапазона

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего 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);
  }
}

Параметры

Имя Тип Описание
email String Электронный адрес гостя.

Возвращаться

CalendarEvent — это событие CalendarEvent для цепочки.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

addPopupReminder(minutesBefore)

Добавляет новое всплывающее напоминание к событию. Напоминание должно быть не менее чем за 5 минут и не более чем за 4 недели (40 320 минут) до мероприятия.

Параметры

Имя Тип Описание
minutesBefore Integer количество минут до события

Возвращаться

CalendarEvent — это событие CalendarEvent для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

addSmsReminder(minutesBefore)

Добавляет к событию новое SMS-напоминание. Напоминание должно быть не менее чем за 5 минут и не более чем за 4 недели (40 320 минут) до мероприятия.

Параметры

Имя Тип Описание
minutesBefore Integer количество минут до события

Возвращаться

CalendarEvent — это событие CalendarEvent для цепочки

Броски

Error — если по событию больше 5 напоминаний или время вне допустимого диапазона

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

anyoneCanAddSelf()

Определяет, может ли кто-нибудь пригласить себя.

Возвращаться

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)

Удаляет тег ключ/значение из события.

Параметры

Имя Тип Описание
key String ключ тега

Возвращаться

CalendarEvent — это событие CalendarEvent для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getAllDayEndDate()

Получает дату окончания этого события календаря на весь день. (Если это событие не длится весь день, этот метод выдает исключение.) Возвращаемая Date представляет собой полночь в начале дня после окончания события в часовом поясе сценария . Чтобы вместо этого использовать часовой пояс календаря, вызовите getEndTime() .

Возвращаться

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() .

Возвращаться

Date — дата начала этого события календаря на весь день.

Броски

Error — если это событие не на весь день

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getAllTagKeys()

Получает все ключи для тегов, которые были установлены для события.

Возвращаться

String[] — массив строковых ключей

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getColor()

Возвращает цвет события календаря.

Возвращаться

String — Строковое представление цвета события в виде индекса (1–11) значений из CalendarApp.EventColor .

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getCreators()

Получает создатели события.

Возвращаться

String[] — адреса электронной почты создателей события.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getDateCreated()

Получает дату создания события.

Возвращаться

Date — дата создания

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getDescription()

Получает описание события.

Возвращаться

String — описание

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getEmailReminders()

Получает значения минут для всех напоминаний по электронной почте для события.

Возвращаться

Integer[] — массив, в котором каждое значение соответствует количеству минут до события, которое вызывает напоминание.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getEndTime()

Получает дату и время окончания этого события календаря. Для событий, не длящихся весь день, это момент времени, в который было определено окончание события. Для мероприятий на весь день, в которых хранится только дата окончания (а не дата и время), это полночь начала дня после окончания мероприятия в часовом поясе календаря . Это позволяет значимо сравнивать время окончания для всех типов событий; однако это не обязательно сохраняет исходный день года без изменений.

Для событий на весь день почти всегда следует вызывать getAllDayEndDate() вместо этого метода.

Возвращаться

Date — время окончания этого события календаря.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getEventSeries()

Получает серию повторяющихся событий, к которым принадлежит это событие. Объект CalendarEventSeries возвращается, даже если это событие не принадлежит серии, поэтому вы можете добавить новые настройки повторения.

Возвращаться

CalendarEventSeries — серия событий, к которой принадлежит это событие, или новая серия событий, если она еще не принадлежит к серии.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getGuestByEmail(email)

Получает гостя по адресу электронной почты.

Параметры

Имя Тип Описание
email String адрес гостя

Возвращаться

EventGuest — гость или null, если адрес электронной почты не соответствует гостю.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getGuestList()

Получает гостей для события, не включая владельца события.

Возвращаться

EventGuest[] — массив гостей

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getGuestList(includeOwner)

Получает гостей для мероприятия, потенциально включая владельцев мероприятия.

Параметры

Имя Тип Описание
includeOwner Boolean включать ли владельцев в качестве гостей

Возвращаться

EventGuest[] — массив гостей

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getId()

Получает уникальный iCalUID события. Обратите внимание, что iCalUID и id события, используемые API Календаря v3 и расширенной службой Календаря , не идентичны и не могут использоваться взаимозаменяемо. Одно различие в их семантике заключается в том, что в повторяющихся событиях все вхождения одного события имеют разные ids , хотя все они имеют одни и те же идентификаторы iCalUID.

Возвращаться

String — iCalUID события.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getLastUpdated()

Получает дату последнего обновления события.

Возвращаться

Date — дата последнего обновления

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getLocation()

Получает местоположение события.

Возвращаться

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 , если действующий пользователь является владельцем события.

Возвращаться

GuestStatus — статус

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getOriginalCalendarId()

Получите идентификатор календаря, в котором изначально было создано это событие.

Возвращаться

String — идентификатор оригинального календаря.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getPopupReminders()

Получает значения минут для всех всплывающих напоминаний о событии.

Возвращаться

Integer[] — массив, в котором каждое значение соответствует количеству минут до события, которое вызывает напоминание.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getSmsReminders()

Получает значения минут для всех SMS-напоминаний о событии.

Возвращаться

Integer[] — массив, в котором каждое значение соответствует количеству минут до события, которое вызывает напоминание.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getStartTime()

Получает дату и время начала этого события календаря. Для событий, не продолжающихся весь день, это момент времени, в который было определено начало события. Для мероприятий на весь день, в которых хранится только дата начала (а не дата и время), это полночь начала дня начала мероприятия в часовом поясе календаря . Это позволяет значимо сравнивать время начала для всех типов событий; однако не обязательно сохранять исходный день года без изменений.

Для событий на весь день почти всегда следует вызывать getAllDayStartDate() вместо этого метода.

Возвращаться

Date — время начала этого события календаря.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getTag(key)

Получает значение тега события.

Параметры

Имя Тип Описание
key String ключ

Возвращаться

String — значение тега

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getTitle()

Получает заголовок события.

Возвращаться

String — заголовок

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

getVisibility()

Получает видимость события.

Возвращаться

Visibility — значение видимости

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

guestsCanInviteOthers()

Определяет, могут ли гости приглашать других гостей.

Возвращаться

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()

Определяет, могут ли гости изменять мероприятие.

Возвращаться

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()

Определяет, могут ли гости видеть других гостей.

Возвращаться

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()

Определяет, является ли это событием на весь день.

Возвращаться

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()

Определяет, принадлежит ли событие действующему пользователю.

Возвращаться

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()

Определяет, является ли событие частью серии событий.

Возвращаться

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()

Удаляет все напоминания о событии.

Возвращаться

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);
  }
}

Параметры

Имя Тип Описание
email String адрес электронной почты гостя

Возвращаться

CalendarEvent — этот CalendarEvent для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

resetRemindersToDefault()

Сбрасывает напоминания, используя настройки календаря по умолчанию.

Возвращаться

CalendarEvent — это событие CalendarEvent для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

setAllDayDate(date)

Устанавливает дату события. Применение этого метода превращает обычное событие в событие, которое длится весь день.

Параметры

Имя Тип Описание
date Date дата события (время игнорируется)

Возвращаться

CalendarEvent — это событие CalendarEvent для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

setAllDayDates(startDate, endDate)

Устанавливает даты события. Применение этого метода превращает обычное событие в событие, которое длится весь день.

Параметры

Имя Тип Описание
startDate Date дата начала события (время игнорируется)
endDate Date дата окончания события (время игнорируется)

Возвращаться

CalendarEvent — этот CalendarEvent для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

setAnyoneCanAddSelf(anyoneCanAddSelf)

Устанавливает, могут ли не гости добавлять себя к событию.

Параметры

Имя Тип Описание
anyoneCanAddSelf Boolean может ли кто-нибудь пригласить себя

Возвращаться

CalendarEvent — это событие CalendarEvent для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

setColor(color)

Устанавливает цвет события календаря.

Параметры

Имя Тип Описание
color String Целочисленный индекс цвета в виде строки или значение из CalendarApp.EventColor .

Возвращаться

CalendarEvent — это событие календаря для цепочки.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

setDescription(description)

Устанавливает описание события.

Параметры

Имя Тип Описание
description String новое описание

Возвращаться

CalendarEvent — этот CalendarEvent для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

setGuestsCanInviteOthers(guestsCanInviteOthers)

Устанавливает, могут ли гости приглашать других гостей.

Параметры

Имя Тип Описание
guestsCanInviteOthers Boolean могут ли гости приглашать других

Возвращаться

CalendarEvent — этот CalendarEvent для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

setGuestsCanModify(guestsCanModify)

Устанавливает, могут ли гости изменять событие.

Параметры

Имя Тип Описание
guestsCanModify Boolean могут ли гости изменить событие

Возвращаться

CalendarEvent — этот CalendarEvent для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

setGuestsCanSeeGuests(guestsCanSeeGuests)

Устанавливает, могут ли гости видеть других гостей.

Параметры

Имя Тип Описание
guestsCanSeeGuests Boolean могут ли гости видеть других

Возвращаться

CalendarEvent — этот CalendarEvent для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

setLocation(location)

Устанавливает место события.

Параметры

Имя Тип Описание
location String новое место

Возвращаться

CalendarEvent — этот CalendarEvent для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

setMyStatus(status)

Устанавливает статус события (посещение и т. д.) действующего пользователя.

Параметры

Имя Тип Описание
status GuestStatus новый статус

Возвращаться

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)

Устанавливает тег ключ/значение для события для хранения пользовательских метаданных.

Параметры

Имя Тип Описание
key String ключ тега
value String значение тега

Возвращаться

CalendarEvent — этот CalendarEvent для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

setTime(startTime, endTime)

Устанавливает даты и время начала и окончания события. Применение этого метода превращает событие на весь день в обычное событие.

Параметры

Имя Тип Описание
startTime Date новое начало мероприятия
endTime Date новый конец мероприятия

Возвращаться

CalendarEvent — этот CalendarEvent для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

setTitle(title)

Устанавливает заголовок события.

Параметры

Имя Тип Описание
title String новое название

Возвращаться

CalendarEvent — это событие CalendarEvent для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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

setVisibility(visibility)

Устанавливает видимость события.

Параметры

Имя Тип Описание
visibility Visibility

Возвращаться

CalendarEvent — этот CalendarEvent для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

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