Google Apps Script: Как создать событие календаря?

12.09.2025
52030

4 мин
248

Что такое Google Apps Script и зачем он нужен?

Google Apps Script (GAS) – это облачный язык сценариев, позволяющий автоматизировать задачи в Google Workspace (Gmail, Docs, Sheets, Calendar и т.д.). Он основан на JavaScript и предоставляет мощные API для взаимодействия с сервисами Google и сторонними приложениями. GAS идеально подходит для автоматизации рутинных задач, создания пользовательских функций и интеграции различных сервисов.

Необходимые условия: доступ к Google Calendar API

Для работы с Google Calendar API в Google Apps Script необходимо убедиться, что API активирован для вашего проекта. Это можно сделать в редакторе GAS, выбрав ‘Services’ (Сервисы) в левом меню и добавив ‘Calendar API’. Также убедитесь, что у вас есть доступ к календарю, в котором вы хотите создавать события. Это может быть ваш основной календарь или любой другой календарь, к которому у вас есть права на запись.

Обзор основных методов Calendar API для создания событий

Основной класс для работы с календарем – CalendarApp. Он предоставляет методы для получения доступа к календарям (getCalendarById(), getDefaultCalendar()), а также для создания событий (createEvent(), createEventSeries()). Класс Calendar (возвращаемый getCalendarById(), getDefaultCalendar()) имеет методы для создания конкретных событий: createEvent(title, startTime, endTime, options). Мы будем использовать их в примерах ниже.

Создание простого события в Google Календаре

Получение доступа к календарю по ID

Чтобы создать событие, сначала нужно получить доступ к целевому календарю. Обычно это делается с помощью ID календаря. ID можно найти в настройках календаря в Google Calendar.

Основные параметры события: название, время начала и окончания

Для создания события необходимо указать его название, время начала и время окончания. Время указывается в формате Date (объект JavaScript Date).

Код для создания базового события и его объяснение

/**
 * Создает простое событие в Google Календаре.
 */
function createBasicEvent() {
  // ID календаря (замените на ваш)
  const calendarId: string = 'your_calendar_id@group.calendar.google.com';
  // Получаем календарь по ID
  const calendar: GoogleAppsScript.Calendar.Calendar = CalendarApp.getCalendarById(calendarId);

  // Определяем время начала и окончания события (через час)
  const startTime: Date = new Date();
  const endTime: Date = new Date(startTime.getTime() + 60 * 60 * 1000); // Добавляем 1 час

  // Название события
  const eventTitle: string = 'Базовое событие GAS';

  // Создаем событие
  try {
    calendar.createEvent(eventTitle, startTime, endTime);
    Logger.log('Событие успешно создано!');
  } catch (e) {
    Logger.log('Ошибка при создании события: ' + e);
  }
}

Объяснение кода:

calendarId: Замените 'your_calendar_id@group.calendar.google.com' на ID вашего календаря.

CalendarApp.getCalendarById(calendarId): Получает объект календаря по его ID.

startTime и endTime: Создаются объекты Date для указания времени начала и окончания события. В данном примере событие длится 1 час.

calendar.createEvent(eventTitle, startTime, endTime): Создает событие с указанными параметрами. Функция createEvent может бросить исключение, поэтому обрамляем ее в блок try...catch для обработки ошибок.

Logger.log(): Используется для логирования сообщений об успехе или ошибке. Логи можно посмотреть в редакторе GAS (View -> Logs).

Настройка параметров события: описание, местоположение, участники

Добавление описания и местоположения к событию

Помимо названия и времени, можно добавить описание и местоположение к событию, используя опциональный параметр options в методе createEvent().

Приглашение участников на событие

Чтобы пригласить участников, добавьте их адреса электронной почты в опцию guests.

Установка напоминаний для события

Установите напоминания (notifications) с помощью опции reminders. Можно установить несколько напоминаний разного типа (email, popup) и за разное время до начала события.

Управление видимостью события (общедоступное/приватное)

Управляйте видимостью с помощью опции visibility. Значения: 'default', 'public', 'private', 'confidential'. Значение 'default' использует настройки календаря.

Пример кода:

/**
 * Создает событие с расширенными параметрами.
 */
