Kalendarz Zoho
Kalendarz Zoho to kalendarz biznesowy online, który ułatwia planowanie. Możesz go użyć, aby pozostać na bieżąco z harmonogramem, a także udostępniać kalendarze zespołowi, aby zachować wszystkich na tej samej stronie.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Kalendarz Zoho |
| adres URL | https://www.zoho.com/calendar/contact.html |
| zmintegration@zohomail.com |
| Metadane łącznika | |
|---|---|
| Publisher | Poczta Zoho |
| Witryna internetowa | https://www.zoho.com/calendar/ |
| Zasady ochrony prywatności | https://www.zoho.com/privacy.html |
| Kategorie | Kolaboracja; Produktywność |
Kalendarz Zoho
Kalendarz Zoho to kalendarz biznesowy online, który sprawia, że planowanie jest łatwe. Łącznik Zoho Calendar umożliwia zarządzanie kalendarzem i wykonywanie powtarzających się akcji, takich jak tworzenie, edytowanie, usuwanie zdarzenia przez tworzenie przepływów pracy przy użyciu modelu wyzwalacza akcji.
Wymagania wstępne
Zweryfikowane konto kalendarza Zoho. Kliknij tutaj , aby utworzyć pierwsze konto.
Jak uzyskać poświadczenia
Podczas tworzenia nowego połączenia,
- Wybierz domenę, w której znajduje się konto Zoho.
- Wprowadź poświadczenia kalendarza Zoho.
- Nawet jeśli aplikacja power jest udostępniana innemu użytkownikowi, powinien utworzyć nowe połączenie, aby rozpocząć korzystanie z niej.
Interfejs API kalendarza Zoho używa protokołu OAuth2.0 do uwierzytelniania, dlatego po skonfigurowaniu konta nie jest wymagane żadne uwierzytelnianie pomocnicze.
Wprowadzenie do łącznika
Wykonaj poniższe kroki, aby nawiązać połączenie z kalendarzem Zoho:
- Zaloguj się do konta usługi Power Automate i kliknij pozycję Utwórz z menu po lewej stronie.
- Możesz utworzyć przepływ w chmurze, przepływ pulpitu lub przepływ biznesowy. Aby nawiązać połączenie z kalendarzem Zoho, wybierz zautomatyzowany przepływ chmury.
- Możesz utworzyć przepływ/szablon.
- Wprowadź żądane wartości odpowiedniej akcji.
Znane problemy i ograniczenia
- Obecnie zdarzenia cykliczne nie są obsługiwane w łączniku.
Typowe błędy i środki zaradcze
- Aby uniknąć błędów uwierzytelniania, wybierz domenę, w której jest hostowane konto kalendarza Zoho.
Często zadawane pytania
https://www.zoho.com/calendar/help/getting-started.html
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Wybierz region, w którym znajdują się dane konta Zoho. | ciąg | Wybierz domenę. | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Pobieranie listy kalendarzy |
Pobiera listę wszystkich kalendarzy z identyfikatorem UID kalendarza, nazwą i strefą czasową. |
| Pobieranie listy zdarzeń |
Pobiera listę wszystkich zdarzeń między określonym zakresem dat w formacie rrrr-MM-ddTHH:mm:sszzz. |
| Pobieranie szczegółów kalendarza |
pobiera szczegóły określonego kalendarza przy użyciu identyfikatora UID kalendarza. |
| Pobieranie zdarzenia |
Pobiera szczegóły określonego zdarzenia, takie jak tytuł zdarzenia, data rozpoczęcia, data zakończenia itp., z określonego kalendarza użytkownika. |
| Tworzenie nowego zdarzenia |
Dodaje nowe zdarzenie do kalendarza użytkownika. |
| Usuń zdarzenie |
Usuwa zdarzenie z kalendarza użytkownika. |
| Zdarzenia wyszukiwania |
Pobiera listę zdarzeń we wszystkich kalendarzach. |
| Zdarzenie aktualizacji |
Aktualizuje istniejące zdarzenie w kalendarzu użytkownika. |
Pobieranie listy kalendarzy
Pobiera listę wszystkich kalendarzy z identyfikatorem UID kalendarza, nazwą i strefą czasową.
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Kalendarze
|
calendars | array of SingleCalendarRes |
Kalendarze |
Pobieranie listy zdarzeń
Pobiera listę wszystkich zdarzeń między określonym zakresem dat w formacie rrrr-MM-ddTHH:mm:sszzz.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Kalendarz
|
cuid | True | string |
Określ kalendarz lub wprowadź unikatowy identyfikator kalendarza. |
|
Według wystąpienia
|
byinstance | True | boolean |
Pobiera wszystkie wystąpienia zdarzeń powtórzenia jako oddzielne zdarzenie, gdy jest ono ustawione jako true. Zakres dat nie powinien przekraczać 31 dni. |
|
Godzina rozpoczęcia
|
start | True | string |
Określ godzinę rozpoczęcia w formacie rrrr-MM-ddThh:mm:sszzz |
|
Godzina zakończenia
|
end | True | string |
Określ godzinę zakończenia w formacie rrrr-MM-ddThh:mm:sszzz |
|
Timezone
|
timezone | string |
Określanie strefy czasowej zdarzenia |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
events
|
events | array of SingleEventRes |
events |
Pobieranie szczegółów kalendarza
pobiera szczegóły określonego kalendarza przy użyciu identyfikatora UID kalendarza.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Kalendarz
|
cuid | True | string |
Określ kalendarz lub wprowadź unikatowy identyfikator kalendarza. |
Zwraca
- Body
- SingleCalendarRes
Pobieranie zdarzenia
Pobiera szczegóły określonego zdarzenia, takie jak tytuł zdarzenia, data rozpoczęcia, data zakończenia itp., z określonego kalendarza użytkownika.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Kalendarz
|
cuid | True | string |
Określ kalendarz lub wprowadź unikatowy identyfikator kalendarza. |
|
Event
|
euid | True | string |
Wprowadź unikatowy identyfikator zdarzenia. |
Zwraca
- Body
- SingleEventRes
Tworzenie nowego zdarzenia
Dodaje nowe zdarzenie do kalendarza użytkownika.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Kalendarz
|
cuid | True | string |
Określ kalendarz lub wprowadź unikatowy identyfikator kalendarza. |
|
Title
|
title | True | string |
Określanie tytułu zdarzenia |
|
Godzina rozpoczęcia
|
start | True | string |
Określ godzinę rozpoczęcia zdarzenia w formacie rrrr-MM-ddTHH:mm:sszzz |
|
Godzina zakończenia
|
end | True | string |
Określ godzinę zakończenia zdarzenia w formacie rrrr-MM-ddTHH:mm:sszzz |
|
Timezone
|
timezone | string |
Określanie strefy czasowej zdarzenia |
|
|
Kolor
|
color | string |
Wybierz kolor zdarzenia lub określ wartość szesnastkowa koloru |
|
|
Description
|
description | string |
Określ opis zdarzenia |
|
|
Lokalizacja
|
location | string |
Określanie lokalizacji zdarzenia |
|
|
adres URL
|
url | string |
Określ adres URL zdarzenia |
|
|
Prywatne
|
isprivate | boolean |
Określ, czy zdarzenie jest prywatne, czy nie |
|
|
Jest cały dzień
|
isallday | boolean |
Określ, czy wydarzenie jest wydarzeniem całodzieniowym. |
|
|
identyfikator poczty e-mail
|
string |
Określanie adresów e-mail uczestników |
||
|
Przezroczystość
|
transparency | integer |
Określ, czy zdarzenie powinno zostać dodane do harmonogramu wolny/zajęty. |
|
|
Zezwalaj na przesyłanie dalej
|
allowForwarding | boolean |
Określ, czy zdarzenie może być przekazywane, czy nie |
|
|
typ
|
action | string |
Określ typ przypomnienia o zdarzeniu (wiadomość e-mail, powiadomienia itp.) |
|
|
w minutach
|
minutes | integer |
Określ godzinę przypomnienia przed lub po zdarzeniu (np. - 5 dla przed, 5 dla po) |
Zwraca
- Body
- SingleEventRes
Usuń zdarzenie
Usuwa zdarzenie z kalendarza użytkownika.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Kalendarz
|
cuid | True | string |
Określ kalendarz lub wprowadź unikatowy identyfikator kalendarza. |
|
Event
|
euid | True | string |
Wprowadź unikatowy identyfikator zdarzenia. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
events
|
events | array of object |
events |
|
uid
|
events.uid | string |
uid |
|
identyfikator cyklu
|
events.recurrenceid | string |
identyfikator cyklu |
Zdarzenia wyszukiwania
Pobiera listę zdarzeń we wszystkich kalendarzach.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Kalendarz
|
cuid | True | string |
Określ kalendarz lub wprowadź unikatowy identyfikator kalendarza. |
|
Godzina rozpoczęcia
|
start | True | string |
Określ czas rozpoczęcia zdarzenia w formacie rrrr-MM-ddTHH:mm:sszzz. |
|
Godzina zakończenia
|
end | string |
Określ czas zakończenia zdarzenia w formacie rrrr-MM-ddTHH:mm:sszzz. |
|
|
Tekst wyszukiwania
|
searchtext | string |
Określ należy wyszukać w tytule |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
wyszukać
|
search | array of object |
wyszukać |
|
Unikatowy identyfikator zdarzenia
|
search.uid | string |
Unikatowy identyfikator zdarzenia |
|
Jest wydarzeniem całodzieniowym
|
search.isallday | boolean |
Czy wydarzenie jest wydarzeniem całodzieniowym |
|
Unikatowy identyfikator kalendarza
|
search.caluid | string |
Unikatowy identyfikator kalendarza |
|
Title
|
search.title | string |
Tytuł zdarzenia |
|
typ
|
search.type | integer |
typ |
|
Timezone
|
search.dateandtime.timezone | string |
strefa czasowa zdarzenia |
|
godzina rozpoczęcia
|
search.dateandtime.start | string |
Godzina rozpoczęcia zdarzenia |
|
godzina zakończenia
|
search.dateandtime.end | string |
Godzina zakończenia zdarzenia |
Zdarzenie aktualizacji
Aktualizuje istniejące zdarzenie w kalendarzu użytkownika.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Kalendarz
|
cuid | True | string |
Określ kalendarz lub wprowadź unikatowy identyfikator kalendarza. |
|
Event
|
euid | True | string |
Wprowadź unikatowy identyfikator zdarzenia. |
|
Title
|
title | True | string |
Określanie tytułu zdarzenia |
|
Godzina rozpoczęcia
|
start | True | string |
Określ godzinę rozpoczęcia zdarzenia w formacie rrrr-MM-ddTHH:mm:sszzz |
|
Godzina zakończenia
|
end | True | string |
Określ godzinę zakończenia zdarzenia w formacie rrrr-MM-ddTHH:mm:sszzz |
|
Timezone
|
timezone | string |
Określanie strefy czasowej zdarzenia |
|
|
Kolor
|
color | string |
Wybierz kolor zdarzenia lub określ wartość szesnastkowa koloru |
|
|
Description
|
description | string |
Określ opis zdarzenia |
|
|
Lokalizacja
|
location | string |
Określanie lokalizacji zdarzenia |
|
|
adres URL
|
url | string |
Określ adres URL zdarzenia |
|
|
Prywatne
|
isprivate | boolean |
Określ, czy zdarzenie jest prywatne, czy nie |
|
|
Jest cały dzień
|
isallday | boolean |
Określ, czy wydarzenie jest wydarzeniem całodzieniowym. |
|
|
identyfikator poczty e-mail
|
string |
Określanie adresów e-mail uczestników |
||
|
Przezroczystość
|
transparency | integer |
Określ, czy zdarzenie powinno zostać dodane do harmonogramu wolny/zajęty. |
|
|
Zezwalaj na przesyłanie dalej
|
allowForwarding | boolean |
Określ, czy zdarzenie może być przekazywane, czy nie |
|
|
typ
|
action | string |
Określ typ przypomnienia o zdarzeniu (wiadomość e-mail, powiadomienia itp.) |
|
|
w minutach
|
minutes | integer |
Określ godzinę przypomnienia przed lub po zdarzeniu (np. - 5 dla przed, 5 dla po) |
Zwraca
- Body
- SingleEventRes
Wyzwalacze
| Edytowanie powiadomienia o zdarzeniu |
Po zaktualizowaniu zdarzenia do kalendarza |
| Powiadomienie o nowym zdarzeniu |
Po dodaniu zdarzenia do kalendarza |
| Usuwanie powiadomienia o zdarzeniu |
Gdy zdarzenie zostanie usunięte w kalendarzu |
Edytowanie powiadomienia o zdarzeniu
Powiadomienie o nowym zdarzeniu
Usuwanie powiadomienia o zdarzeniu
Gdy zdarzenie zostanie usunięte w kalendarzu
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Unikatowy identyfikator zdarzenia
|
zc_data.uid | string |
Unikatowy identyfikator zdarzenia |
|
Unikatowy identyfikator kalendarza
|
zc_data.caluid | string |
Unikatowy identyfikator kalendarza |
Definicje
SingleEventRes
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Kolor
|
color | string |
Wartość koloru zdarzenia w szesnastkowym |
|
Title
|
title | string |
Tytuł zdarzenia |
|
Czas trwania
|
duration | string |
Czas trwania zdarzenia |
|
Unikatowy identyfikator zdarzenia
|
uid | string |
Unikatowy identyfikator zdarzenia |
|
Zdarzenie utworzone przez
|
createdby | string |
Użytkownik, który utworzył zdarzenie |
|
Jest zatwierdzony
|
isApproved | boolean |
Czy utworzone zdarzenie jest zatwierdzone. |
|
Lokalizacja
|
location | string |
Lokalizacja zdarzenia |
|
adres URL
|
url | string |
Adres URL zdarzenia |
|
Adres URL widoku zdarzeń
|
viewEventURL | string |
Unikatowy adres URL zdarzenia. |
|
timezone
|
dateandtime.timezone | string |
Strefa czasowa zdarzenia |
|
godzina rozpoczęcia
|
dateandtime.start | string |
Godzina rozpoczęcia zdarzenia |
|
godzina zakończenia
|
dateandtime.end | string |
Godzina zakończenia zdarzenia |
|
Zdarzenie ostatnio zmodyfikowane w dniu
|
lastmodifiedtime | string |
Data i godzina ostatniej modyfikacji zdarzenia |
|
Jest prywatny
|
isprivate | boolean |
Czy zdarzenie jest wydarzeniem prywatnym, czy nie |
|
Uczestników
|
attendees | array of object |
Uczestnicy wydarzenia |
|
nazwa wyświetlana
|
attendees.dName | string |
Wyświetlane nazwy uczestników |
|
identyfikator poczty e-mail
|
attendees.email | string |
Adresy e-mail uczestników. |
|
uczestnictwo
|
attendees.attendance | integer |
Niezależnie od tego, czy frekwencja jest obowiązkowa, opcjonalna, czy nie jest wymagana. |
|
stan
|
attendees.status | string |
Odwołuje się do stanu uczestników (zaakceptowane/odrzucone/wstępne/wymaga działania) |
|
Utworzono:
|
createdtime_millis | string |
Czas tworzenia zdarzenia w GMT |
|
Typ powiadomienia
|
notifyType | integer |
Powiadamia uczestników o wydarzeniu na podstawie domyślnych preferencji powiadomień. |
|
Organizator
|
organizer | string |
Szczegóły organizatora wydarzenia. |
|
Jest wydarzeniem całodzieniowym
|
isallday | boolean |
Czy wydarzenie jest wydarzeniem całodzieniowym |
|
Przezroczystość
|
transparency | integer |
Czy zdarzenie powinno zostać dodane do harmonogramu wolny/zajęty |
|
Zmodyfikowany przez
|
modifiedby | string |
Odwołuje się do użytkownika, który zmodyfikował zdarzenie. |
|
Tag zdarzenia
|
etag | string |
Odwołuje się do tagu zdarzenia, aby zidentyfikować tryb, w którym zdarzenie zostało utworzone/zmodyfikowane. |
|
Unikatowy identyfikator kalendarza
|
caluid | string |
Unikatowy identyfikator kalendarza |
|
Zezwalaj na przekazywanie dalej
|
allowForwarding | boolean |
Niezależnie od tego, czy zdarzenie może być przekazywane, czy nie. |
|
Przypomnienia
|
reminders | array of object | |
|
Typ przypomnienia
|
reminders.action | string |
Odwołuje się do typu przypomnienia o zdarzeniu (poczta, powiadomienie, wyskakujące okienko). |
|
Przypomnij mi
|
reminders.minutes | string |
Odnosi się do czasu przypomnienia w minutach. |
SingleCalendarRes
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Kolor
|
color | string |
Wartość koloru kalendarza w szesnastkowym |
|
Timezone
|
timezone | string |
Strefa czasowa kalendarza |
|
Kolor tekstu
|
textcolor | string |
Kolor tekstu kalendarza w szesnastkowym |
|
Description
|
description | string |
opis kalendarza |
|
Unikatowy identyfikator kalendarza
|
uid | string |
Unikatowy identyfikator kalendarza |
|
Jest domyślne
|
isdefault | boolean |
Czy kalendarz jest kalendarzem domyślnym |
|
Uwzględnij wolne/zajęte
|
include_infreebusy | boolean |
Stan Wolny/Zajęty kalendarza |
|
Name
|
name | string |
nazwa kalendarza |
|
Status
|
status | boolean |
Stan kalendarza |
EventNotifyRes
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Kolor
|
zc_data.color | string |
Wartość koloru zdarzenia w szesnastkowym |
|
Title
|
zc_data.title | string |
Tytuł zdarzenia |
|
Utworzono:
|
zc_data.createdtime | string |
godzina utworzenia zdarzenia |
|
Strefa czasowa użytkownika
|
zc_data.user_timezone | string |
Strefa czasowa użytkownika |
|
Czas trwania zdarzenia
|
zc_data.duration | string |
Czas trwania zdarzenia |
|
Unikatowy identyfikator zdarzenia
|
zc_data.uid | string |
Unikatowy identyfikator zdarzenia |
|
Jest wydarzeniem całodzieniowym
|
zc_data.isallday | boolean |
Czy wydarzenie jest wydarzeniem całodzieniowym |
|
Lokalizacja
|
zc_data.location | string |
Lokalizacja zdarzenia |
|
etag
|
zc_data.etag | string |
Odwołuje się do tagu zdarzenia, aby zidentyfikować tryb, w którym zdarzenie zostało utworzone/zmodyfikowane. |
|
Unikatowy identyfikator kalendarza
|
zc_data.caluid | string |
Unikatowy identyfikator kalendarza |
|
timezone
|
zc_data.dateandtime.timezone | string |
Strefa czasowa zdarzenia |
|
godzina rozpoczęcia
|
zc_data.dateandtime.start | string |
Godzina rozpoczęcia formatu zdarzenia rrrrMddTHHmmss |
|
godzina zakończenia
|
zc_data.dateandtime.end | string |
Godzina zakończenia formatu zdarzenia rrrrMddTHHmmss |
|
Zdarzenie ostatnio zmodyfikowane w dniu
|
zc_data.lastmodifiedtime | string |
Data i godzina ostatniej modyfikacji zdarzenia |