Google Calendar
Управление событиями Google Calendar
Google Calendar — это широко используемый онлайн-календарь и сервис планирования от Google, который упрощает организацию встреч, событий, напоминаний и встреч индивидуально или совместно. Как ключевая часть Google Workspace, Google Calendar предлагает мощные инструменты для управления вашим расписанием, отправки приглашений, установки напоминаний о событиях и совместного использования календарей с другими.
Google Calendar поддерживает функционально насыщенные интеграции и автоматизацию, позволяя пользователям и командам оптимизировать управление событиями и поддерживать синхронизацию рабочих процессов. Его API позволяет программно создавать, изменять и перечислять события календаря, давая агентам и автоматизированным рабочим процессам возможность взаимодействовать с вашим расписанием в реальном времени.
Ключевые функции Google Calendar включают:
- Планирование событий: Создание разовых или повторяющихся событий с подробной информацией, такой как время, место и участники.
- Напоминания и уведомления: Автоматические напоминания по электронной почте и push-уведомления, чтобы вы никогда не пропустили важное событие.
- Совместное использование и сотрудничество: Совместное использование календарей с отдельными лицами или группами, управление разрешениями и координация встреч.
- Интеграция: Подключение к Gmail, Meet, Docs и внешним инструментам для единого опыта продуктивности.
- Поддержка часовых поясов: Планирование встреч в разных регионах с полным учетом часовых поясов.
- Доступ с мобильных устройств и нескольких устройств: Доступ к вашему календарю из веб-версии, мобильных и настольных приложений.
В AACFlow интеграция с Google Calendar позволяет вашим агентам читать, создавать, обновлять и перечислять события календаря в рамках автоматизированных рабочих процессов. Это позволяет реализовать мощные сценарии, такие как синхронизация информации о встречах, генерация напоминаний, отслеживание изменений событий, координация расписаний команд и многое другое. Подключая AACFlow к Google Calendar, ваши агенты могут обрабатывать задачи планирования, интеллектуально управлять событиями и поддерживать работу всей организации без ручного вмешательства.
Интегрируйте Google Calendar в рабочий процесс. Возможности: создание, чтение, обновление и перечисление событий календаря.
Создание нового события в Google Calendar. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
calendarId | string | Нет | ID календаря Google (например, primary или calendar@group.calendar.google.com) |
summary | string | Да | Заголовок/краткое описание события |
description | string | Нет | Описание события |
location | string | Нет | Место проведения события |
startDateTime | string | Да | Дата и время начала. ДОЛЖЕН включать смещение часового пояса (например, 2025-06-03T10:00:00-08:00) ИЛИ предоставить параметр timeZone |
endDateTime | string | Да | Дата и время окончания. ДОЛЖЕН включать смещение часового пояса (например, 2025-06-03T11:00:00-08:00) ИЛИ предоставить параметр timeZone |
timeZone | string | Нет | Часовой пояс (например, America/Los_Angeles). Обязателен, если дата и время не включают смещение. По умолчанию America/Los_Angeles, если не указано. |
attendees | array | Нет | Массив адресов электронной почты участников |
sendUpdates | string | Нет | Способ отправки обновлений участникам: all, externalOnly или none |
| Параметр | Тип | Описание |
|---|
id | string | ID события |
htmlLink | string | Ссылка на событие |
status | string | Статус события |
summary | string | Заголовок события |
description | string | Описание события |
location | string | Место проведения события |
start | json | Начало события |
end | json | Окончание события |
attendees | json | Участники события |
creator | json | Создатель события |
organizer | json | Организатор события |
Перечисление событий из Google Calendar. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
calendarId | string | Нет | ID календаря Google (например, primary или calendar@group.calendar.google.com) |
timeMin | string | Нет | Нижняя граница для событий (метка времени RFC3339, например, 2025-06-03T00:00:00Z) |
timeMax | string | Нет | Верхняя граница для событий (метка времени RFC3339, например, 2025-06-04T00:00:00Z) |
orderBy | string | Нет | Порядок возвращаемых событий (startTime или updated) |
showDeleted | boolean | Нет | Включать удаленные события |
| Параметр | Тип | Описание |
|---|
nextPageToken | string | Токен следующей страницы |
timeZone | string | Часовой пояс календаря |
events | json | Список событий |
Получение конкретного события из Google Calendar. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
calendarId | string | Нет | ID календаря Google (например, primary или calendar@group.calendar.google.com) |
eventId | string | Да | ID события Google Calendar для получения |
| Параметр | Тип | Описание |
|---|
id | string | ID события |
htmlLink | string | Ссылка на событие |
status | string | Статус события |
summary | string | Заголовок события |
description | string | Описание события |
location | string | Место проведения события |
start | json | Начало события |
end | json | Окончание события |
attendees | json | Участники события |
creator | json | Создатель события |
organizer | json | Организатор события |
Обновление существующего события в Google Calendar. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
calendarId | string | Нет | ID календаря Google (например, primary или calendar@group.calendar.google.com) |
eventId | string | Да | ID события Google Calendar для обновления |
summary | string | Нет | Новый заголовок/краткое описание события |
description | string | Нет | Новое описание события |
location | string | Нет | Новое место проведения события |
startDateTime | string | Нет | Новая дата и время начала. ДОЛЖЕН включать смещение часового пояса (например, 2025-06-03T10:00:00-08:00) ИЛИ предоставить параметр timeZone |
endDateTime | string | Нет | Новая дата и время окончания. ДОЛЖЕН включать смещение часового пояса (например, 2025-06-03T11:00:00-08:00) ИЛИ предоставить параметр timeZone |
timeZone | string | Нет | Часовой пояс (например, America/Los_Angeles). Обязателен, если дата и время не включают смещение. |
attendees | array | Нет | Массив адресов электронной почты участников (заменяет существующих участников) |
sendUpdates | string | Нет | Способ отправки обновлений участникам: all, externalOnly или none |
| Параметр | Тип | Описание |
|---|
id | string | ID события |
htmlLink | string | Ссылка на событие |
status | string | Статус события |
summary | string | Заголовок события |
description | string | Описание события |
location | string | Место проведения события |
start | json | Начало события |
end | json | Окончание события |
attendees | json | Участники события |
creator | json | Создатель события |
organizer | json | Организатор события |
Удаление события из Google Calendar. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
calendarId | string | Нет | ID календаря Google (например, primary или calendar@group.calendar.google.com) |
eventId | string | Да | ID события Google Calendar для удаления |
sendUpdates | string | Нет | Способ отправки обновлений участникам: all, externalOnly или none |
| Параметр | Тип | Описание |
|---|
eventId | string | ID удаленного события |
deleted | boolean | Успешно ли выполнено удаление |
Перемещение события в другой календарь. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
calendarId | string | Нет | ID исходного календаря Google (например, primary или calendar@group.calendar.google.com) |
eventId | string | Да | ID события Google Calendar для перемещения |
destinationCalendarId | string | Да | ID календаря Google назначения |
sendUpdates | string | Нет | Способ отправки обновлений участникам: all, externalOnly или none |
| Параметр | Тип | Описание |
|---|
id | string | ID события |
htmlLink | string | Ссылка на событие |
status | string | Статус события |
summary | string | Заголовок события |
description | string | Описание события |
location | string | Место проведения события |
start | json | Начало события |
end | json | Окончание события |
attendees | json | Участники события |
creator | json | Создатель события |
organizer | json | Организатор события |
Получение экземпляров повторяющегося события из Google Calendar. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
calendarId | string | Нет | ID календаря Google (например, primary или calendar@group.calendar.google.com) |
eventId | string | Да | ID повторяющегося события для получения экземпляров |
timeMin | string | Нет | Нижняя граница для экземпляров (метка времени RFC3339, например, 2025-06-03T00:00:00Z) |
timeMax | string | Нет | Верхняя граница для экземпляров (метка времени RFC3339, например, 2025-06-04T00:00:00Z) |
maxResults | number | Нет | Максимальное количество возвращаемых экземпляров (по умолчанию 250, максимум 2500) |
pageToken | string | Нет | Токен для получения последующих страниц результатов |
showDeleted | boolean | Нет | Включать удаленные экземпляры |
| Параметр | Тип | Описание |
|---|
nextPageToken | string | Токен следующей страницы |
timeZone | string | Часовой пояс календаря |
instances | json | Список экземпляров повторяющегося события |
Перечисление всех календарей пользователя
| Параметр | Тип | Обязательный | Описание |
|---|
minAccessRole | string | Нет | Минимальная роль доступа для возвращаемых календарей: freeBusyReader, reader, writer или owner |
maxResults | number | Нет | Максимальное количество возвращаемых календарей (по умолчанию 100, максимум 250) |
pageToken | string | Нет | Токен для получения последующих страниц результатов |
showDeleted | boolean | Нет | Включать удаленные календари |
showHidden | boolean | Нет | Включать скрытые календари |
| Параметр | Тип | Описание |
|---|
nextPageToken | string | Токен следующей страницы |
calendars | array | Список календарей |
↳ id | string | ID календаря |
↳ summary | string | Заголовок календаря |
↳ description | string | Описание календаря |
↳ location | string | Местоположение календаря |
↳ timeZone | string | Часовой пояс календаря |
↳ accessRole | string | Роль доступа для календаря |
↳ backgroundColor | string | Цвет фона календаря |
↳ foregroundColor | string | Цвет текста календаря |
↳ primary | boolean | Является ли этот календарь основным |
↳ hidden | boolean | Скрыт ли календарь |
↳ selected | boolean | Выбран ли календарь |
Создание событий из текста на естественном языке. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
calendarId | string | Нет | ID календаря Google (например, primary или calendar@group.calendar.google.com) |
text | string | Да | Текст на естественном языке, описывающий событие (например, "Встреча с Джоном завтра в 15:00") |
attendees | array | Нет | Массив адресов электронной почты участников (также принимается строка, разделенная запятыми) |
sendUpdates | string | Нет | Способ отправки обновлений участникам: all, externalOnly или none |
| Параметр | Тип | Описание |
|---|
id | string | ID события |
htmlLink | string | Ссылка на событие |
status | string | Статус события |
summary | string | Заголовок события |
description | string | Описание события |
location | string | Место проведения события |
start | json | Начало события |
end | json | Окончание события |
attendees | json | Участники события |
creator | json | Создатель события |
organizer | json | Организатор события |
Приглашение участников в существующее событие Google Calendar. Возвращает только поля, соответствующие API.
| Параметр | Тип | Обязательный | Описание |
|---|
calendarId | string | Нет | ID календаря Google (например, primary или calendar@group.calendar.google.com) |
eventId | string | Да | ID события Google Calendar для приглашения участников |
attendees | array | Да | Массив адресов электронной почты участников для приглашения |
sendUpdates | string | Нет | Способ отправки обновлений участникам: all, externalOnly или none |
replaceExisting | boolean | Нет | Заменять ли существующих участников или добавлять к ним (по умолчанию false) |
| Параметр | Тип | Описание |
|---|
id | string | ID события |
htmlLink | string | Ссылка на событие |
status | string | Статус события |
summary | string | Заголовок события |
description | string | Описание события |
location | string | Место проведения события |
start | json | Начало события |
end | json | Окончание события |
attendees | json | Участники события |
creator | json | Создатель события |
organizer | json | Организатор события |