function createAdvancedEvent() {
  const calendarId: string = 'your_calendar_id@group.calendar.google.com';
  const calendar: GoogleAppsScript.Calendar.Calendar = CalendarApp.getCalendarById(calendarId);

  const startTime: Date = new Date();
  const endTime: Date = new Date(startTime.getTime() + 60 * 60 * 1000);

  const eventTitle: string = 'Продвинутое событие GAS';

  const eventDescription: string = 'Описание события.  Подробности здесь...';
  const eventLocation: string = 'Google Office, Москва';
  const guestEmails: string = 'user1@example.com, user2@example.com';

  const options: GoogleAppsScript.Calendar.EventOptionalArgs = {
    description: eventDescription,
    location: eventLocation,
    guests: guestEmails,
    visibility: 'public',
    sendInvites: true, // Отправлять приглашения гостям
    reminders: {
      'useDefault': false,
      'overrides': [
        {'method': 'email', 'minutes': 24 * 60}, // За день до события
        {'method': 'popup', 'minutes': 30} // За 30 минут до события
      ]
    }
  };

  try {
    calendar.createEvent(eventTitle, startTime, endTime, options);
    Logger.log('Продвинутое событие успешно создано!');
  } catch (e) {
    Logger.log('Ошибка при создании продвинутого события: ' + e);
  }
}

Обработка ошибок и отладка скрипта

Типичные ошибки при создании событий и способы их решения

Неправильный ID календаря: Проверьте правильность ID календаря.

Недостаточно прав доступа: Убедитесь, что у вашего аккаунта есть права на запись в целевой календарь.

Неправильный формат даты: Даты должны быть представлены в формате Date.

Дублирование гостей: Убедитесь, что в списке гостей нет повторяющихся адресов.

Превышение лимитов Google Apps Script: Скрипты GAS имеют ограничения на время выполнения и количество запросов в день. Если скрипт выполняется слишком долго, попробуйте оптимизировать его или разбить на несколько частей.

Логирование и отладка кода в Google Apps Script

Для отладки используйте Logger.log() для вывода значений переменных и сообщений в лог. Также полезно использовать режим отладки в редакторе GAS, который позволяет выполнять код построчно и просматривать значения переменных.

Примеры продвинутого использования: создание повторяющихся событий

Создание повторяющихся событий с заданным интервалом

Для создания повторяющихся событий используйте метод createEventSeries(). Он требует указания правила повторения (recurrence rule) в формате iCalendar (RFC 5545).

Пример:

/**
 * Создает повторяющееся событие.
 */
function createRecurringEvent() {
  const calendarId: string = 'your_calendar_id@group.calendar.google.com';
  const calendar: GoogleAppsScript.Calendar.Calendar = CalendarApp.getCalendarById(calendarId);

  const startTime: Date = new Date();
  const endTime: Date = new Date(startTime.getTime() + 60 * 60 * 1000);
  const eventTitle: string = 'Повторяющееся событие GAS';

  // Правило повторения: еженедельно по вторникам и средам до 31 декабря 2024 года
  const recurrenceRule: string = 'RRULE:FREQ=WEEKLY;BYDAY=TU,WE;UNTIL=20241231T000000Z';

  const options: GoogleAppsScript.Calendar.EventSeriesOptionalArgs = {
    description: 'Описание повторяющегося события',
    location: 'Онлайн',
  };

  try {
    calendar.createEventSeries(eventTitle, startTime, endTime, recurrenceRule, options);
    Logger.log('Повторяющееся событие успешно создано!');
  } catch (e) {
    Logger.log('Ошибка при создании повторяющегося события: ' + e);
  }
}

Объяснение:

RRULE:FREQ=WEEKLY: Указывает, что событие повторяется еженедельно.

BYDAY=TU,WE: Указывает, что событие происходит по вторникам и средам.

UNTIL=20241231T000000Z: Указывает дату окончания повторения (31 декабря 2024 года).

Исключение определенных дат из повторяющегося события

Исключение определенных дат из повторяющегося события требует более сложной логики. Необходимо получить все экземпляры события (events) и удалить ненужные. Это можно сделать, используя метод Calendar.getEvents(startTime, endTime). После чего нужно перебрать полученные события и удалить лишние с помощью CalendarEvent.deleteEvent().

Использование сторонних библиотек для упрощения работы с календарем (если применимо)

В Google Apps Script можно использовать сторонние библиотеки, но для работы с календарем обычно достаточно встроенных возможностей Calendar API. Если вам требуются более сложные операции (например, импорт/экспорт событий в формате iCalendar), то можно рассмотреть использование специализированных библиотек, но это выходит за рамки данной статьи.