WebhooksによるWorkDriveのイベントトリガー

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

WorkDriveのWebhookを利用すると、特定のイベント（トリガー）、たとえばファイルのアップロードや変更が指定したWorkDriveフォルダー（送信元）で発生した際に、指定した外部アプリ（URL）へ自動的に通知できます。

この機能を利用するには、カスタムアプリを作成し、Webhookタブでトリガーしたいイベントを選択、WorkDriveの設定で発生場所を指定してください。イベントが発生すると、WorkDriveは指定した外部アプリへ指定URLを通じて自動で通知を送信します。

WorkDriveでWebhookを設定する方法の詳細はこちら

以下に、WorkDriveのWebhook機能を最大限に活用するための実践的なシナリオをいくつかご紹介します。

ファイルのセキュリティ：Webhookは、WorkDrive内に保存されたファイルやフォルダーの活動を監視する強力なツールとして活用できます。例えば、特定の場所でファイルがアップロード、更新、または削除された際にWebhookを設定することで、これらの変更について即座に通知を受け取ることが可能です。
共同作業：Webhookを利用して、共同編集者による変更、共有ドキュメントの編集、新規コメントの追加などについて通知を受け取ることができます。たとえば、共有ファイルに新しいコメントが追加された場合、Webhookの設定により即時の通知を受信できます。
アクセス制御：Webhookを利用し、ユーザーのアクセスや権限をリアルタイムで管理できます。たとえば、WorkDrive内でユーザーの役割やアクセス権限が変更された際にWebhookを設定すれば、即座に通知を受け取ることが可能です。これにより、ファイルやフォルダーへの不正アクセスを防止するための迅速な対応ができ、全体のアクセス制御とセキュリティの向上につながります。

以下は、WorkDriveで利用可能なファイル・フォルダー・チームフォルダーおよびチームベースのトリガー処理の一覧です。

ファイルベースのトリガー処理

ファイルイベント	トリガー説明
ファイル閲覧	選択済みファイルを開いたとき
ファイルをごみ箱に移動	選択済みファイルをごみ箱に移動したとき
ファイルを復元	選択済みファイルをごみ箱から復元したとき
ファイルをごみ箱から削除	選択済みファイルをごみ箱から削除したとき
ファイルが移動されました	選択済みファイルが移動された場合
ファイル名が変更されました	選択済みファイルの名前が変更された場合
コメント作成	選択済みファイルにコメントが追加された場合
コメント更新	選択済みファイルのコメントが更新された場合
コメント削除	選択済みファイルでコメントが削除された場合
ファイル共有解除	選択済みファイルのユーザーのアクセス権が解除された場合
ファイル共有更新	選択済みファイルのユーザーのアクセス権が更新された場合
ファイル共有	選択済みファイルのユーザーにアクセス権が付与された場合
ファイルがダウンロードされました	選択済みファイルがダウンロードされたとき
外部リンクを共有作成	選択済みファイルに対して外部リンクを共有が作成されたとき
外部リンクを共有更新	選択済みファイルの外部リンクを共有の設定が更新されたとき
外部リンクを共有削除	選択済みファイルの外部リンクを共有が削除されたとき

フォルダー単位のトリガー処理

フォルダーイベント	Trigger 説明
フォルダー作成	選択済みフォルダーまたはそのサブフォルダー内でフォルダーが作成されたとき
フォルダーをごみ箱へ移動	選択済みフォルダーまたはそのサブフォルダーがごみ箱に移動されたとき
フォルダーの復元	選択済みフォルダーまたはそのサブフォルダーがごみ箱から復元されたとき
フォルダー削除差出人ごみ箱	選択済みフォルダーまたはそのサブフォルダーが削除差出人ごみ箱された場合
フォルダーコピー済み	選択済みフォルダーまたはそのサブフォルダー内にフォルダーがコピーされた場合
フォルダー移動済み	選択済みフォルダーまたはそのサブフォルダー内にフォルダーが移動された場合
フォルダーアップロード済み	選択済みフォルダーまたはそのサブフォルダー内にフォルダーがアップロードされた場合
フォルダをダウンロード	選択済みフォルダまたはそのサブフォルダがダウンロードされた場合
フォルダ名の変更	選択済みフォルダまたはそのサブフォルダの名前が変更された場合
フォルダの共有	ユーザーに選択済みフォルダまたはそのサブフォルダへのアクセス権が付与された場合
フォルダ共有の更新	ユーザーの選択済みフォルダまたはそのサブフォルダへのアクセス権が更新された場合
Folder sharing 削除	ユーザーの選択済みフォルダーまたはそのサブフォルダーへのアクセス権が取り消された場合
External リンクを共有する作成	選択済みフォルダーまたはそのサブフォルダー用のExternal リンクを共有するが作成された場合
External リンクを共有する updated	選択済みフォルダーまたはそのサブフォルダー用のExternal リンクを共有する設定が更新された場合
External リンクを共有する削除	選択済みフォルダーまたはそのサブフォルダー用のExternal リンクを共有するが削除された場合

