次の方法で共有


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 を入力します。

戻り値

イベントを更新する

ユーザーのカレンダーの既存イベントが更新されます。

パラメーター

名前 キー 必須 説明
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
email string

出席者の電子メール アドレスを指定する

Transparency
transparency integer

イベントを空き時間スケジュールに追加するかどうかを指定します。

転送を許可する
allowForwarding boolean

イベントを転送できるかどうかを指定します

タイプ
action string

イベントリマインダーのタイプ (電子メール、通知など) を指定します

分単位
minutes integer

イベントの前後にリマインドする時間を指定します (例: 前は 5、後は 5)

戻り値

カレンダーのリストを取得する

カレンダー UID、名前、タイムゾーンを含むすべてのカレンダーのリストを取得します。

戻り値

名前 パス 説明
calendars
calendars array of SingleCalendarRes

calendars

カレンダーの詳細の取得

カレンダー UID を使用して特定のカレンダーの詳細を取得します。

パラメーター

名前 キー 必須 説明
Calendar
cuid True string

カレンダーを指定するか、カレンダーの一意の ID を入力します。

戻り値

新しいイベントを作成する

ユーザーのカレンダーに新しイベントを追加します。

パラメーター

名前 キー 必須 説明
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
email string

出席者の電子メール アドレスを指定する

Transparency
transparency integer

イベントを空き時間スケジュールに追加するかどうかを指定します。

転送を許可する
allowForwarding boolean

イベントを転送できるかどうかを指定します

タイプ
action string

イベントリマインダーのタイプ (電子メール、通知など) を指定します

分単位
minutes integer

イベントの前後にリマインドする時間を指定します (例: 前は 5、後は 5)

戻り値

検索イベント

すべてのカレンダーのイベントのリストを取得します。

パラメーター

名前 キー 必須 説明
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

ドキュメントが最後に修正された日時