Zoho-Kalender
Zoho Calendar ist ein Online-Geschäftskalender, der die Planung für Sie vereinfacht. Sie können es verwenden, um über Ihren Zeitplan zu bleiben und Kalender auch für Ihr Team freizugeben, um alle auf derselben Seite zu halten.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Zoho-Kalender |
| URL | https://www.zoho.com/calendar/contact.html |
| zmintegration@zohomail.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Zoho Mail |
| Webseite | https://www.zoho.com/calendar/ |
| Datenschutzrichtlinie | https://www.zoho.com/privacy.html |
| Kategorien | Zusammenarbeit; Produktivität |
Zoho-Kalender
Zoho Calendar ist ein Online-Geschäftskalender, der Ihre Planung mühelos macht. Zoho Calendar Connector bietet Ihnen die Möglichkeit, Ihren Kalender zu verwalten und sich wiederholende Aktionen wie Erstellen, Bearbeiten, Löschen von Ereignissen durch Erstellen von Workflows mithilfe des Aktionstriggermodells auszuführen.
Voraussetzungen
Ein bestätigtes Zoho-Kalenderkonto. Klicken Sie hier , um Ihr erstes Konto zu erstellen.
So erhalten Sie Anmeldeinformationen
Wenn Sie eine neue Verbindung erstellen,
- Wählen Sie die Domäne aus, in der Sich Ihr Zoho-Konto befindet.
- Geben Sie Ihre Zoho-Kalenderanmeldeinformationen ein.
- Auch wenn die Power-App für einen anderen Benutzer freigegeben wird, sollte sie eine neue Verbindung erstellen, um mit der Verwendung zu beginnen.
Die Zoho-Kalender-API verwendet OAuth2.0 zur Authentifizierung und daher ist keine sekundäre Authentifizierung erforderlich, nachdem das Konto eingerichtet wurde.
Erste Schritte mit Ihrem Connector
Führen Sie die folgenden Schritte aus, um eine Verbindung mit Zoho Calendar herzustellen:
- Melden Sie sich bei Ihrem Power Automate-Konto an, und klicken Sie im linken Menü auf "Erstellen".
- Sie können einen Cloudfluss, einen Desktopfluss oder einen Geschäftsfluss erstellen. Um eine Verbindung mit Zoho Calendar herzustellen, wählen Sie den automatisierten Cloudfluss aus.
- Sie können einen Fluss/eine Vorlage erstellen.
- Geben Sie die gewünschten Werte für die jeweilige Aktion ein.
Bekannte Probleme und Einschränkungen
- Recurring-Ereignisse werden derzeit im Connector nicht unterstützt.
Häufige Fehler und Abhilfemaßnahmen
- Um Authentifizierungsfehler zu vermeiden, wählen Sie die Domäne aus, in der Ihr Zoho-Kalenderkonto gehostet wird.
Häufig gestellte Fragen
https://www.zoho.com/calendar/help/getting-started.html
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Wählen Sie die Region aus, in der sich Ihre Zoho-Kontodaten befinden. | Schnur | Wählen Sie die Domäne aus. | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Ereignis abrufen |
Ruft die Details eines bestimmten Ereignisses ab, z. B. den Ereignistitel, das Startdatum, das Enddatum usw. aus dem angegebenen Kalender eines Benutzers. |
| Ereignis löschen |
Löscht ein Ereignis aus dem Kalender des Benutzers. |
| Ereignisliste abrufen |
Ruft die Liste aller Ereignisse zwischen dem angegebenen Datumsbereich im Format yyyy-MM-ddTHH:mm:sszzz ab. |
| Kalenderdetails abrufen |
Ruft die Details eines bestimmten Kalenders mithilfe der Kalender-UID ab. |
| Kalenderliste abrufen |
Ruft die Liste aller Kalender mit der Kalender-UID, dem Namen und der Zeitzone ab. |
| Neues Ereignis erstellen |
Fügt dem Kalender des Benutzers ein neues Ereignis hinzu. |
| Suchereignisse |
Ruft die Liste der Ereignisse in allen Kalendern ab. |
| Update-Ereignis |
Aktualisiert ein vorhandenes Ereignis im Kalender eines Benutzers. |
Ereignis abrufen
Ruft die Details eines bestimmten Ereignisses ab, z. B. den Ereignistitel, das Startdatum, das Enddatum usw. aus dem angegebenen Kalender eines Benutzers.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Geben Sie Kalender an, oder geben Sie die eindeutige ID des Kalenders ein. |
|
Event
|
euid | True | string |
Geben Sie die eindeutige ID des Ereignisses ein. |
Gibt zurück
- Body
- SingleEventRes
Ereignis löschen
Löscht ein Ereignis aus dem Kalender des Benutzers.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Geben Sie Kalender an, oder geben Sie die eindeutige ID des Kalenders ein. |
|
Event
|
euid | True | string |
Geben Sie die eindeutige ID des Ereignisses ein. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
events
|
events | array of object |
events |
|
uid
|
events.uid | string |
uid |
|
Recurrenceid
|
events.recurrenceid | string |
Recurrenceid |
Ereignisliste abrufen
Ruft die Liste aller Ereignisse zwischen dem angegebenen Datumsbereich im Format yyyy-MM-ddTHH:mm:sszzz ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Geben Sie Kalender an, oder geben Sie die eindeutige ID des Kalenders ein. |
|
Nach Instanz
|
byinstance | True | boolean |
Ruft alle Instanzen wiederholter Ereignisse als separates Ereignis ab, wenn es als true festgelegt wird. Der Datumsbereich darf 31 Tage nicht überschreiten. |
|
Startzeit
|
start | True | string |
Angeben der Startzeit im Format yyyy-MM-ddThh:mm:sszzz |
|
Endzeitpunkt
|
end | True | string |
Angeben der Endzeit im Format jjjj-MM-ddThh:mm:sszzz |
|
Timezone
|
timezone | string |
Angeben der Zeitzone des Ereignisses |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
events
|
events | array of SingleEventRes |
events |
Kalenderdetails abrufen
Ruft die Details eines bestimmten Kalenders mithilfe der Kalender-UID ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Geben Sie Kalender an, oder geben Sie die eindeutige ID des Kalenders ein. |
Gibt zurück
- Body
- SingleCalendarRes
Kalenderliste abrufen
Ruft die Liste aller Kalender mit der Kalender-UID, dem Namen und der Zeitzone ab.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
calendars
|
calendars | array of SingleCalendarRes |
calendars |
Neues Ereignis erstellen
Fügt dem Kalender des Benutzers ein neues Ereignis hinzu.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Geben Sie Kalender an, oder geben Sie die eindeutige ID des Kalenders ein. |
|
Title
|
title | True | string |
Angeben des Ereignistitels |
|
Startzeit
|
start | True | string |
Angeben der Startzeit des Ereignisses im Format yyyy-MM-ddTHH:mm:sszzz |
|
Endzeitpunkt
|
end | True | string |
Angeben der Endzeit des Ereignisses im Format yyyy-MM-ddTHH:mm:sszzz |
|
Timezone
|
timezone | string |
Angeben der Zeitzone des Ereignisses |
|
|
Farbe
|
color | string |
Wählen Sie die Ereignisfarbe aus, oder geben Sie den Hexadezimalwert der Farbe an. |
|
|
Description
|
description | string |
Angeben der Beschreibung des Ereignisses |
|
|
Standort
|
location | string |
Angeben des Orts des Ereignisses |
|
|
URL
|
url | string |
Angeben der URL des Ereignisses |
|
|
Privat
|
isprivate | boolean |
Geben Sie an, ob das Ereignis privat ist oder nicht. |
|
|
Ist ganztäglich
|
isallday | boolean |
Geben Sie an, ob das Ereignis ein ganztägiges Ereignis ist. |
|
|
E-Mail-ID
|
string |
Angeben der E-Mail-Adressen der Teilnehmer |
||
|
Transparenz
|
transparency | integer |
Geben Sie an, ob das Ereignis ihrem Frei/Gebucht-Zeitplan hinzugefügt werden soll. |
|
|
Weiterleiten zulassen
|
allowForwarding | boolean |
Geben Sie an, ob das Ereignis weitergeleitet werden kann oder nicht |
|
|
type
|
action | string |
Angeben des Ereigniserinnerungstyps (E-Mail, Benachrichtigungen usw.) |
|
|
in Minuten
|
minutes | integer |
Geben Sie die Zeit an, um Sie vor oder nach dem Ereignis zu erinnern (z. B.: - 5 für vorher, 5 für nachher) |
Gibt zurück
- Body
- SingleEventRes
Suchereignisse
Ruft die Liste der Ereignisse in allen Kalendern ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Geben Sie Kalender an, oder geben Sie die eindeutige ID des Kalenders ein. |
|
Startzeit
|
start | True | string |
Geben Sie die Startzeit des Ereignisses im Format yyyy-MM-ddTHH:mm:sszzz an. |
|
Endzeitpunkt
|
end | string |
Geben Sie die Endzeit des Ereignisses im Format yyyy-MM-ddTHH:mm:sszzz an. |
|
|
Suchtext
|
searchtext | string |
Geben Sie an, nach der im Titel gesucht werden soll |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
search
|
search | array of object |
search |
|
Eindeutige Ereignis-ID
|
search.uid | string |
Eindeutiger Bezeichner des Ereignisses |
|
Ist ganztägiges Ereignis
|
search.isallday | boolean |
Gibt an, ob es sich bei dem Ereignis um ein ganztägiges Ereignis handelt. |
|
Eindeutige Kalender-ID
|
search.caluid | string |
Eindeutiger Bezeichner des Kalenders |
|
Title
|
search.title | string |
Titel des Ereignisses |
|
type
|
search.type | integer |
type |
|
Timezone
|
search.dateandtime.timezone | string |
Zeitzone des Ereignisses |
|
Startzeit
|
search.dateandtime.start | string |
Startzeit des Ereignisses |
|
Endzeit
|
search.dateandtime.end | string |
Endzeit des Ereignisses |
Update-Ereignis
Aktualisiert ein vorhandenes Ereignis im Kalender eines Benutzers.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Geben Sie Kalender an, oder geben Sie die eindeutige ID des Kalenders ein. |
|
Event
|
euid | True | string |
Geben Sie die eindeutige ID des Ereignisses ein. |
|
Title
|
title | True | string |
Angeben des Ereignistitels |
|
Startzeit
|
start | True | string |
Angeben der Startzeit des Ereignisses im Format yyyy-MM-ddTHH:mm:sszzz |
|
Endzeitpunkt
|
end | True | string |
Angeben der Endzeit des Ereignisses im Format yyyy-MM-ddTHH:mm:sszzz |
|
Timezone
|
timezone | string |
Angeben der Zeitzone des Ereignisses |
|
|
Farbe
|
color | string |
Wählen Sie die Ereignisfarbe aus, oder geben Sie den Hexadezimalwert der Farbe an. |
|
|
Description
|
description | string |
Angeben der Beschreibung des Ereignisses |
|
|
Standort
|
location | string |
Angeben des Orts des Ereignisses |
|
|
URL
|
url | string |
Angeben der URL des Ereignisses |
|
|
Privat
|
isprivate | boolean |
Geben Sie an, ob das Ereignis privat ist oder nicht. |
|
|
Ist ganztäglich
|
isallday | boolean |
Geben Sie an, ob das Ereignis ein ganztägiges Ereignis ist. |
|
|
E-Mail-ID
|
string |
Angeben der E-Mail-Adressen der Teilnehmer |
||
|
Transparenz
|
transparency | integer |
Geben Sie an, ob das Ereignis ihrem Frei/Gebucht-Zeitplan hinzugefügt werden soll. |
|
|
Weiterleiten zulassen
|
allowForwarding | boolean |
Geben Sie an, ob das Ereignis weitergeleitet werden kann oder nicht |
|
|
type
|
action | string |
Angeben des Ereigniserinnerungstyps (E-Mail, Benachrichtigungen usw.) |
|
|
in Minuten
|
minutes | integer |
Geben Sie die Zeit an, um Sie vor oder nach dem Ereignis zu erinnern (z. B.: - 5 für vorher, 5 für nachher) |
Gibt zurück
- Body
- SingleEventRes
Auslöser
| Ereignisbenachrichtigung bearbeiten |
Wenn ein Ereignis in einen Kalender aktualisiert wird |
| Ereignisbenachrichtigung löschen |
Wenn ein Ereignis in einem Kalender gelöscht wird |
| Neue Ereignisbenachrichtigung |
Wenn einem Kalender ein Ereignis hinzugefügt wird |
Ereignisbenachrichtigung bearbeiten
Ereignisbenachrichtigung löschen
Wenn ein Ereignis in einem Kalender gelöscht wird
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Eindeutige Ereignis-ID
|
zc_data.uid | string |
Eindeutiger Bezeichner des Ereignisses |
|
Eindeutige Kalender-ID
|
zc_data.caluid | string |
Eindeutiger Bezeichner des Kalenders |
Neue Ereignisbenachrichtigung
Definitionen
SingleEventRes
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Farbe
|
color | string |
Ereignisfarbwert in hexadezimaler Zahl |
|
Title
|
title | string |
Titel des Ereignisses |
|
Dauer
|
duration | string |
Dauer des Ereignisses |
|
Eindeutige Ereignis-ID
|
uid | string |
Eindeutiger Bezeichner des Ereignisses |
|
Ereignis erstellt von
|
createdby | string |
Der Benutzer, der das Ereignis erstellt hat |
|
Genehmigt
|
isApproved | boolean |
Gibt an, ob das erstellte Ereignis genehmigt wurde. |
|
Standort
|
location | string |
Der Ort des Ereignisses |
|
URL
|
url | string |
Die URL des Ereignisses |
|
Ereignisansichts-URL
|
viewEventURL | string |
Die eindeutige URL des Ereignisses. |
|
timezone
|
dateandtime.timezone | string |
Zeitzone des Ereignisses |
|
Startzeit
|
dateandtime.start | string |
Startzeit des Ereignisses |
|
Endzeit
|
dateandtime.end | string |
Endzeit des Ereignisses |
|
Ereignis zuletzt geändert am
|
lastmodifiedtime | string |
Datum und Uhrzeit der letzten Änderung des Ereignisses am |
|
Ist privat
|
isprivate | boolean |
Gibt an, ob es sich bei dem Ereignis um ein privates Ereignis handelt oder nicht. |
|
Teilnehmer
|
attendees | array of object |
Teilnehmer des Ereignisses |
|
Anzeigename
|
attendees.dName | string |
Anzeigen von Namen von Teilnehmern |
|
E-Mail-ID
|
attendees.email | string |
Die E-Mail-Adressen der Teilnehmer. |
|
Attendence
|
attendees.attendance | integer |
Ob die Teilnahme obligatorisch, optional oder nicht erforderlich ist. |
|
status
|
attendees.status | string |
Bezieht sich auf den Status der Teilnehmer (Angenommen/Abgelehnt/Mit Vorbehalt/Bedarfsaktion) |
|
Erstellt am
|
createdtime_millis | string |
Die Ereigniserstellungszeit in GMT |
|
Benachrichtigungstyp
|
notifyType | integer |
Benachrichtigt Die Teilnehmer basierend auf ihrer Standardeinstellung für Benachrichtigungen über das Ereignis. |
|
Für Organisation zuständige Person
|
organizer | string |
Details des Ereignisorganisators. |
|
Ist ganztägiges Ereignis
|
isallday | boolean |
Gibt an, ob es sich bei dem Ereignis um ein ganztägiges Ereignis handelt. |
|
Transparenz
|
transparency | integer |
Gibt an, ob das Ereignis dem Frei/Gebucht-Zeitplan hinzugefügt werden soll. |
|
Geändert von
|
modifiedby | string |
Verweist auf den Benutzer, der das Ereignis geändert hat. |
|
Ereignistag
|
etag | string |
Verweist auf das Ereignistag, um den Modus zu identifizieren, in dem das Ereignis erstellt/geändert wurde. |
|
Eindeutige Kalender-ID
|
caluid | string |
Eindeutiger Bezeichner des Kalenders |
|
Weiterleitung zulassen
|
allowForwarding | boolean |
Gibt an, ob das Ereignis weitergeleitet werden kann. |
|
Erinnerungen
|
reminders | array of object | |
|
Erinnerungstyp
|
reminders.action | string |
Bezieht sich auf den Ereigniserinnerungstyp (E-Mail, Benachrichtigung, Popup.) |
|
Erinnern sie mich in
|
reminders.minutes | string |
Bezieht sich auf die Erinnerungszeit in Minuten. |
SingleCalendarRes
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Farbe
|
color | string |
Kalenderfarbwert im Hexadezimalwert |
|
Timezone
|
timezone | string |
Zeitzone des Kalenders |
|
Textfarbe
|
textcolor | string |
Kalendertextfarbe in hexadezimaler Farbe |
|
Description
|
description | string |
die Beschreibung des Kalenders |
|
Eindeutige Kalender-ID
|
uid | string |
Eindeutiger Bezeichner des Kalenders |
|
Ist Standard
|
isdefault | boolean |
Gibt an, ob es sich bei dem Kalender um einen Standardkalender handelt. |
|
Frei/Gebucht einschließen
|
include_infreebusy | boolean |
Frei/Gebucht-Status des Kalenders |
|
Name
|
name | string |
Name des Kalenders |
|
Der Status
|
status | boolean |
Status des Kalenders |
EventNotifyRes
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Farbe
|
zc_data.color | string |
Ereignisfarbwert in hexadezimaler Zahl |
|
Title
|
zc_data.title | string |
Titel des Ereignisses |
|
Erstellt am
|
zc_data.createdtime | string |
Erstellungszeit des Ereignisses |
|
Zeitzone des Benutzers
|
zc_data.user_timezone | string |
Zeitzone des Benutzers |
|
Ereignisdauer
|
zc_data.duration | string |
Dauer des Ereignisses |
|
Eindeutige Ereignis-ID
|
zc_data.uid | string |
Eindeutiger Bezeichner des Ereignisses |
|
Ist ganztägiges Ereignis
|
zc_data.isallday | boolean |
Gibt an, ob es sich bei dem Ereignis um ein ganztägiges Ereignis handelt. |
|
Standort
|
zc_data.location | string |
Ort des Ereignisses |
|
etag
|
zc_data.etag | string |
Verweist auf das Ereignistag, um den Modus zu identifizieren, in dem das Ereignis erstellt/geändert wurde. |
|
Eindeutige Kalender-ID
|
zc_data.caluid | string |
Eindeutiger Bezeichner des Kalenders |
|
timezone
|
zc_data.dateandtime.timezone | string |
Zeitzone des Ereignisses |
|
Startzeit
|
zc_data.dateandtime.start | string |
Startzeit des Ereignisformats yyyyMdDTHHmmss |
|
Endzeit
|
zc_data.dateandtime.end | string |
Endzeit des Ereignisformats yyyyMdDTHHmmss |
|
Ereignis zuletzt geändert am
|
zc_data.lastmodifiedtime | string |
Datum und Uhrzeit der letzten Änderung des Ereignisses am |