選択済みフォルダー／サブフォルダー内でのファイル処理	トリガー説明
Zohoネイティブファイル作成	選択済みフォルダーまたはそのサブフォルダー内でZohoネイティブファイル（Writer、Sheet、表示）が作成されたとき
ファイルのアップロード	選択済みフォルダーまたはそのサブフォルダー内にファイルがアップロードされたとき
ファイルを「ごみ箱」へ移動	選択済みフォルダーまたはそのサブフォルダー内のファイルがごみ箱へ移動されたとき
ファイルが復元されました	ファイルがごみ箱から選択済みフォルダーまたはそのサブフォルダーに復元された場合
ファイル削除（ごみ箱）	ファイルが選択済みフォルダーまたはそのサブフォルダーでごみ箱から削除された場合
ファイルがコピーされました	ファイルが選択済みフォルダーまたはそのサブフォルダー内でコピーされた場合
ファイルが移動されました	ファイルが選択済みフォルダーまたはそのサブフォルダー内で移動された場合
ファイルがダウンロードされました	ファイルが選択済みフォルダーまたはそのサブフォルダーから差出人によってダウンロードされた場合
ファイル名が変更されました	ファイルが選択済みフォルダーまたはそのサブフォルダー内で名前変更された場合
ファイルが共有されました	選択済みフォルダーまたはそのサブフォルダー内のファイルにユーザーがアクセス権を付与された場合
ファイルの共有設定が更新されました	選択済みフォルダーまたはそのサブフォルダー内のファイルに対するユーザーのアクセス権が更新された場合
File sharing 削除	選択済みフォルダーまたはそのサブフォルダー内のファイルに対するユーザーのアクセス権が取り消された場合
External リンクを共有する作成	選択済みフォルダーまたはそのサブフォルダー内のファイルでExternal リンクを共有するが作成された場合
External リンクを共有する updated	選択済みフォルダーまたはそのサブフォルダー内のファイルでExternal リンクを共有するの設定が更新された場合
External リンクを共有する削除	選択済みフォルダーまたはそのサブフォルダー内のファイルでExternal リンクを共有するが削除された場合

Team フォルダーに基づくトリガー処理

Team folder 処理	トリガーの説明
Team Folder 名の変更	選択済みのTeam Folderの名前が変更された場合
Team Folder 削除	選択済みのTeam Folderが削除された場合
Team Folder へのメンバー追加	選択済みのTeam Folderにメンバーが追加された場合
Teamフォルダー内のメンバー役割の更新	選択済みのTeamフォルダーでメンバーの役割が更新された場合
Teamフォルダー内のメンバー削除	選択済みのTeamフォルダーでメンバーが削除された場合

