> 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 Events を一括作成する

## 概要

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

## HTTP API

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

**必要なスコープ:** `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-dfdc1702ad3d1a62ad0a661e9609f6bbe2fc8d4c%2Fopenapi.yaml?alt=media)
{% endopenapi %}

### リクエスト例

```bash
curl -X POST "https://api.roboflow.com/vision-events/batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "events": [
      {
        "eventId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "eventType": "quality_check",
        "useCaseId": "a1b3c8e1",
        "timestamp": "2024-01-15T10:30:00Z",
        "eventData": {
          "result": "pass"
        }
      },
      {
        "eventId": "9c4d6a2e-81f3-4b7a-bc9e-3f1a2d4e5c6b",
        "eventType": "quality_check",
        "useCaseId": "a1b3c8e1",
        "timestamp": "2024-01-15T10:31:00Z",
        "eventData": {
          "result": "fail"
        }
      }
    ]
  }'
```

### リクエストボディのパラメータ

* **`イベント`** (配列、必須、最大100件): イベントオブジェクトの配列。各イベントは、次のものと同じスキーマに従います [Vision Event を作成](/deployment/ja/to/vision-events/create-a-vision-event.md#http-api) エンドポイントからクエリできます。

{% hint style="info" %}
イベントに画像を含めるには、まず各画像を次のエンドポイントを使用してアップロードし、 [ビジョンイベント画像をアップロード](/deployment/ja/to/vision-events/upload-a-vision-event-image.md#http-api) エンドポイント、返された `sourceId` 画像オブジェクト内で参照します。詳細は [画像オブジェクト](/deployment/ja/to/vision-events/create-a-vision-event.md#image-objects) 詳細について。
{% endhint %}

### レスポンス例

{% tabs %}
{% tab title="201" %}

```json
{
  "created": 2,
  "eventIds": ["f47ac10b-58cc-4372-a567-0e02b2c3d479", "9c4d6a2e-81f3-4b7a-bc9e-3f1a2d4e5c6b"]
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "バッチサイズが最大100件のイベントを超えています"
}
```

{% endtab %}

{% tab title="403" %}

```json
{
  "error": "このリソースに対する権限が不十分です。"
}
```

{% endtab %}
{% endtabs %}

レスポンスには、 `warnings` イベントごとの検証警告（イベントインデックスをキーとする）を含むオブジェクト、および `deprecations` 非推奨のフィールド名が使用されていた場合は配列。詳細は [検証と警告](/deployment/ja/to/vision-events/create-a-vision-event.md#validation-and-warnings) 詳細について。

## Python SDK

1回のリクエストで複数のvisionイベントを作成できます。サーバーは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の一覧
```

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