イベント
イベント
アプリケーションはイベントフィードを使用して、社内の任意のユーザーが実行する操作をすべて登録できます。
ユーザーイベントと管理者イベント
GET /events APIを使用すると、ユーザーによるイベントを登録できます。stream_typeを渡すことで、アプリケーションは一連の異なるイベントを登録できます。
ユーザーイベント
ユーザーイベントは、現在認証されているユーザーに対して、低レイテンシのイベントストリームを提供します。
このフィードでは、完全な結果を迅速に返すことを重視しています。つまり、Boxではイベントを複数回または異なる順序で返す可能性があります。重複するイベントは、イベントIDによって識別できます。
ユーザーイベントのストリームでは、特定のイベント(ITEM_CREATEなど)のフィルタはサポートされていませんが、目的に応じて異なるストリームを提供するためのstream_typeによるフィルタはサポートされています。
| ストリームタイプ | |
|---|---|
all | Returns everything for a user (default) |
changes | Returns events that may cause file tree changes such as file updates or collaborations. |
sync | Is similar to changes but only applies to synced folders |
管理者イベント
管理者イベントは、社内のすべてのユーザーとコンテンツのイベントフィードを提供します。
イベントフィードを使用するには、stream_typeをadmin_logsに設定するほか、管理者権限を持つユーザーによる呼び出しで新規レポートの実行と既存レポートへのアクセスを行う必要があります。
このフィードでは、レイテンシよりも完全性を重視しています。つまり、Boxでは管理者イベントをユーザーフィードよりも高いレイテンシで配信することがあります。ユーザーイベントストリームとは違い、管理者イベントストリームでは、特定のイベントに対するフィルタが可能ですが、ロングポーリングはサポートされていません。