選択済みTeamフォルダーまたはそのサブフォルダー内でのフォルダー処理	トリガー説明
フォルダー作成	選択済みTeamフォルダーまたはそのサブフォルダー内でフォルダーが作成された場合
フォルダーがごみ箱に移動されました	選択済みチームフォルダー内のサブフォルダーがごみ箱に移動された場合
フォルダーが復元されました	選択済みチームフォルダーまたはそのサブフォルダー内で、フォルダーがごみ箱から復元された場合
フォルダーがごみ箱から削除されました	選択済みチームフォルダーまたはそのサブフォルダー内で、フォルダーがごみ箱から削除された場合
フォルダーがコピーされました	選択済みチームフォルダーまたはそのサブフォルダー内でフォルダーがコピーされた場合
フォルダーが移動されました	フォルダーが選択済みチームフォルダーまたはそのサブフォルダー内で移動されたとき
フォルダーがアップロードされました	フォルダーが選択済みチームフォルダーまたはそのサブフォルダー内にアップロードされたとき
フォルダーがダウンロードされました	フォルダーが選択済みチームフォルダーまたはそのサブフォルダーからダウンロードされたとき
フォルダー名が変更されました	フォルダー名が選択済みチームフォルダーまたはそのサブフォルダー内で変更されたとき
フォルダーが共有されました	選択済みチームフォルダーまたはそのサブフォルダー内のフォルダーにユーザーへのアクセス権が付与された場合
フォルダー共有の更新	選択済みチームフォルダーまたはそのサブフォルダー内のフォルダーに対してユーザーのアクセス権が更新された場合
フォルダー共有の削除	選択済みチームフォルダーまたはそのサブフォルダー内のフォルダーからユーザーのアクセス権が解除された場合
外部リンクの作成	選択済みチームフォルダーまたはそのサブフォルダー内のフォルダーに対して外部リンクが作成された場合
External リンクを共有する更新	選択済みのチームフォルダーまたはそのサブフォルダー内のフォルダーで External リンクを共有する設定が更新された場合
External リンクを共有する削除	選択済みのチームフォルダーまたはそのサブフォルダー内のフォルダーで External リンクを共有するが削除された場合

選択済みチームフォルダーまたはそのサブフォルダー内でのファイル処理	トリガーの説明
Zoho ネイティブファイル作成	選択済みチームフォルダーまたはそのサブフォルダー内で Zoho ネイティブファイル（Writer、Sheet、または表示）が作成された場合
ファイルがアップロードされました	ファイルが選択済みチームフォルダまたはそのサブフォルダ内にアップロードされた場合
ファイルがごみ箱に移動されました	ファイルが選択済みチームフォルダまたはそのサブフォルダ内のごみ箱に移動された場合
ファイルが復元されました	ファイルがごみ箱から選択済みチームフォルダまたはそのサブフォルダに復元された場合
ファイルがごみ箱から削除されました	ファイルが選択済みチームフォルダまたはそのサブフォルダ内のごみ箱から削除された場合
ファイルがコピーされました	ファイルが選択済みチームフォルダまたはそのサブフォルダ内でコピーされた場合
ファイルが移動されました	ファイルが選択済みチームフォルダまたはそのサブフォルダ内で移動された場合
ファイルがダウンロードされました	ファイルが選択済みチームフォルダまたはそのサブフォルダからダウンロードされた場合
ファイル名が変更されました	ファイル名が選択済みチームフォルダまたはそのサブフォルダ内で変更された場合
ファイルが共有されました	ユーザーに選択済みチームフォルダまたはそのサブフォルダ内のファイルへのアクセス権が付与されたとき
ファイル共有の更新	ユーザーの選択済みチームフォルダまたはそのサブフォルダ内のファイルへのアクセス権が更新されたとき
ファイル共有削除	ユーザーの選択済みチームフォルダまたはそのサブフォルダ内のファイルへのアクセス権が取り消されたとき
外部リンクを共有する作成	選択済みチームフォルダまたはそのサブフォルダ内のファイルに対して外部リンクを共有するが作成されたとき
External リンクを共有する更新	選択済みチームフォルダーまたはそのサブフォルダー内のファイルに対してExternal リンクを共有する設定が更新された場合
External リンクを共有する削除	選択済みチームフォルダーまたはそのサブフォルダー内のファイルに対してExternal リンクを共有するが削除された場合

Team ベースの処理

メモ:Teamベースの処理には、これまでに説明したファイル・フォルダー・チームフォルダー単位の処理トリガーに加え、以下のTeamベースの処理も含まれます。

Team 処理	トリガーの説明
チーム名変更	チーム名が変更された場合
Team 削除	チームが削除された場合
ユーザー added to team	ユーザーがチームに追加された場合
ユーザー removed 差出人 team	ユーザーがチームから削除された場合
ユーザー役割がチームで更新されました	ユーザーのチーム役割が更新されたとき