Google Calendar
Входит в Macro DeckПоказывайте события Google Календаря на панели, отсчитывайте время до следующей встречи и подключайтесь к ней одним нажатием.
Виджеты «Календарь» со списком событий на ближайшие дни, следующим событием с обратным отсчётом и компактным списком событий
- Расписание и следующее событие в виджете «Календарь»
- Триггеры до, в момент и после начала события
- Подключение к текущей встрече одним нажатием
- Подключение нескольких аккаунтов Google
- Доступ к календарям только для чтения
Интеграция Google Calendar читает календари вашего аккаунта Google и передаёт их события в календарные функции Macro Deck: виджет Календарь, календарные триггеры и действие Присоединиться к встрече. Macro Deck только читает. Он никогда не создаёт, не изменяет и не удаляет события.
Macro Deck подключается через собственный клиент OAuth в Google Cloud. Его настройка бесплатна и нужна один раз: настройка в Macro Deck проведёт вас по шагам и даст ссылки на нужные страницы Google Cloud Console. После этого вы входите в аккаунт Google в браузере и разрешаете Macro Deck видеть ваши календари.
Что с этим можно делать
- Виджет «Календарь»: макет Расписание перечисляет предстоящие события, а макет Следующее событие отсчитывает время до следующего. Нажмите на виджет, чтобы увидеть подробности события: место, описание, приглашённых и кнопку Подключиться к встрече.
- Триггеры: Событие скоро начнётся, Событие началось и Событие завершено запускают действия вокруг ваших встреч в автоматизации или на виджете. Их можно ограничить одним аккаунтом или одним календарём.
- Присоединиться к встрече: открывает ссылку на встречу для события, которое идёт или вот-вот начнётся, на компьютере, где работает Macro Deck.
Несколько примеров:
- Кнопка на панели с действием Присоединиться к встрече, чтобы подключаться к текущему звонку, не разыскивая ссылку.
- Автоматизация по триггеру Событие скоро начнётся за 5 минут до каждого события в рабочем календаре, которая выключает музыку.
- Автоматизация по триггеру Событие завершено, которая переключает панель обратно на повседневный профиль.
Как это работает
Macro Deck читает ваши календари каждые пять минут, начиная со вчерашнего дня и примерно на неделю вперёд. Действие Обновить календари читает их сразу. У повторяющихся событий показывается каждое повторение. Календари, которые вы скрыли в собственном списке Google Календаря, в Macro Deck тоже не попадают.
Можно подключить сколько угодно аккаунтов Google, каждый как отдельную настройку, и один и тот же клиент OAuth работает для всех. Если аккаунт не удаётся прочитать, виджеты сохраняют его последние известные события и сообщают, что некоторые календари не удалось обновить, а в разделе Интеграции появляется уведомление для этого аккаунта.
Всё, что показывает календарный виджет, включая описания и участников, видно на каждом устройстве, подключённом к вашему Macro Deck.
Что понадобится
- Macro Deck 3 в Windows, macOS или Linux
- Аккаунт Google с Google Календарём
- Проект Google Cloud с включённым Google Calendar API
- Идентификатор клиента OAuth типа Desktop app с его Client ID и Client Secret
- Браузер на компьютере, где работает Macro Deck, для входа в Google
Настройка
Шаг 1: Откройте настройку Google Calendar
На боковой панели нажмите Интеграции, а затем Google Calendar. На вкладке Обзор нажмите Добавить настройку в разделе Настройка. Если включить переключатель в правом верхнем углу, откроется тот же диалог, а интеграция включится после завершения настройки. В диалоге Подключение Google Календаря перечислены шаги ниже со ссылками на Google Cloud Console и Redirect URI, который можно скопировать.
Шаг 2: Включите Google Calendar API
В Google Cloud Console (
https://console.cloud.google.com) создайте или выберите проект и включите для него Google Calendar API. В диалоге настройки ссылка на эту страницу называется Включить Google Calendar API.Шаг 3: Настройте экран согласия OAuth
Настройте экран согласия OAuth проекта и установите для статуса публикации значение In production. Пока статус остаётся Testing, Google завершает каждый вход через 7 дней, и вам пришлось бы подключать аккаунт заново каждую неделю.
Шаг 4: Создайте клиент типа Desktop app
В разделе APIs & Services > Credentials создайте идентификатор клиента OAuth с типом приложения Desktop app. Клиент Desktop app принимает Redirect URI, который показывает диалог настройки, например
http://127.0.0.1:8193/api/integrations/oauth/callback, и его никуда не нужно добавлять.Шаг 5: Введите Client ID и секрет
Скопируйте идентификатор и секрет нового клиента в поля Client ID и Client Secret диалога и нажмите Продолжить. В браузере откроется вход в Google. Google предупредит, что приложение не проверено: для собственного клиента это ожидаемо. Выберите Advanced, перейдите к своему приложению и разрешите доступ к календарям.
Шаг 6: Добавьте виджет «Календарь»
На странице Панель добавьте виджет Календарь. В его настройках выберите в поле Макет вариант Расписание или Следующее событие, а в поле Календари укажите, какие календари показывать. Оставьте поле Календари пустым, чтобы показывать все подключённые календари.
Шаг 7: Добавьте «Присоединиться к встрече» на кнопку
На странице Панель убедитесь, что панель разблокирована (кнопка в правом верхнем углу называется Заблокировать), и нажмите на кнопку. Откроется редактор, в котором выбран триггер Короткое нажатие. Нажмите + Добавить действие, слева в диалоге Добавить действие выберите Календарь и затем действие Присоединиться к встрече. Поле Начинается в течение задаёт, насколько заранее действие подключается к предстоящему событию (по умолчанию за 15 минут), а поле Календарь ограничивает его одним календарём.
Действия3
Назначьте их на кнопку или запускайте из цепочки действий.
- Присоединиться к встрече
- Открывает ссылку на встречу для события, которое идёт или вот-вот начнётся, на компьютере, где работает Macro Deck.
- Обновить календари
- Сразу читает события всех подключённых календарей, не дожидаясь следующего обновления.
- Показать подробности календаря
- Открывает подробности виджета «Календарь»: событие, которое показывает макет «Следующее событие», или список макета «Расписание».
Триггеры3
Кнопка или цепочка действий может реагировать на эти события.
- Событие скоро начнётся
- Срабатывает за заданное время до начала события календаря, по умолчанию за 15 минут.
- Событие началось
- Срабатывает, когда начинается событие календаря.
- Событие завершено
- Срабатывает, когда заканчивается событие календаря.
Переменные1
Показывайте эти значения на кнопках и виджетах или используйте их в условиях.
calendar_next_title,calendar_next_countdown,calendar_next_minutes,calendar_next_meeting_url- Переменные виджета, которые каждый виджет «Календарь» хранит о показанном событии: его название, обратный отсчёт до него, число минут до начала и ссылку на встречу. Виджет также хранит начало, окончание, место и календарь события и то, идёт ли оно сейчас.
Виджеты1
Добавляйте их на свою панель в окне выбора виджета.
- Календарь
- Показывает предстоящие события в виде расписания или следующее событие с обратным отсчётом.
Часто задаваемые вопросы
Зачем нужен собственный клиент Google Cloud?
Macro Deck читает Google Календарь через собственный клиент OAuth. Он бесплатный, а настройка даёт ссылки на все нужные страницы. Один и тот же клиент работает для всех подключаемых аккаунтов Google.
Почему Google просит входить снова каждую неделю?
Экран согласия OAuth вашего клиента Google Cloud всё ещё находится в статусе Testing, и Google завершает каждый вход через 7 дней. Установите для статуса публикации значение In production и снова войдите с помощью кнопки Изменить подключение рядом с аккаунтом на странице Google Calendar.
Можно ли подключить несколько аккаунтов Google?
Да. Нажмите Добавить настройку на странице Google Calendar и войдите с другим аккаунтом. Если подключить аккаунт, который уже подключён, в разделе Интеграции появится сообщение Учётная запись Google подключена дважды: удалите более старую настройку.
К чему Macro Deck получает доступ?
Macro Deck запрашивает у Google только доступ на чтение к календарям и ваш адрес электронной почты, по которому называется аккаунт. Client Secret и данные входа хранятся в зашифрованном виде на компьютере, где работает Macro Deck, а Client Secret отправляется только в Google.
Почему новое событие появляется не сразу?
Macro Deck читает ваши календари каждые пять минут. Используйте действие Обновить календари, чтобы прочитать их сразу. События дальше чем примерно через неделю не читаются.
Почему после входа браузер не возвращается в Macro Deck?
Проверьте, что тип приложения клиента OAuth равен Desktop app: другие типы принимают только адреса перенаправления, которые вы регистрируете сами. Если Macro Deck принимает только HTTPS, установите для параметра Режим слушателя в разделе Настройки > Сеть значение Использовать дополнительный порт HTTPS или выключите HTTPS на время подключения аккаунта.
Ещё в группе «Календарь и почта»
Outlook Calendar
Входит в Macro DeckПоказывайте календарь Outlook и Microsoft 365 на панели и подключайтесь к встречам Teams одним нажатием.
Почта (IMAP)
Входит в Macro DeckПоказывайте на панели непрочитанные и самые новые письма любого почтового ящика IMAP и реагируйте на приход почты.