Что это
Google Calendar API — это API для работы с Google Calendar: календари, events, attendees, reminders, recurring events, availability, free/busy и изменения расписания.
Для AI-агента это базовый канал для встреч: найти окно, проверить free/busy, собрать attendees, создать draft-событие, добавить agenda и отправить follow-up после встречи.
Главное — не давать агенту сразу полные write-права. Безопасный паттерн: сначала read/free-busy, затем draft и approval, и только потом создание, перенос или удаление events.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Высокий контроль
- Чувствительные данные: Только с настройками
Доступные модели и версии
Сильные стороны
- нативный API-доступ к Google Calendar и Google Workspace
- поддерживает free/busy без раскрытия всех деталей встреч
- можно связать встречи с CRM, email, tasks и meeting notes
- хорошо ложится в AI-агентов для руководителя, sales и support
- есть recurring events, reminders, attendees и conference data
Ограничения
- нужен Google Cloud project, OAuth consent и scopes
- сложные recurring events и timezone-сценарии нужно тестировать отдельно
- права write/delete опасны без approval и audit log
- есть quotas и Workspace-ограничения
- не решает сама по себе задачи meeting notes, CRM hygiene и task follow-up
Как использовать
Определите сценарий: free/busy, draft event, booking, reschedule, reminders или weekly review.
Настройте Google Cloud project, OAuth consent и minimal scopes.
Начните с read-only/free-busy и не давайте AI сразу write/delete.
Для встреч задайте поля: title, agenda, attendees, duration, timezone, location, conference link, reminders.
Перед созданием или переносом делайте approval: что, когда, кто участвует, что изменится.
Ведите audit log: event id, action, old time, new time, actor, approver, status.
Проверяйте timezone, recurring events и guest permissions на тестовом календаре.
Примеры сценариев
- Агент ищет окно для demo между sales-менеджером, клиентом и presales.
- После звонка AI готовит follow-up и создает draft следующей встречи.
- Руководитель получает weekly review: сколько часов ушло на 1:1, клиентов, hiring и focus work.
- Агент находит конфликты и готовит 2-3 варианта переноса.
Доступ и оплата
- Модель оплаты: Бесплатный тариф + платные возможности
- Бесплатный тариф: Да
- Работа в РФ: Ограниченно
- VPN: Иногда может понадобиться
- Русский интерфейс: Да
- Русский язык: Хорошо
Google Calendar API лучше внедрять с read-only/free-busy сценария. Write-действия включайте только после тестов, approvals и audit log.
Какой тариф выбрать
- Сам API часто не главный cost: важны Google Workspace, разработка, LLM-вызовы и обслуживание OAuth.
- Если нужна только booking-ссылка, готовый scheduling-сервис может быть дешевле.
- Для enterprise-сценариев сразу считайте SSO, domain-wide delegation, audit и роли доступа.
Когда не подходит
- автоудаление и перенос встреч без approval
- доступ AI ко всем календарям без ролей и scopes
- обход корпоративной Google Workspace policy
- задачи, где достаточно простой booking-ссылки
- хранение OAuth tokens в коде, таблицах и logs
Альтернативы
Microsoft Graph Calendar API нужен для Outlook/Microsoft 365. CalDAV более универсален, но менее удобен. Calendly, Cal.com и Cronofy часто проще для booking-сценариев.
Когда выбирать
Имеет смысл, если нужно быстрее обрабатывать лиды, готовить письма, анализировать звонки, обновлять CRM и подсказывать следующий шаг менеджеру.
На что обратить внимание
Важно не превращать AI в источник спама. Нужны правила тона, проверка персональных данных и контроль качества коммуникации.
Как начать
- Выберите участок воронки.
- Подготовьте примеры хороших сообщений.
- Настройте ручное подтверждение важных действий.
- Сравните скорость и конверсию до и после запуска.