> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/ja/to/vision-events/batch-create-vision-events.md).

# Vision Event を一括作成

1 回のリクエストで最大 100 件の Vision Event を記録し、多数の観測をまとめて取り込みます。

## 概要

このエンドポイントは、複数の [Vision Events](https://docs.roboflow.com/deployment/ja/to/vision-events.md) を1回のリクエストで最大100件記録します。デプロイで多数の観測結果を一度に取り込む必要がある場合に使用してください。イベントを個別に作成するより効率的です。単一のイベントを記録する場合は、 [Vision Eventの作成](https://docs.roboflow.com/deployment/ja/to/vision-events/create-a-vision-event.md).

## HTTP API

1回のリクエストで最大100件のVision Eventを作成します。複数のイベントを一度に取り込む必要がある場合、イベントを個別に作成するより効率的です。

**必須スコープ：** `vision-events:write` または `device:update`

{% openapi src="/files/934e54fa9aa57656316a422a76238b867f081de5" path="/vision-events/batch" method="post" %}
[openapi.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

{% hint style="info" %}
イベントに画像を含めるには、まず [Vision Event画像のアップロード](https://docs.roboflow.com/deployment/ja/to/vision-events/upload-a-vision-event-image.md#http-api) エンドポイントを使って各画像をアップロードし、返された `sourceId` を画像オブジェクト内で参照します。動画も同様に、各動画を次のエンドポイントでアップロードします。 [Vision Event動画のアップロード](https://docs.roboflow.com/deployment/ja/to/vision-events/upload-a-vision-event-video.md#http-api). [Vision Eventの作成](https://docs.roboflow.com/deployment/ja/to/vision-events/create-a-vision-event.md#http-api) には、画像オブジェクトと動画オブジェクトの各フィールドが記載されています。
{% endhint %}

各イベントは、単一のイベントと同じ方法で検証されます。 [検証と警告](https://docs.roboflow.com/deployment/ja/to/vision-events/create-a-vision-event.md#validation-and-warnings).

## Python SDK

1回のリクエストで複数のVision Eventを作成します。サーバーは1バッチあたり最大100件のイベントを受け付けます。

```python
import roboflow

roboflow.login()

rf = roboflow.Roboflow()
ws = rf.workspace()

result = ws.write_vision_events_batch([
    {
        "eventId": "e5f6a7b8-c3d4-4e5f-a0b1-c2d3e4f5a6b7",
        "eventType": "quality_check",
        "useCaseId": "a1b3c8e1",
        "timestamp": "2024-01-15T10:00:00Z",
        "eventData": {"result": "pass"},
    },
    {
        "eventId": "f6a7b8c9-d4e5-4f6a-b1c2-d3e4f5a6b7c8",
        "eventType": "quality_check",
        "useCaseId": "a1b3c8e1",
        "timestamp": "2024-01-15T10:01:00Z",
        "eventData": {"result": "fail"},
        "customMetadata": {"line": "A1"},
    },
])

print(result["created"])    # 作成されたイベント数
print(result["eventIds"])   # 作成されたイベントIDの一覧
```

リスト内の各イベントは、 [単一イベント](https://docs.roboflow.com/deployment/ja/to/vision-events/create-a-vision-event.md#python-sdk)と同じスキーマに従います。イベントスキーマと検証動作の詳細については、 [REST APIリファレンス](#http-api).
