Дії Google

Отримати подію з Calendar

Look up an event and format it

User sends event id → fetch → format human-readable reply

Telegram Bot

Bot Update

message
userID

Google

Get Calendar Event

eventId
message
summary
start
location

Text

Compose

template
{{summary}} on {{start}} at {{location}}
output

Telegram Bot

Send Message

chatId
userID
text
output

Читає одну подію з основного Google Календаря за id. Корисно коли у flow є лише id (з vault, з попереднього Create Event, з Telegram callback) і треба дізнатись актуальний стан події.

Входи

ВхідТипОпис
eventIdstringОбов'язково. Id події (повертається з Create / List Event).

Виходи

ВихідТипОпис
summarystringНазва події.
descriptionstringОпис події.
locationstringЛокація події.
startstringISO 8601 datetime (або тільки дата для повноденних подій).
endstringISO 8601 datetime (або тільки дата для повноденних подій).
attendeesstringСписок email-ів учасників через кому — той самий формат що Update / Create приймають на вхід.
htmlLinkstringПосилання на подію в інтерфейсі Google Calendar.
errorstringПорожній при успіху. Містить повідомлення Google при статусі ERROR.

Виходи навмисно плоскі (без вкладеного JSON) щоб у редакторі flow поля можна було перетягувати прямо в інші дії. Якщо потрібен сирий JSON — використовуйте List Calendar Events (повертає таку саму спрощену структуру у events).

Необхідні дозволи

Capability Manage Calendar events (calendar.events). Перепідключіть з відміченою галкою якщо її немає.

Приклади використання

  • Оновити стан перед переносом — отримати поточні start / end, порівняти з запитом, PATCH'ити лише якщо реально відрізняється.
  • Сформатувати подію в Telegram-повідомлення — Get → Compose → Telegram Bot send.
  • Валідація перед видаленням — Get; якщо summary більше не відповідає відомому префіксу — пропускаємо Delete.

Можливі помилки

error outputЩо означає
eventId is requiredПоле eventId порожнє / пробіли.
Not FoundПодії з таким id на основному календарі немає.
Insufficient PermissionЗ'єднанню не вистачає calendar.events. Перепідключіть.
Google connection has been revoked — reconnect it from the Connections page.Користувач відкликав Fainflow зі свого Google-акаунта, або refresh token протух.