Zoho Calendar (プレビュー)
Zoho Calendar は、スケジュールを簡単に作成できるオンライン ビジネス カレンダーです。 これを使用してスケジュールを常に把握し、チームとカレンダーを共有して全員が同じ認識を保つことができます。
このコネクタは、次の製品および地域で利用可能です:
| サービス | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | Zoho Calendar |
| [URL] | https://www.zoho.com/calendar/contact.html |
| メール | zmintegration@zohomail.com |
| Connector Metadata | |
|---|---|
| 発行者 | Zoho Mail |
| Web サイト | https://www.zoho.com/calendar/ |
| プライバシー ポリシー | https://www.zoho.com/privacy.html |
| カテゴリー | コラボレーション、生産性 |
Zoho Calendar
Zoho カレンダーは、スケジュール管理を簡単にするオンライン ビジネス カレンダーです。 Zoho Calendar コネクタを使用すると、アクション トリガー モデルを使用してワークフローを作成することで、カレンダーを管理し、イベントの作成、編集、削除などの反復的なアクションを実行できます。
前提条件
認証済みの Zoho Calendar アカウント。 ここ をクリックして、最初のアカウントを作成します。
資格情報の入手方法
新しい接続を作成する場合、
- Zoho アカウントが存在するドメインを選択します。
- Zoho Calendar の認証情報を入力します。
- Power App が別のユーザーと共有されていても、新しい接続を作成して使用し始める必要があります。
Zoho Calendar API は認証に OAuth2.0 を使用するため、アカウントの設定後に二次認証は必要ありません。
コネクタの使用を開始する
以下の手順に従って、Zoho Calendar に接続します:
- Power Automate アカウントにログインし、左側のメニューから [作成] をクリックします。
- クラウド フロー、デスクトップ フロー、または ビジネス フローの作成を選択できます。 Zoho Calendar に接続するには、自動化されたクラウド フローを選択します。
- フロー/テンプレートを作成できます。
- それぞれのアクションに必要な値を入力します。
既知の問題と制限事項
- 現在、定期イベントはコネクタでサポートされていません。
一般的なエラーと解決策
- 認証エラーを回避するには、Zoho Calendar アカウントがホストされているドメインを選択してください。
よくあるご質問
https://www.zoho.com/calendar/help/getting-started.html
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | Description | Required |
|---|---|---|---|
| Zoho アカウント データが存在するリージョンを選択します。 | string | ドメインを選択します。 | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| イベント リストを取得する |
指定した期間内のすべてのイベントのリストを yyyy-MM-ddTHH:mm:sszzz 形式で取得します。 |
| イベントの削除 |
ユーザーのカレンダーからイベントを削除します。 |
| イベントの取得 |
ユーザーの指定したカレンダーから、イベントのタイトル、開始日、終了日などの特定のイベントの詳細を取得します。 |
| イベントを更新する |
ユーザーのカレンダーの既存イベントが更新されます。 |
| カレンダーのリストを取得する |
カレンダー UID、名前、タイムゾーンを含むすべてのカレンダーのリストを取得します。 |
| カレンダーの詳細の取得 |
カレンダー UID を使用して特定のカレンダーの詳細を取得します。 |
| 新しいイベントを作成する |
ユーザーのカレンダーに新しイベントを追加します。 |
| 検索イベント |
すべてのカレンダーのイベントのリストを取得します。 |
イベント リストを取得する
指定した期間内のすべてのイベントのリストを yyyy-MM-ddTHH:mm:sszzz 形式で取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
カレンダーを指定するか、カレンダーの一意の ID を入力します。 |
|
インスタンス別
|
byinstance | True | boolean |
true に設定されている場合、繰り返しイベントのすべてのインスタンスを個別のイベントとして取得します。 期間は 31 日を超えてはいけません。 |
|
開始時刻
|
start | True | string |
開始時刻を yyyy-MM-ddThh:mm:sszzz の形式で指定します |
|
終了時刻
|
end | True | string |
終了時刻を yyyy-MM-ddThh:mm:sszzz の形式で指定します |
|
Timezone
|
timezone | string |
イベントのタイムゾーンを指定する |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
events
|
events | array of SingleEventRes |
events |
イベントの削除
ユーザーのカレンダーからイベントを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
カレンダーを指定するか、カレンダーの一意の ID を入力します。 |
|
イベント
|
euid | True | string |
イベントの一意の id を入力します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
events
|
events | array of object |
events |
|
uid
|
events.uid | string |
uid |
|
繰り返し
|
events.recurrenceid | string |
繰り返し |
イベントの取得
ユーザーの指定したカレンダーから、イベントのタイトル、開始日、終了日などの特定のイベントの詳細を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
カレンダーを指定するか、カレンダーの一意の ID を入力します。 |
|
イベント
|
euid | True | string |
イベントの一意の id を入力します。 |
戻り値
- Body
- SingleEventRes
イベントを更新する
ユーザーのカレンダーの既存イベントが更新されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
カレンダーを指定するか、カレンダーの一意の ID を入力します。 |
|
イベント
|
euid | True | string |
イベントの一意の id を入力します。 |
|
肩書き
|
title | True | string |
イベントのタイトルを指定します。 |
|
開始時刻
|
start | True | string |
イベントの開始時刻を yyyy-MM-ddTHH:mm:sszzz の形式で指定します。 |
|
終了時刻
|
end | True | string |
イベントの終了時刻を yyyy-MM-ddTHH:mm:sszzz の形式で指定します。 |
|
Timezone
|
timezone | string |
イベントのタイムゾーンを指定する |
|
|
カラー
|
color | string |
イベントの色を選択するか、色の 16 進値を指定します |
|
|
Description
|
description | string |
イベントの説明を指定します |
|
|
場所
|
location | string |
イベントの場所を指定 |
|
|
[URL]
|
url | string |
イベントの URL を指定します |
|
|
Private
|
isprivate | boolean |
イベントが非公開かどうかを指定します |
|
|
終日である
|
isallday | boolean |
イベントが終日イベントであるかを指定します。 |
|
|
メール ID
|
string |
出席者の電子メール アドレスを指定する |
||
|
Transparency
|
transparency | integer |
イベントを空き時間スケジュールに追加するかどうかを指定します。 |
|
|
転送を許可する
|
allowForwarding | boolean |
イベントを転送できるかどうかを指定します |
|
|
タイプ
|
action | string |
イベントリマインダーのタイプ (電子メール、通知など) を指定します |
|
|
分単位
|
minutes | integer |
イベントの前後にリマインドする時間を指定します (例: 前は 5、後は 5) |
戻り値
- Body
- SingleEventRes
カレンダーのリストを取得する
カレンダー UID、名前、タイムゾーンを含むすべてのカレンダーのリストを取得します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
calendars
|
calendars | array of SingleCalendarRes |
calendars |
カレンダーの詳細の取得
カレンダー UID を使用して特定のカレンダーの詳細を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
カレンダーを指定するか、カレンダーの一意の ID を入力します。 |
戻り値
- Body
- SingleCalendarRes
新しいイベントを作成する
ユーザーのカレンダーに新しイベントを追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
カレンダーを指定するか、カレンダーの一意の ID を入力します。 |
|
肩書き
|
title | True | string |
イベントのタイトルを指定します。 |
|
開始時刻
|
start | True | string |
イベントの開始時刻を yyyy-MM-ddTHH:mm:sszzz の形式で指定します。 |
|
終了時刻
|
end | True | string |
イベントの終了時刻を yyyy-MM-ddTHH:mm:sszzz の形式で指定します。 |
|
Timezone
|
timezone | string |
イベントのタイムゾーンを指定する |
|
|
カラー
|
color | string |
イベントの色を選択するか、色の 16 進値を指定します |
|
|
Description
|
description | string |
イベントの説明を指定します |
|
|
場所
|
location | string |
イベントの場所を指定 |
|
|
[URL]
|
url | string |
イベントの URL を指定します |
|
|
Private
|
isprivate | boolean |
イベントが非公開かどうかを指定します |
|
|
終日である
|
isallday | boolean |
イベントが終日イベントであるかを指定します。 |
|
|
メール ID
|
string |
出席者の電子メール アドレスを指定する |
||
|
Transparency
|
transparency | integer |
イベントを空き時間スケジュールに追加するかどうかを指定します。 |
|
|
転送を許可する
|
allowForwarding | boolean |
イベントを転送できるかどうかを指定します |
|
|
タイプ
|
action | string |
イベントリマインダーのタイプ (電子メール、通知など) を指定します |
|
|
分単位
|
minutes | integer |
イベントの前後にリマインドする時間を指定します (例: 前は 5、後は 5) |
戻り値
- Body
- SingleEventRes
検索イベント
すべてのカレンダーのイベントのリストを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
カレンダーを指定するか、カレンダーの一意の ID を入力します。 |
|
開始時刻
|
start | True | string |
イベントの開始時刻を yyyy-MM-ddTHH:mm:sszzz の形式で指定します。 |
|
終了時刻
|
end | string |
イベントの終了時刻を yyyy-MM-ddTHH:mm:sszzz の形式で指定します。 |
|
|
検索テキスト
|
searchtext | string |
タイトルで検索する必要があることを指定します |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
検索
|
search | array of object |
検索 |
|
イベントの一意の ID
|
search.uid | string |
イベントの一意識別子 |
|
終日イベントか
|
search.isallday | boolean |
イベントが終日イベントであるかどうか |
|
カレンダーの一意の ID
|
search.caluid | string |
カレンダーを表す一意識別子です |
|
肩書き
|
search.title | string |
イベントのタイトル |
|
タイプ
|
search.type | integer |
タイプ |
|
Timezone
|
search.dateandtime.timezone | string |
イベントのタイム ゾーン |
|
開始時刻
|
search.dateandtime.start | string |
イベントの開始時刻 |
|
終了時刻
|
search.dateandtime.end | string |
イベントの終了時刻 |
トリガー
| イベント通知を削除する |
カレンダーでイベントが更新されたとき |
| イベント通知を編集する |
カレンダーにイベントが更新されたとき |
| 新規イベント通知 |
イベントがカレンダーに追加されたとき |
イベント通知を削除する
カレンダーでイベントが更新されたとき
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
イベントの一意の ID
|
zc_data.uid | string |
イベントの一意識別子 |
|
カレンダーの一意の ID
|
zc_data.caluid | string |
カレンダーを表す一意識別子です |
イベント通知を編集する
新規イベント通知
定義
SingleEventRes
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
カラー
|
color | string |
16 進数のイベントカラー値 |
|
肩書き
|
title | string |
イベントのタイトル |
|
長さ
|
duration | string |
イベントの期間 |
|
イベントの一意の ID
|
uid | string |
イベントの一意識別子 |
|
イベント作成者
|
createdby | string |
イベントを作成したユーザー |
|
承認済み
|
isApproved | boolean |
作成したイベントが承認されたかどうか。 |
|
場所
|
location | string |
イベントの場所 |
|
[URL]
|
url | string |
イベントの URL |
|
イベント表示 URL
|
viewEventURL | string |
イベントの一意の ID。 |
|
タイムゾーン
|
dateandtime.timezone | string |
イベントのタイム ゾーン |
|
開始時刻
|
dateandtime.start | string |
イベントの開始時刻 |
|
終了時刻
|
dateandtime.end | string |
イベントの終了時刻 |
|
イベントの最終修正日
|
lastmodifiedtime | string |
ドキュメントが最後に修正された日時 |
|
Is private
|
isprivate | boolean |
イベントがプライベートイベントかどうか |
|
出席者
|
attendees | array of object |
イベントの参加者 |
|
表示名
|
attendees.dName | string |
出席者の表示名 |
|
メール ID
|
attendees.email | string |
参加者のメール アドレス。 |
|
出席者
|
attendees.attendance | integer |
出席者が必須、オプションまたは不必要かどうか。 |
|
ステータス
|
attendees.status | string |
出席者のステータスを参照します (承認/拒否/暫定/要対応) |
|
Created on
|
createdtime_millis | string |
イベント作成時刻 (GMT) |
|
通知の種類
|
notifyType | integer |
デフォルトの通知設定に基づいてイベントについて出席者に通知します。 |
|
[開催者]
|
organizer | string |
イベントの開催者 |
|
終日イベントか
|
isallday | boolean |
イベントが終日イベントであるかどうか |
|
Transparency
|
transparency | integer |
イベントを空き時間スケジュールに追加するかどうか |
|
変更者
|
modifiedby | string |
イベントを修正したユーザーを参照します。 |
|
イベント タグ
|
etag | string |
イベント タグを参照して、イベントが作成/変更されたモードを識別します。 |
|
カレンダーの一意の ID
|
caluid | string |
カレンダーを表す一意識別子です |
|
転送を許可する
|
allowForwarding | boolean |
イベントが転送可能かどうか。 |
|
reminders
|
reminders | array of object | |
|
アラームタイプ
|
reminders.action | string |
イベント リマインダーのタイプ (メール、通知、ポップアップ) を指します。 |
|
次の場合に通知する
|
reminders.minutes | string |
リマインダー時間を分単位で表します。 |
SingleCalendarRes
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
カラー
|
color | string |
16 進数のカレンダー カラー値 |
|
Timezone
|
timezone | string |
カレンダーのタイム ゾーン |
|
テキストの色
|
textcolor | string |
16 進数のカレンダー テキスト カラー |
|
Description
|
description | string |
カレンダーの説明 |
|
カレンダーの一意の ID
|
uid | string |
カレンダーを表す一意識別子です |
|
既定である
|
isdefault | boolean |
カレンダーがデフォルトのカレンダーかどうか |
|
空き時間情報を含める
|
include_infreebusy | boolean |
カレンダーの空き/予約済み時間の状態 |
|
件名
|
name | string |
カレンダーの名前 |
|
Status
|
status | boolean |
カレンダーの状態 |
EventNotifyRes
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
カラー
|
zc_data.color | string |
16 進数のイベントカラー値 |
|
肩書き
|
zc_data.title | string |
イベントのタイトル |
|
Created on
|
zc_data.createdtime | string |
イベントの作成時刻 |
|
ユーザーのタイムゾーン
|
zc_data.user_timezone | string |
ユーザーのタイムゾーン |
|
イベント期間
|
zc_data.duration | string |
イベントの期間 |
|
イベントの一意の ID
|
zc_data.uid | string |
イベントの一意識別子 |
|
終日イベントか
|
zc_data.isallday | boolean |
イベントが終日イベントであるかどうか |
|
場所
|
zc_data.location | string |
イベントの場所 |
|
etag
|
zc_data.etag | string |
イベント タグを参照して、イベントが作成/変更されたモードを識別します。 |
|
カレンダーの一意の ID
|
zc_data.caluid | string |
カレンダーを表す一意識別子です |
|
タイムゾーン
|
zc_data.dateandtime.timezone | string |
イベントのタイム ゾーン |
|
開始時刻
|
zc_data.dateandtime.start | string |
イベント開始時間の形式 yyyyMMddTHHmmss |
|
終了時刻
|
zc_data.dateandtime.end | string |
イベント終了時間の形式 yyyyMMddTHHmmss |
|
イベントの最終修正日
|
zc_data.lastmodifiedtime | string |
ドキュメントが最後に修正された日時 |