Зохо Календарь
Zoho Calendar — это бизнес-календарь в Интернете, который упрощает планирование. Вы можете использовать его, чтобы оставаться на вершине расписания, а также поделиться календарями с командой, чтобы держать всех на одной странице.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Зохо Календарь |
| URL | https://www.zoho.com/calendar/contact.html |
| Адрес электронной почты | zmintegration@zohomail.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Zoho Mail |
| Веб-сайт | https://www.zoho.com/calendar/ |
| Политика конфиденциальности | https://www.zoho.com/privacy.html |
| Категории | Сотрудничество; Продуктивность |
Зохо Календарь
Zoho Calendar — это бизнес-календарь в Интернете, который упрощает планирование. Соединитель "Календарь Zoho" позволяет управлять календарем и выполнять повторяющиеся действия, такие как создание, изменение, удаление события путем создания рабочих процессов с помощью модели триггеров действий.
Предпосылки
Проверенная учетная запись Календаря Zoho. Щелкните здесь , чтобы создать первую учетную запись.
Получение учетных данных
При создании нового подключения
- Выберите домен, в котором находится учетная запись Zoho.
- Введите учетные данные календаря Zoho.
- Даже если приложение power предоставляется другому пользователю, он должен создать новое подключение, чтобы начать использовать его.
API календаря Zoho использует OAuth2.0 для проверки подлинности, поэтому после настройки учетной записи не требуется дополнительная проверка подлинности.
Начало работы с соединителем
Выполните следующие действия, чтобы подключиться к Zoho Calendar:
- Войдите в учетную запись Power Automate и щелкните "Создать" в меню слева.
- Вы можете создать облачный поток, рабочий поток или бизнес-поток. Чтобы подключиться к Zoho Calendar, выберите автоматизированный поток облака.
- Вы можете создать поток или шаблон.
- Введите нужные значения для соответствующего действия.
Известные проблемы и ограничения
- В настоящее время повторяющиеся события не поддерживаются в соединителе.
Распространенные ошибки и средства устранения неполадок
- Чтобы избежать ошибок проверки подлинности, выберите домен, в котором размещена учетная запись Календаря Zoho.
Часто задаваемые вопросы
https://www.zoho.com/calendar/help/getting-started.html
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Выберите регион, в котором находятся данные учетной записи Zoho. | струна | Выберите домен. | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Вывод события |
Получает сведения о конкретном событии, например название события, дату начала, дату окончания и т. д., из указанного календаря пользователя. |
| Обновление события |
Обновляет существующее событие в календаре пользователя. |
| Получение сведений о календаре |
извлекает сведения о конкретном календаре с помощью пользовательского интерфейса календаря. |
| Получение списка календарей |
Возвращает список всех календарей с помощью пользовательского интерфейса календаря, имени и часового пояса. |
| Получение списка событий |
Возвращает список всех событий между указанным диапазоном дат в формате гггг-ММ-ддTHH:мм:sszzz. |
| События поиска |
Возвращает список событий во всех календарях. |
| Создание события |
Добавляет новое событие в календарь пользователя. |
| Удаление события |
Удаляет событие из календаря пользователя. |
Вывод события
Получает сведения о конкретном событии, например название события, дату начала, дату окончания и т. д., из указанного календаря пользователя.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Укажите календарь или введите уникальный идентификатор календаря. |
|
Event
|
euid | True | string |
Введите уникальный идентификатор события. |
Возвращаемое значение
- Тело
- SingleEventRes
Обновление события
Обновляет существующее событие в календаре пользователя.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Укажите календарь или введите уникальный идентификатор календаря. |
|
Event
|
euid | True | string |
Введите уникальный идентификатор события. |
|
Название
|
title | True | string |
Укажите заголовок события |
|
Время запуска
|
start | True | string |
Укажите время начала события в формате гггг-ММ-ддTHH:mm:sszzz |
|
Время окончания
|
end | True | string |
Укажите время окончания события в формате гггг-ММ-ддTHH:мм:sszzz |
|
Timezone
|
timezone | string |
Указание часового пояса события |
|
|
Цвет
|
color | string |
Выберите цвет события или укажите шестнадцатеричное значение цвета |
|
|
Description
|
description | string |
Указание описания события |
|
|
Местоположение
|
location | string |
Укажите расположение события |
|
|
URL
|
url | string |
Укажите URL-адрес события |
|
|
Частный
|
isprivate | boolean |
Укажите, является ли событие частным или нет |
|
|
Весь день
|
isallday | boolean |
Укажите, является ли событие весь день событием. |
|
|
идентификатор электронной почты
|
string |
Укажите адреса электронной почты участников |
||
|
Прозрачность
|
transparency | integer |
Укажите, следует ли добавить событие в расписание бесплатной или занятой работы. |
|
|
Разрешить перенаправление
|
allowForwarding | boolean |
Укажите, можно ли перенаправить событие или нет |
|
|
type
|
action | string |
Укажите тип напоминания о событии (электронная почта, уведомления и т. д.) |
|
|
в минутах
|
minutes | integer |
Укажите время, чтобы напомнить вам до или после события (например, 5 для до, 5 для после) |
Возвращаемое значение
- Тело
- SingleEventRes
Получение сведений о календаре
извлекает сведения о конкретном календаре с помощью пользовательского интерфейса календаря.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Укажите календарь или введите уникальный идентификатор календаря. |
Возвращаемое значение
- Тело
- SingleCalendarRes
Получение списка календарей
Возвращает список всех календарей с помощью пользовательского интерфейса календаря, имени и часового пояса.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
calendars
|
calendars | array of SingleCalendarRes |
calendars |
Получение списка событий
Возвращает список всех событий между указанным диапазоном дат в формате гггг-ММ-ддTHH:мм:sszzz.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Укажите календарь или введите уникальный идентификатор календаря. |
|
По экземпляру
|
byinstance | True | boolean |
Извлекает все экземпляры повторяемых событий как отдельное событие, если оно задано как true. Диапазон дат не должен превышать 31 дней. |
|
Время запуска
|
start | True | string |
Укажите время начала в формате гггг-ММ-ддThh:mm:sszzz |
|
Время окончания
|
end | True | string |
Укажите время окончания в формате гггг-ММ-ддThh:mm:sszzz |
|
Timezone
|
timezone | string |
Указание часового пояса события |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
events
|
events | array of SingleEventRes |
events |
События поиска
Возвращает список событий во всех календарях.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Укажите календарь или введите уникальный идентификатор календаря. |
|
Время запуска
|
start | True | string |
Укажите время начала события в формате гггг-ММ-ддTHH:mm:sszzz. |
|
Время окончания
|
end | string |
Укажите время окончания события в формате гггг-ММ-ддTHH:mm:sszzz. |
|
|
Поиск текста
|
searchtext | string |
Указать нужно искать в заголовке |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
поиск
|
search | array of object |
поиск |
|
Уникальный идентификатор события
|
search.uid | string |
Уникальный идентификатор события |
|
Событие всего дня
|
search.isallday | boolean |
Является ли событие событием весь день |
|
Уникальный идентификатор календаря
|
search.caluid | string |
Уникальный идентификатор календаря |
|
Название
|
search.title | string |
Название события |
|
type
|
search.type | integer |
type |
|
Timezone
|
search.dateandtime.timezone | string |
часовой пояс события |
|
время начала
|
search.dateandtime.start | string |
Время начала события |
|
время окончания
|
search.dateandtime.end | string |
Время окончания события |
Создание события
Добавляет новое событие в календарь пользователя.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Укажите календарь или введите уникальный идентификатор календаря. |
|
Название
|
title | True | string |
Укажите заголовок события |
|
Время запуска
|
start | True | string |
Укажите время начала события в формате гггг-ММ-ддTHH:mm:sszzz |
|
Время окончания
|
end | True | string |
Укажите время окончания события в формате гггг-ММ-ддTHH:мм:sszzz |
|
Timezone
|
timezone | string |
Указание часового пояса события |
|
|
Цвет
|
color | string |
Выберите цвет события или укажите шестнадцатеричное значение цвета |
|
|
Description
|
description | string |
Указание описания события |
|
|
Местоположение
|
location | string |
Укажите расположение события |
|
|
URL
|
url | string |
Укажите URL-адрес события |
|
|
Частный
|
isprivate | boolean |
Укажите, является ли событие частным или нет |
|
|
Весь день
|
isallday | boolean |
Укажите, является ли событие весь день событием. |
|
|
идентификатор электронной почты
|
string |
Укажите адреса электронной почты участников |
||
|
Прозрачность
|
transparency | integer |
Укажите, следует ли добавить событие в расписание бесплатной или занятой работы. |
|
|
Разрешить перенаправление
|
allowForwarding | boolean |
Укажите, можно ли перенаправить событие или нет |
|
|
type
|
action | string |
Укажите тип напоминания о событии (электронная почта, уведомления и т. д.) |
|
|
в минутах
|
minutes | integer |
Укажите время, чтобы напомнить вам до или после события (например, 5 для до, 5 для после) |
Возвращаемое значение
- Тело
- SingleEventRes
Удаление события
Удаляет событие из календаря пользователя.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Укажите календарь или введите уникальный идентификатор календаря. |
|
Event
|
euid | True | string |
Введите уникальный идентификатор события. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
events
|
events | array of object |
events |
|
uid
|
events.uid | string |
uid |
|
повторение
|
events.recurrenceid | string |
повторение |
Триггеры
| Изменение уведомления о событии |
При обновлении события до календаря |
| Новое уведомление о событии |
При добавлении события в календарь |
| Удаление уведомления о событии |
При удалении события в календаре |
Изменение уведомления о событии
Новое уведомление о событии
Удаление уведомления о событии
При удалении события в календаре
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Уникальный идентификатор события
|
zc_data.uid | string |
Уникальный идентификатор события |
|
Уникальный идентификатор календаря
|
zc_data.caluid | string |
Уникальный идентификатор календаря |
Определения
SingleEventRes
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Цвет
|
color | string |
Значение цвета события в шестнадцатеричном |
|
Название
|
title | string |
Название события |
|
Продолжительность
|
duration | string |
Длительность события |
|
Уникальный идентификатор события
|
uid | string |
Уникальный идентификатор события |
|
Событие, созданное с помощью
|
createdby | string |
Пользователь, создавший событие |
|
Утверждено
|
isApproved | boolean |
Утверждается ли созданное событие. |
|
Местоположение
|
location | string |
Расположение события |
|
URL
|
url | string |
URL-адрес события |
|
URL-адрес представления событий
|
viewEventURL | string |
Уникальный URL-адрес события. |
|
timezone
|
dateandtime.timezone | string |
Часовой пояс события |
|
время начала
|
dateandtime.start | string |
Время начала события |
|
время окончания
|
dateandtime.end | string |
Время окончания события |
|
Последнее изменение события
|
lastmodifiedtime | string |
Дата и время последнего изменения события |
|
Является частным
|
isprivate | boolean |
Является ли событие частным событием или нет |
|
Участники
|
attendees | array of object |
Участники мероприятия |
|
отображаемое имя
|
attendees.dName | string |
Отображение имен участников |
|
идентификатор электронной почты
|
attendees.email | string |
Адреса электронной почты участников. |
|
участие
|
attendees.attendance | integer |
Является ли посещаемость обязательной, необязательной или не обязательной. |
|
статус
|
attendees.status | string |
Ссылается на состояние участников (принято/отклонено/отклонено/предварительно/требуется действие) |
|
Создано
|
createdtime_millis | string |
Время создания события в GMT |
|
Тип уведомления
|
notifyType | integer |
Уведомляет участников о событии на основе их предпочтений уведомления по умолчанию. |
|
Организатор
|
organizer | string |
Сведения о организаторе событий. |
|
Событие всего дня
|
isallday | boolean |
Является ли событие событием весь день |
|
Прозрачность
|
transparency | integer |
Следует ли добавить событие в расписание бесплатного и занятого |
|
Изменено пользователем
|
modifiedby | string |
Относится к пользователю, изменившему событие. |
|
Тег события
|
etag | string |
Ссылается на тег события, чтобы определить режим, в котором было создано или изменено событие. |
|
Уникальный идентификатор календаря
|
caluid | string |
Уникальный идентификатор календаря |
|
Разрешить переадресацию
|
allowForwarding | boolean |
Можно ли перенаправить событие. |
|
Напоминания
|
reminders | array of object | |
|
Тип напоминания
|
reminders.action | string |
Относится к типу напоминания о событии (почта, уведомление, всплывающее окно).) |
|
Напомнить мне
|
reminders.minutes | string |
Ссылается на время напоминания в минутах. |
SingleCalendarRes
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Цвет
|
color | string |
Значение цвета календаря в шестнадцатеричном |
|
Timezone
|
timezone | string |
Часовой пояс календаря |
|
Цвет текста
|
textcolor | string |
Цвет текста календаря в шестнадцатеричном виде |
|
Description
|
description | string |
Описание календаря |
|
Уникальный идентификатор календаря
|
uid | string |
Уникальный идентификатор календаря |
|
Значение по умолчанию
|
isdefault | boolean |
Является ли календарь календарем по умолчанию |
|
Включение бесплатной или занятой
|
include_infreebusy | boolean |
Состояние "Бесплатный или занят" календаря |
|
Имя
|
name | string |
имя календаря |
|
Состояние
|
status | boolean |
Состояние календаря |
EventNotifyRes
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Цвет
|
zc_data.color | string |
Значение цвета события в шестнадцатеричном |
|
Название
|
zc_data.title | string |
Название события |
|
Создано
|
zc_data.createdtime | string |
время создания события |
|
Часовой пояс пользователя
|
zc_data.user_timezone | string |
Часовой пояс пользователя |
|
Длительность события
|
zc_data.duration | string |
Длительность события |
|
Уникальный идентификатор события
|
zc_data.uid | string |
Уникальный идентификатор события |
|
Событие всего дня
|
zc_data.isallday | boolean |
Является ли событие событием весь день |
|
Местоположение
|
zc_data.location | string |
Расположение события |
|
ETag
|
zc_data.etag | string |
Ссылается на тег события, чтобы определить режим, в котором было создано или изменено событие. |
|
Уникальный идентификатор календаря
|
zc_data.caluid | string |
Уникальный идентификатор календаря |
|
timezone
|
zc_data.dateandtime.timezone | string |
Часовой пояс события |
|
время начала
|
zc_data.dateandtime.start | string |
Время начала формата события yyyyMMddTHHmmss |
|
время окончания
|
zc_data.dateandtime.end | string |
Время окончания формата события yyMDdTHHmmss |
|
Последнее изменение события
|
zc_data.lastmodifiedtime | string |
Дата и время последнего изменения события |