Представляет одно событие календаря.
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
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