指定したユーザーまたは会社全体の過去のイベントを最大1年間遡って返します。
デフォルトでは、認証済みユーザーのイベントを返します。会社全体のイベントを取得するには、stream_type
をadmin_logs
に設定します。会社のイベントフィードを取得するには、API呼び出しを行うユーザーが管理者権限を所有していて、アプリケーションがイベントフィードに対するアクセス権限を所有している必要があります。
2012-12-12T10:53:43-08:00
イベントを返す日時の下限。stream_type
がadmin_logs
のイベントをリクエストする場合にのみ使用できます。stream_type
がこれ以外の場合、この値は無視されます。
2013-12-12T10:53:43-08:00
イベントを返す日時の上限。stream_type
がadmin_logs
のイベントをリクエストする場合にのみ使用できます。stream_type
がこれ以外の場合、この値は無視されます。
ACCESS_GRANTED
フィルタとして使用するイベントのカンマ区切りリスト。stream_type
がadmin_logs
のイベントをリクエストする場合にのみ使用できます。stream_type
がこれ以外の場合、この値は無視されます。
50
100
500
返されるイベントの数を制限します
1348790499819
イベントの受け入れを開始するイベントストリーム内の位置。
now
を指定すると、初期化のための空のリストイベントとともに、最新のストリーム位置が返されます。0
またはnull
を指定すると、すべてのイベントが返されます。all
"all"
返されるイベントのタイプを定義します
all
の場合は、ユーザーに関するすべてのイベントを返します (デフォルト値)changes
の場合は、ファイルのアップロードやコラボレーションなど、ファイルのツリー構造が変わる可能性があるイベントを返しますsync
はchanges
と似ていますが、同期対象フォルダのみに適用されますadmin_logs
の場合は、会社全体のすべてのイベントを返します。API呼び出しを行うユーザーは、管理者権限が必要です。次の値のいずれか1つ: all
,changes
,sync
,admin_logs
curl -i -X GET "https://api.box.com/2.0/events" \
-H "Authorization: Bearer <ACCESS_TOKEN>"
{
"chunk_size": 2,
"entries": [
{
"type": "event",
"event_id": "f82c3ba03e41f7e8a7608363cc6c0390183c3f83",
"created_by": {
"id": 11446498,
"type": "user",
"name": "Aaron Levie",
"login": "ceo@example.com"
},
"event_type": "FILE_MARKED_MALICIOUS",
"session_id": "70090280850c8d2a1933c1",
"source": {
"id": 11446498,
"type": "user",
"name": "Aaron Levie",
"login": "ceo@example.com",
"created_at": "2012-12-12T10:53:43-08:00",
"modified_at": "2012-12-12T10:53:43-08:00",
"language": "en",
"timezone": "Africa/Bujumbura",
"space_amount": 11345156112,
"space_used": 1237009912,
"max_upload_size": 2147483648,
"status": "active",
"job_title": "CEO",
"phone": 6509241374,
"address": "900 Jefferson Ave, Redwood City, CA 94063",
"avatar_url": "https://www.box.com/api/avatar/large/181216415",
"notification_email": {
"email": "notifications@example.com",
"is_confirmed": true
}
},
"additional_details": {
"key": "value"
}
}
],
"next_stream_position": 1152922976252290800
}