# API ประมวลผล Bulk

สร้างและควบคุมงาน YouTube จากนั้นรับช่วงรายการ และส่วนผลลัพธ์ของพวกเขา

อ้างอิงทางคลอง: https://flashdata.dev/th/docs/reference/bulk-processing
Recorder: 2026-11-05 โดย FlashData

<a id="playground"></a>

## พื้นที่ทดลอง API

เลือกแหล่งและคัดลอกฉบับที่เสร็จสมบูรณ์ Python หรือ Bash การทํางาน, การร้องขอเดียว, หรือการตอบสนองตัวอย่าง รหัสการแสดงตัวอย่างสนามเด็กเล่น; มันไม่ส่งงาน การไหลของงานที่สมบูรณ์ สามารถจัดการการอัปโหลด, การตรวจสอบสถานะและการกู้ค่าของทุกส่วนผลลัพธ์

- [การตรวจสอบสิทธิ์และความต้องการของแฟ้ม](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#prepare)
- [เลือกจุดปลาย](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#endpoints)
- [Batch หรือ Bulk?](https://flashdata.dev/th/docs/reference/batch-and-bulk/reference.md)

<a id="endpoints"></a>

## จุดสิ้นสุด

ทุก endpoint ใช้ https://api.flashdata.dev/v2 สร้างงาน → อัปโหลดไฟล์ ID วิดีโอ → เริ่มงาน → ติดตามสถานะ → ดึง manifest และผลลัพธ์ทุกส่วน

| วิธีการ | พาธ | การกระทํา |
| --- | --- | --- |
| POST | /v2/bulk-jobs | สร้างรายการ Bulk งาน |
| POST | /v2/bulk-jobs/{bulkId}/start | อัปโหลดแล้วเริ่ม |
| GET | /v2/bulk-jobs/{bulkId} | รับสถานะงาน |
| GET | /v2/bulk-jobs | รายการงาน |
| POST | /v2/bulk-jobs/{bulkId}/pause | หยุดงานชั่วคราว |
| PATCH | /v2/bulk-jobs/{bulkId} | ปรับปรุงตัวเลือกของงานพิมพ์ |
| POST | /v2/bulk-jobs/{bulkId}/resume | ทํางานต่อ |
| DELETE | /v2/bulk-jobs/{bulkId} | ยกเลิกงาน |
| GET | /v2/bulk-jobs/{bulkId}/results | จง ให้ ผล ปรากฏ ออก มา |
| GET | /v2/bulk-jobs/{bulkId}/results/{partNumber} | ดาวน์โหลดส่วนผลลัพธ์ |

- [Batch หรือ Bulk?](https://flashdata.dev/th/docs/reference/batch-and-bulk/reference.md)
- [จบงาน Bulk นําทาง](https://flashdata.dev/th/docs/guides/bulk/reference.md)
- [ข้อกําหนด OpenAPI](https://flashdata.dev/docs/openapi.json)

<a id="prepare"></a>

## การตรวจสอบสิทธิ์และป้อนข้อมูล

ตั้งค่า FLASHDATA_API_KEY เข้าสู่กุญแจพร้อมเข้าถึงแหล่งที่เลือก ใช้คีย์และบัญชีเดิมสําหรับการสร้างสรรค์ ควบคุมและผลลัพธ์ ประมวลผลใช้ค่าสมดุลของบัญชี และปกติต่อแหล่งข้อมูล YouTube Download ต้องการสิทธิ์เจ้าของและ options.storage.

สร้างโฟลเดอร์ที่ทํางานอยู่ชื่อ build-api/ และประมวลผลตัวอย่างเหล่านี้จากมัน สนามเด็กเล่นสมบูรณ์ Python การ ไหล ของ งาน ใช้ Python 3.10+ ไลบรารีมาตรฐาน; ส่วนบุคคล Python ตัวอย่างจุดปลายด้านล่าง ต้องการการร้องขอ cURL ตัวอย่างที่ใช้ Bash, cURL 7.76+, jq และ gzip เลือกภาษาหนึ่งสําหรับแต่ละการกระทํา ดังนั้นคุณจึงไม่ต้องสร้างหรือเริ่มทํางานซ้ํากัน

การนําเข้าคือ UTF-8 แฟ้มที่มีหนึ่งแฟ้ม 11- ช่างทําเล็บ YouTube ID ต่อบรรทัด, ถึง 2 กิบ ใช้ IDsไม่ ไม่ URLs. ลบรายการที่ซ้ํากัน IDs ก่อนทําการอัปโหลด; ทําซ้ํา IDs แยกกันดําเนินการ

| แหล่ง | ตัวเลือกที่ใช้ร่วมกัน |
| --- | --- |
| youtube_metadata | include_formats, include_chapters |
| youtube_transcript | ภาษา, อัตโนมัติ |
| youtube_captions | ภาษา, อัตโนมัติ |
| youtube_trainability | ตัวเลือกต่าง ๆ |
| youtube_download | ตัวเลือกเล่นสื่อและปลายทางจัดเก็บข้อมูล |

### Python การติดต่อ

```bash
python -m pip install requests
```

- [API กุญแจและส่วนหัว](https://flashdata.dev/th/docs/guides/headers-and-authentication/reference.md)
- [ช่องข้อมูลจัดเก็บข้อมูล](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#storage)

<a id="request-body"></a>

## สร้างช่องข้อมูลที่ร้องขอ

| ช่องข้อมูล | ชนิด | วิธีใช้ |
| --- | --- | --- |
| source | string | ต้องการ แหล่งที่มาสําหรับทุกนําเข้า ID |
| options | object | ตัวเลือกของแหล่งใช้งานร่วมกัน แหล่งข้อมูลอาจจะตั้งค่า result_storage; YouTube Download ต้องการจัดเก็บข้อมูล |
| callback_url | string | เลือกใช้สาธารณะ HTTPS การเรียกเสร็จสิ้น หลัง จาก ที่ ได้ รับ การ ส่ง ออก อย่าง เป็น ทาง การ แล้ว. |

- [ขอแบบเต็มกําลัง ชูมา](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-CreateBulkJobRequest)
- [การจัดการเว็บฮุค](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#webhooks)

<a id="createBulkJob"></a>

## สร้างรายการ Bulk งาน

สร้างงาน, อัปโหลด UTF-8 แฟ้มข้อความที่มีหนึ่งแฟ้ม 11- ช่างทําเล็บ YouTube วิดีโอ ID ต่อบรรทัด upload.hrefงั้นโทรเริ่มเลย การ สร้าง งาน เพียง อย่าง เดียว ไม่ ได้ เริ่ม กระบวนการ.

ตัวอย่างนี้เขียน video-ids.txt และช่วยรักษา 201 ใบเสร็จข้อมูล bulk-created.json. เก็บใบเสร็จไว้ส่วนตัว และใช้ job.id ใหม่ สําหรับการร้องขอภายหลัง การสร้างงานทิ้งมันไว้ awaiting_uploadสืบค้นเมื่อ URL หมดอายุหลังจาก 15 ไม่กี่นาที

### จุดสิ้นสุด

```http
POST https://api.flashdata.dev/v2/bulk-jobs
X-API-Key: YOUR_API_KEY
```

### Python

บันทึก bulk_create.py ในถาดขนาดใหญ่/ ด้านข้าง bulk-created.json. คัดลอกสคริปต์ที่สมบูรณ์แล้วเรียกใช้คําสั่งด้านล่าง

#### bulk_create.py

```python
import json
import os
from pathlib import Path

import requests

os.umask(0o077)
Path("video-ids.txt").write_bytes(b"jNQXAC9IVRw\ndQw4w9WgXcQ\n")
response = requests.post(
    "https://api.flashdata.dev/v2/bulk-jobs",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    json={"source": "youtube_metadata", "options": {"include_formats": False}},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
receipt = response.json()
Path("bulk-created.json").write_text(json.dumps(receipt, indent=2), encoding="utf-8")
print(json.dumps(receipt["job"], indent=2))
```

#### ประมวลผลจากจุลภาค/

```bash
python bulk_create.py
```


### cURL / Bash

#### ประมวลผลจากจุลภาค/

```bash
umask 077
printf '%s\n' 'jNQXAC9IVRw' 'dQw4w9WgXcQ' > video-ids.txt
curl --fail-with-body --silent --show-error \
  'https://api.flashdata.dev/v2/bulk-jobs' \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"source":"youtube_metadata","options":{"include_formats":false}}' \
  --output bulk-created.json &&
jq '.job | {id, source, status}' bulk-created.json
```


- [CreateBulkJobRequest](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-CreateBulkJobRequest)
- [BulkJobCreated](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-BulkJobCreated)
- [Problem](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="createBulkJob-responses"></a>

### การ ตอบ รับ และ การ ขอ ให้ เชมา

| HTTP สถานะ | หมายความว่า |
| --- | --- |
| 201 | Bulk งานที่สร้างจาก 15- อัปโหลดไปโดยตรงนาที URL |
| 401 | ต้องการการตรวจสอบสิทธิ์หรือไม่? |
| 422 | การร้องขอการตรวจสอบสิทธิ์ล้มเหลว |
| 503 | ไม่สามารถเชื่อมโยงหรือแคตตาล็อกที่ต้องการได้ชั่วคราว |

#### เนื้อหาคำขอ

```json
{
  "$ref": "#/components/schemas/CreateBulkJobRequest"
}
```

#### 201 · application/json

```json
{
  "$ref": "#/components/schemas/BulkJobCreated"
}
```


<a id="startBulkJob"></a>

## อัปโหลดแล้วเริ่ม

เริ่มประมวลผลการอัปโหลด UTF-8 วิดีโอ ID แฟ้ม, ถึง 2 กิบ (ค.ศ.2147483648 ไบต์) ให้แฟ้มไม่เปลี่ยนแปลงหลังจากเริ่มการทํางานแล้ว

อันดับแรก PUT video-ids.txt ที่ใบเสร็จ upload.href ด้วย upload.contentType# หากไม่มี X-API-Key. ตัวอย่างเริ่มต้นหลังจากการอัปโหลดประสบความสําเร็จเท่านั้น เก็บการอัปโหลดไว้ไม่เปลี่ยนแปลงภายหลัง

| พารามิเตอร์ | ตําแหน่ง | เงื่อนไข |
| --- | --- | --- |
| bulkId | path | จำเป็น · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### จุดสิ้นสุด

```http
POST https://api.flashdata.dev/v2/bulk-jobs/{bulkId}/start
X-API-Key: YOUR_API_KEY
```

### Python

บันทึก bulk_start.py ในถาดขนาดใหญ่/ ด้านข้าง bulk-created.json. คัดลอกสคริปต์ที่สมบูรณ์แล้วเรียกใช้คําสั่งด้านล่าง

#### bulk_start.py

```python
import json
import os
from pathlib import Path

import requests

receipt = json.loads(Path("bulk-created.json").read_text(encoding="utf-8"))
upload = receipt["upload"]
if upload["method"] != "PUT" or not upload["href"].startswith("https://"):
    raise ValueError("Expected an HTTPS PUT upload URL")
# Stream the file to storage without the FlashData key.
with open("video-ids.txt", "rb") as file:
    response = requests.put(
        upload["href"], data=file,
        headers={"Content-Type": upload["contentType"]},
        timeout=300, allow_redirects=False,
    )
    response.raise_for_status()
    if not 200 <= response.status_code < 300:
        raise RuntimeError("Upload did not complete; do not start the job yet")

bulk_id = receipt["job"]["id"]
response = requests.post(
    f"https://api.flashdata.dev/v2/bulk-jobs/{bulk_id}/start",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
print(json.dumps(response.json()["job"], indent=2))
```

#### ประมวลผลจากจุลภาค/

```bash
python bulk_start.py
```


### cURL / Bash

#### ประมวลผลจากจุลภาค/

```bash
BULK_ID=$(jq -er '.job.id' bulk-created.json)
UPLOAD_URL=$(jq -er '.upload.href' bulk-created.json)
CONTENT_TYPE=$(jq -er '.upload.contentType' bulk-created.json)
curl --fail-with-body --silent --show-error --proto '=https' \
  --header "Content-Type: $CONTENT_TYPE" \
  --upload-file video-ids.txt "$UPLOAD_URL" &&
curl --fail-with-body --silent --show-error --request POST \
  "https://api.flashdata.dev/v2/bulk-jobs/$BULK_ID/start" \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}"
```


- [BulkJobResponse](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="startBulkJob-responses"></a>

### การตอบโต้

| HTTP สถานะ | หมายความว่า |
| --- | --- |
| 200 | Bulk งานเริ่มหรือสถานะที่ปรากฏอยู่ปัจจุบัน |
| 401 | ต้องการการตรวจสอบสิทธิ์หรือไม่? |
| 404 | ไม่พบทรัพยากรหรือไม่ได้เป็นเจ้าของโดยผู้เรียก |
| 409 | ความขัดแย้งของสถานะทรัพยากรหรือความไม่เข้มงวด |
| 422 | การร้องขอการตรวจสอบสิทธิ์ล้มเหลว |
| 503 | ไม่สามารถเชื่อมโยงหรือแคตตาล็อกที่ต้องการได้ชั่วคราว |

#### 200 · application/json

```json
{
  "$ref": "#/components/schemas/BulkJobResponse"
}
```


<a id="getBulkJob"></a>

## รับสถานะงาน

อ่าน job.statusการป้อนข้อมูล การนับ pauseReason และความผิดพลาด ตรวจสอบซ้ําเหมือนเดิม ID โดยมีความล่าช้า; เสร็จสิ้นหมายถึงการตีพิมพ์รายการไม่ได้ว่าทุกวิดีโอประสบความสําเร็จ

| พารามิเตอร์ | ตําแหน่ง | เงื่อนไข |
| --- | --- | --- |
| bulkId | path | จำเป็น · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### จุดสิ้นสุด

```http
GET https://api.flashdata.dev/v2/bulk-jobs/{bulkId}
X-API-Key: YOUR_API_KEY
```

### Python

บันทึก bulk_status.py ในถาดขนาดใหญ่/ ด้านข้าง bulk-created.json. คัดลอกสคริปต์ที่สมบูรณ์แล้วเรียกใช้คําสั่งด้านล่าง

#### bulk_status.py

```python
import json
import os
from pathlib import Path

import requests

bulk_id = json.loads(Path("bulk-created.json").read_text(encoding="utf-8"))["job"]["id"]
response = requests.get(
    f"https://api.flashdata.dev/v2/bulk-jobs/{bulk_id}",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
Path("bulk-job.json").write_text(json.dumps(response.json(), indent=2), encoding="utf-8")
print(json.dumps(response.json()["job"], indent=2))
```

#### ประมวลผลจากจุลภาค/

```bash
python bulk_status.py
```


### cURL / Bash

#### ประมวลผลจากจุลภาค/

```bash
BULK_ID=$(jq -er '.job.id' bulk-created.json)
curl --fail-with-body --silent --show-error \
  "https://api.flashdata.dev/v2/bulk-jobs/$BULK_ID" \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --output bulk-job.json &&
jq '.job | {id, status, counts, pauseReason, error, expiresAt}' bulk-job.json
```


- [BulkJobResponse](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="getBulkJob-responses"></a>

### การตอบโต้

| HTTP สถานะ | หมายความว่า |
| --- | --- |
| 200 | Bulk สถานะงาน |
| 401 | ต้องการการตรวจสอบสิทธิ์หรือไม่? |
| 404 | ไม่พบทรัพยากรหรือไม่ได้เป็นเจ้าของโดยผู้เรียก |

#### 200 · application/json

```json
{
  "$ref": "#/components/schemas/BulkJobResponse"
}
```


<a id="listBulkJobs"></a>

## รายการงาน

การ ตอบ รับ มี ข้อมูล และ การ เขียน ภาพ. ผ่าน pagination.nextCursor เป็นพารามิเตอร์คําร้องขอถัดไปสําหรับค้นหาเคอร์เซอร์ null. ใช้ลิมิตจาก 1 ถึง 502; ค่าปริยายคือ 20.

| พารามิเตอร์ | ตําแหน่ง | เงื่อนไข |
| --- | --- | --- |
| cursor | query | ไม่บังคับ · {"type":"string","maxLength":512} |
| limit | query | ไม่บังคับ · {"type":"integer","minimum":1,"maximum":50,"default":20} |

### จุดสิ้นสุด

```http
GET https://api.flashdata.dev/v2/bulk-jobs
X-API-Key: YOUR_API_KEY
```

### Python

บันทึก list_bulk_jobs.py ในถาดขนาดใหญ่/ ด้านข้าง bulk-created.json. คัดลอกสคริปต์ที่สมบูรณ์แล้วเรียกใช้คําสั่งด้านล่าง

#### list_bulk_jobs.py

```python
import json
import os
from pathlib import Path

import requests

response = requests.get(
    "https://api.flashdata.dev/v2/bulk-jobs?limit=20",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
print(json.dumps(response.json(), indent=2))
```

#### ประมวลผลจากจุลภาค/

```bash
python list_bulk_jobs.py
```


### cURL / Bash

#### ประมวลผลจากจุลภาค/

```bash
curl --fail-with-body --silent --show-error --max-time 30 \
  --request GET \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  "https://api.flashdata.dev/v2/bulk-jobs?limit=20"
```


- [BulkJobPage](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-BulkJobPage)
- [Problem](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="listBulkJobs-responses"></a>

### การตอบโต้

| HTTP สถานะ | หมายความว่า |
| --- | --- |
| 200 | Bulk หน้างาน |
| 401 | ต้องการการตรวจสอบสิทธิ์หรือไม่? |

#### 200 · application/json

```json
{
  "$ref": "#/components/schemas/BulkJobPage"
}
```


<a id="pauseBulkJob"></a>

## หยุดงานชั่วคราว

หยุดการส่งใหม่และบรรจุแพ็คเกจผลลัพธ์ การ มี งาน อยู่ ดําเนิน ต่อ ไป โดย มี ค่า ตั้ง และ ค่า ใช้ จ่าย เดิม. ทํางานต่อเมื่อพร้อม

| พารามิเตอร์ | ตําแหน่ง | เงื่อนไข |
| --- | --- | --- |
| bulkId | path | จำเป็น · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### จุดสิ้นสุด

```http
POST https://api.flashdata.dev/v2/bulk-jobs/{bulkId}/pause
X-API-Key: YOUR_API_KEY
```

### Python

บันทึก pause_bulk_job.py ในถาดขนาดใหญ่/ ด้านข้าง bulk-created.json. คัดลอกสคริปต์ที่สมบูรณ์แล้วเรียกใช้คําสั่งด้านล่าง

#### pause_bulk_job.py

```python
import json
import os
from pathlib import Path

import requests

bulk_id = json.loads(Path("bulk-created.json").read_text(encoding="utf-8"))["job"]["id"]
response = requests.post(
    f"https://api.flashdata.dev/v2/bulk-jobs/{bulk_id}/pause",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
print(json.dumps(response.json(), indent=2))
```

#### ประมวลผลจากจุลภาค/

```bash
python pause_bulk_job.py
```


### cURL / Bash

#### ประมวลผลจากจุลภาค/

```bash
BULK_ID=$(jq -er '.job.id' bulk-created.json)
curl --fail-with-body --silent --show-error --max-time 30 \
  --request POST \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  "https://api.flashdata.dev/v2/bulk-jobs/$BULK_ID/pause"
```


- [BulkJobResponse](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="pauseBulkJob-responses"></a>

### การตอบโต้

| HTTP สถานะ | หมายความว่า |
| --- | --- |
| 200 | หยุดงานจํานวนมากหรือสถานะที่โดดเด่นในปัจจุบันของมัน |
| 401 | ต้องการการตรวจสอบสิทธิ์หรือไม่? |
| 404 | ไม่พบทรัพยากรหรือไม่ได้เป็นเจ้าของโดยผู้เรียก |

#### 200 · application/json

```json
{
  "$ref": "#/components/schemas/BulkJobResponse"
}
```


<a id="updateBulkJob"></a>

## ปรับปรุงตัวเลือกของงานพิมพ์

ปรับปรุงตัวเลือกต่างๆ ระหว่างรอการอัปโหลด หรือขณะที่หยุดชั่วคราว ก่อนที่จะมีการอ่านค่าทั้งหมด การ มี งาน อยู่ ก็ คง ไว้ ซึ่ง สภาพ การณ์ ของ พวก เขา. หาก poping ยังคงอยู่ระหว่างดําเนินการรอและ request การตอบสนอง 409 หลังจากอ่านค่านําเข้าทั้งหมดแล้ว จะมีเพียงเอกสารรับรองการส่งเท่านั้นที่สามารถปรับปรุงได้ ตั้งค่า callback_url ถึง null เพื่อเอามันออก

ตัวอย่างนี้จะทําการลบการเรียกให้เสร็จสิ้น เพื่อเปลี่ยนตัวเลือกของแหล่ง ให้ส่งออบเจกต์ทางเลือกแทน หยุดชั่วคราวก่อนและรอให้หยุดการทํางานชั่วคราว; 409 หมายถึง ยังไม่สามารถปรับใช้การปรับปรุงได้ การ มี งาน เด็ก อยู่ ก็ ยัง คง เป็น งาน ที่ ต้อง ใช้ ความ พยายาม.

| พารามิเตอร์ | ตําแหน่ง | เงื่อนไข |
| --- | --- | --- |
| bulkId | path | จำเป็น · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### จุดสิ้นสุด

```http
PATCH https://api.flashdata.dev/v2/bulk-jobs/{bulkId}
X-API-Key: YOUR_API_KEY
```

### Python

บันทึก update_bulk_job.py ในถาดขนาดใหญ่/ ด้านข้าง bulk-created.json. คัดลอกสคริปต์ที่สมบูรณ์แล้วเรียกใช้คําสั่งด้านล่าง

#### update_bulk_job.py

```python
import json
import os
from pathlib import Path

import requests

bulk_id = json.loads(Path("bulk-created.json").read_text(encoding="utf-8"))["job"]["id"]
response = requests.patch(
    f"https://api.flashdata.dev/v2/bulk-jobs/{bulk_id}",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    json={"callback_url": None},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
print(json.dumps(response.json(), indent=2))
```

#### ประมวลผลจากจุลภาค/

```bash
python update_bulk_job.py
```


### cURL / Bash

#### ประมวลผลจากจุลภาค/

```bash
BULK_ID=$(jq -er '.job.id' bulk-created.json)
curl --fail-with-body --silent --show-error --max-time 30 \
  --request PATCH \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Content-Type: application/json' --data '{"callback_url":null}' \
  "https://api.flashdata.dev/v2/bulk-jobs/$BULK_ID"
```


- [UpdateBulkJobRequest](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-UpdateBulkJobRequest)
- [BulkJobResponse](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="updateBulkJob-responses"></a>

### การ ตอบ รับ และ การ ขอ ให้ เชมา

| HTTP สถานะ | หมายความว่า |
| --- | --- |
| 200 | ปรับปรุงสถานะงานพิมพ์ |
| 401 | ต้องการการตรวจสอบสิทธิ์หรือไม่? |
| 404 | ไม่พบทรัพยากรหรือไม่ได้เป็นเจ้าของโดยผู้เรียก |
| 409 | ความขัดแย้งของสถานะทรัพยากรหรือความไม่เข้มงวด |
| 422 | การร้องขอการตรวจสอบสิทธิ์ล้มเหลว |

#### เนื้อหาคำขอ

```json
{
  "$ref": "#/components/schemas/UpdateBulkJobRequest"
}
```

#### 200 · application/json

```json
{
  "$ref": "#/components/schemas/BulkJobResponse"
}
```


<a id="resumeBulkJob"></a>

## ทํางานต่อ

แก้ไข pauseReason อย่างแรก เช่น เพิ่มเครดิต หรือ ปรับปรุงเอกสารการจัดเก็บ แล้วกลับมาใช้เดิม Bulk ID.

| พารามิเตอร์ | ตําแหน่ง | เงื่อนไข |
| --- | --- | --- |
| bulkId | path | จำเป็น · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### จุดสิ้นสุด

```http
POST https://api.flashdata.dev/v2/bulk-jobs/{bulkId}/resume
X-API-Key: YOUR_API_KEY
```

### Python

บันทึก resume_bulk_job.py ในถาดขนาดใหญ่/ ด้านข้าง bulk-created.json. คัดลอกสคริปต์ที่สมบูรณ์แล้วเรียกใช้คําสั่งด้านล่าง

#### resume_bulk_job.py

```python
import json
import os
from pathlib import Path

import requests

bulk_id = json.loads(Path("bulk-created.json").read_text(encoding="utf-8"))["job"]["id"]
response = requests.post(
    f"https://api.flashdata.dev/v2/bulk-jobs/{bulk_id}/resume",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
print(json.dumps(response.json(), indent=2))
```

#### ประมวลผลจากจุลภาค/

```bash
python resume_bulk_job.py
```


### cURL / Bash

#### ประมวลผลจากจุลภาค/

```bash
BULK_ID=$(jq -er '.job.id' bulk-created.json)
curl --fail-with-body --silent --show-error --max-time 30 \
  --request POST \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  "https://api.flashdata.dev/v2/bulk-jobs/$BULK_ID/resume"
```


- [BulkJobResponse](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="resumeBulkJob-responses"></a>

### การตอบโต้

| HTTP สถานะ | หมายความว่า |
| --- | --- |
| 200 | สถานะงานส่วนใหญ่ในปัจจุบัน |
| 401 | ต้องการการตรวจสอบสิทธิ์หรือไม่? |
| 404 | ไม่พบทรัพยากรหรือไม่ได้เป็นเจ้าของโดยผู้เรียก |

#### 200 · application/json

```json
{
  "$ref": "#/components/schemas/BulkJobResponse"
}
```


<a id="cancelBulkJob"></a>

## ยกเลิกงาน

หยุดการยอมจํานนใหม่ งานที่มีอยู่ยังคงสามารถ finish และเข้าข่ายปกติได้ งานที่ถูกยกเลิกไม่ได้ตีพิมพ์รายการสุดท้าย

| พารามิเตอร์ | ตําแหน่ง | เงื่อนไข |
| --- | --- | --- |
| bulkId | path | จำเป็น · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### จุดสิ้นสุด

```http
DELETE https://api.flashdata.dev/v2/bulk-jobs/{bulkId}
X-API-Key: YOUR_API_KEY
```

### Python

บันทึก cancel_bulk_job.py ในถาดขนาดใหญ่/ ด้านข้าง bulk-created.json. คัดลอกสคริปต์ที่สมบูรณ์แล้วเรียกใช้คําสั่งด้านล่าง

#### cancel_bulk_job.py

```python
import json
import os
from pathlib import Path

import requests

bulk_id = json.loads(Path("bulk-created.json").read_text(encoding="utf-8"))["job"]["id"]
response = requests.delete(
    f"https://api.flashdata.dev/v2/bulk-jobs/{bulk_id}",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
print(json.dumps(response.json(), indent=2))
```

#### ประมวลผลจากจุลภาค/

```bash
python cancel_bulk_job.py
```


### cURL / Bash

#### ประมวลผลจากจุลภาค/

```bash
BULK_ID=$(jq -er '.job.id' bulk-created.json)
curl --fail-with-body --silent --show-error --max-time 30 \
  --request DELETE \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  "https://api.flashdata.dev/v2/bulk-jobs/$BULK_ID"
```


- [BulkJobResponse](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="cancelBulkJob-responses"></a>

### การตอบโต้

| HTTP สถานะ | หมายความว่า |
| --- | --- |
| 200 | สถานะงานส่วนใหญ่ในปัจจุบัน |
| 401 | ต้องการการตรวจสอบสิทธิ์หรือไม่? |
| 404 | ไม่พบทรัพยากรหรือไม่ได้เป็นเจ้าของโดยผู้เรียก |

#### 200 · application/json

```json
{
  "$ref": "#/components/schemas/BulkJobResponse"
}
```


<a id="downloadBulkJobManifest"></a>

## จง ให้ ผล ปรากฏ ออก มา

ติดตามเส้นทางที่จะดาวน์โหลด JSON แสดงและใช้ที่อยู่เชื่อมโยงของมันเพื่อเรียกเอาแฟ้มผลลัพธ์ ดึงข้อมูลที่ลงนามในคลัง URLs # หากไม่มีเธอ # API กุญแจ ยัง คง มี ผล งาน อยู่ สําหรับ 24 หนึ่งชั่วโมงหลังจากทั้งหมด Bulk งานเสร็จสมบูรณ์แล้ว

ได้รับการยืนยันแล้ว API ร้องขอกลับ 302 ด้วยส่วนหัวตําแหน่ง ดึงที่ HTTPS คลังสื่อ URL ในการร้องขอแยกโดยไม่มี X-API-Key. ตัวอย่างบันทึก manifest.json A 409 หมายความว่าผลไม่พร้อม 410 หมายความว่าพวกเขาหมดอายุแล้ว

| พารามิเตอร์ | ตําแหน่ง | เงื่อนไข |
| --- | --- | --- |
| bulkId | path | จำเป็น · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### จุดสิ้นสุด

```http
GET https://api.flashdata.dev/v2/bulk-jobs/{bulkId}/results
X-API-Key: YOUR_API_KEY
```

### Python

บันทึก bulk_manifest.py ในถาดขนาดใหญ่/ ด้านข้าง bulk-created.json. คัดลอกสคริปต์ที่สมบูรณ์แล้วเรียกใช้คําสั่งด้านล่าง

#### bulk_manifest.py

```python
import json
import os
from pathlib import Path

import requests

bulk_id = json.loads(Path("bulk-created.json").read_text(encoding="utf-8"))["job"]["id"]
response = requests.get(
    f"https://api.flashdata.dev/v2/bulk-jobs/{bulk_id}/results",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
if response.status_code != 302:
    raise RuntimeError(f"Expected a manifest redirect, got {response.status_code}")
url = response.headers["Location"]
if not url.startswith("https://"):
    raise ValueError("Expected an HTTPS storage URL")

manifest = requests.get(url, timeout=120)  # No FlashData API key.
manifest.raise_for_status()
Path("manifest.json").write_text(json.dumps(manifest.json(), indent=2), encoding="utf-8")
print(json.dumps(manifest.json(), indent=2))
```

#### ประมวลผลจากจุลภาค/

```bash
python bulk_manifest.py
```


### cURL / Bash

#### ประมวลผลจากจุลภาค/

```bash
BULK_ID=$(jq -er '.job.id' bulk-created.json)
# Only send the API key to FlashData; fetch storage URLs separately.
fetch_bulk_result() {
  local storage_url
  storage_url=$(curl --fail-with-body --silent --show-error \
    "https://api.flashdata.dev/v2/bulk-jobs/$BULK_ID/results$1" \
    --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
    --output /dev/null --write-out '%{redirect_url}') || return
  curl --fail-with-body --silent --show-error --proto '=https' \
    "${storage_url:?Expected a signed result URL}" --output "$2"
}
fetch_bulk_result '' manifest.json &&
jq '{status, counts, parts, expires_at}' manifest.json
```


- [Problem](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="downloadBulkJobManifest-responses"></a>

### การตอบโต้

| HTTP สถานะ | หมายความว่า |
| --- | --- |
| 200 | JSON แสดงผลดาวน์โหลดหลังจากทําการเปลี่ยนปลายทางแล้ว |
| 302 | ส่งตัวไปยังความเป็นส่วนตัวที่มีอายุสั้น R2 URL; API ไม่ต้องทําการส่งต่อเอกสาร · Location |
| 401 | ต้องการการตรวจสอบสิทธิ์หรือไม่? |
| 404 | ไม่พบทรัพยากรหรือไม่ได้เป็นเจ้าของโดยผู้เรียก |
| 409 | ความขัดแย้งของสถานะทรัพยากรหรือความไม่เข้มงวด |
| 410 | ผลที่ได้หมดอายุแล้ว |

#### 200 · application/json

```json
{
  "type": "object",
  "additionalProperties": true
}
```


<a id="downloadBulkJobPart"></a>

## ดาวน์โหลดส่วนผลลัพธ์

ใช้แต่ละรายการ parts[].number จาก manifest.json. จุดปลายแต่ละจุดจะคืนค่ากลับมาเป็น a 302 ถึง gzip NDJSON แฟ้ม; ดาวน์โหลดโดยไม่มี API กุญแจ, การย่อยสลาย, แล้ววิเคราะห์หนึ่ง JSON วัตถุต่อเส้น เข้าร่วมทําดัชนีที่เป็นศูนย์ ตัวอย่างการเก็บชิ้นส่วนทั้งหมดและรักษาทั้งสองส่วนndjson.gz และแฟ้มข้อมูล .njson

| พารามิเตอร์ | ตําแหน่ง | เงื่อนไข |
| --- | --- | --- |
| bulkId | path | จำเป็น · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |
| partNumber | path | จำเป็น · {"type":"integer","minimum":0} |

### จุดสิ้นสุด

```http
GET https://api.flashdata.dev/v2/bulk-jobs/{bulkId}/results/{partNumber}
X-API-Key: YOUR_API_KEY
```

### Python

บันทึก bulk_parts.py ในถาดขนาดใหญ่/ ด้านข้าง bulk-created.json. คัดลอกสคริปต์ที่สมบูรณ์แล้วเรียกใช้คําสั่งด้านล่าง

#### bulk_parts.py

```python
import json
import os
from pathlib import Path

import requests
import gzip
import shutil

bulk_id = json.loads(Path("bulk-created.json").read_text(encoding="utf-8"))["job"]["id"]
manifest = json.loads(Path("manifest.json").read_text(encoding="utf-8"))
for part in manifest["parts"]:
    number = part["number"]
    response = requests.get(
        f"https://api.flashdata.dev/v2/bulk-jobs/{bulk_id}/results/{number}",
        headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
        timeout=30, allow_redirects=False,
    )
    response.raise_for_status()
    if response.status_code != 302:
        raise RuntimeError(f"Expected a part redirect, got {response.status_code}")
    url = response.headers["Location"]
    if not url.startswith("https://"):
        raise ValueError("Expected an HTTPS storage URL")

    # Save the original gzip bytes; do not decompress twice.
    with requests.get(url, stream=True, timeout=120) as download:
        download.raise_for_status()
        with open(f"part-{number}.ndjson.gz", "wb") as file:
            download.raw.decode_content = False
            shutil.copyfileobj(download.raw, file)
    with gzip.open(f"part-{number}.ndjson.gz", "rt", encoding="utf-8") as rows:
        with open(f"part-{number}.ndjson", "w", encoding="utf-8") as file:
            for line in rows:
                file.write(line)
                print(json.dumps(json.loads(line)))
```

#### ประมวลผลจากจุลภาค/

```bash
python bulk_parts.py
```


### cURL / Bash

#### ประมวลผลจากจุลภาค/

```bash
BULK_ID=$(jq -er '.job.id' bulk-created.json)
# Only send the API key to FlashData; fetch storage URLs separately.
fetch_bulk_result() {
  local storage_url
  storage_url=$(curl --fail-with-body --silent --show-error \
    "https://api.flashdata.dev/v2/bulk-jobs/$BULK_ID/results$1" \
    --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
    --output /dev/null --write-out '%{redirect_url}') || return
  curl --fail-with-body --silent --show-error --proto '=https' \
    "${storage_url:?Expected a signed result URL}" --output "$2"
}
fetch_bulk_result '' manifest.json &&
jq '{status, counts, parts, expires_at}' manifest.json

# Run in the same Bash session as fetch_bulk_result.
jq -r '.parts[].number' manifest.json | while IFS= read -r PART; do
  fetch_bulk_result "/$PART" "part-$PART.ndjson.gz" || exit
  gzip -dc "part-$PART.ndjson.gz" > "part-$PART.ndjson" || exit
  jq -c '{index, video_id, status, results, error}' "part-$PART.ndjson"
done
```


- [Problem](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="downloadBulkJobPart-responses"></a>

### การตอบโต้

| HTTP สถานะ | หมายความว่า |
| --- | --- |
| 200 | การบีบอัดข้อมูลแบบ Gzip NDJSON ดาวน์โหลดหลังจากเปลี่ยนปลายทางแล้ว |
| 302 | ส่งตัวไปยังความเป็นส่วนตัวที่มีอายุสั้น R2 URL; API ไม่ต้องทําการส่งต่อเอกสาร · Location |
| 401 | ต้องการการตรวจสอบสิทธิ์หรือไม่? |
| 404 | ไม่พบทรัพยากรหรือไม่ได้เป็นเจ้าของโดยผู้เรียก |
| 409 | ความขัดแย้งของสถานะทรัพยากรหรือความไม่เข้มงวด |
| 410 | ผลที่ได้หมดอายุแล้ว |

#### 200 · application/x-ndjson

```json
{
  "type": "string"
}
```


<a id="states"></a>

## งาน รายงาน และ การ ยับยั้ง

ยัง คง มี ผล งาน อยู่ สําหรับ 24 หนึ่งชั่วโมงหลังจากทั้งหมด Bulk งานเสร็จสมบูรณ์แล้ว บันทึกพวกเขาก่อน expiresAt มีเดียในจุดหมายปลายทางของคุณ ทําตามนโยบายของถัง งานที่ทําเสร็จแล้ว รวมถึงวิดีโอที่ล้มเหลวด้วย counts.invalid บันทึกถูกปฏิเสธสายเข้า

| สถานะ | การกระทําถัดไป |
| --- | --- |
| awaiting_upload | อัพโหลดไฟล์แล้วโทรออก |
| running | การสํารวจเดียวกัน ID กับการถอนตัว input.complete แสดงให้เห็นว่าการสแกนเสร็จสิ้นหรือไม่ |
| paused | อ่าน pauseReason แก้ไขแล้วทําต่อ |
| finalizing | จง รอ ให้ มี การ จัด พิมพ์ ออก มา เป็น ชุด ๆ. |
| completed | ดาวน์โหลดรายการและทุกส่วน แสดงสถานะและข้อผิดพลาดของแต่ละแถว |
| failed / cancelled | ตรวจพบข้อผิดพลาดและบันทึกสถานะ ไม่ มี การ จัด พิมพ์ รายการ สุด ท้าย. |

- [ข้อผิดพลาดและรหัสสถานะ](https://flashdata.dev/th/docs/errors/reference.md)
- [กู้งาน Bulk ที่หยุดชั่วคราว](https://flashdata.dev/th/docs/guides/bulk/reference.md#controls)

<a id="storage"></a>

## การส่งแบบเก็บ

ใช้สนามเด็กเล่นเพื่อปรับแต่งผู้ให้บริการและแสดงตัวอย่างช่องข้อมูลที่ร้องขอมา ใบรับรองการจัดเก็บของลูกค้าอยู่ในวัตถุที่ถูกเลือก X-API-Key การตรวจสอบสิทธิ์เท่านั้น FlashData API ขอล่ะ

| แหล่ง | สร้างช่องข้อมูลที่ร้องขอ | ส่งแล้ว |
| --- | --- | --- |
| ข้อมูลกํากับภาพ, สําเนา, คําบรรยาย, เช็คใบอนุญาต | options.result_storage | ทางเลือก สําเนา NDJSON ชิ้นส่วนผลลัพธ์และใบรายการสําหรับถังของคุณ |
| youtube_download | options.storage | ต้องการ ส่งสื่อไปที่ถังของคุณ result_storage ถึง browser_delivery ไม่ได้รับการยอมรับ |

- [ผู้จัดทําช่องข้อมูลที่เชื่อถือได้](https://flashdata.dev/th/docs/sources/youtube_download/reference.md#storage)
- [ปรับแต่งตําแหน่งจัดเก็บข้อมูล](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#playground)

<a id="storage-layout"></a>

### ค้นหาแฟ้มส่ง

รายการข้อมูลถูกเขียนล่าสุดและรายการกุญแจออบเจ็กต์ ขนาด และ SHA-256 เช็คคัม มันแตกต่างจาก FlashData แสดงรายการที่ API ค่าเศษเสี้ยว YYYYMDD ในพาธข้อมูลที่ใช้ UTC Bulk วันที่สร้าง; ในสื่อต่าง ๆ มันใช้วันที่อัปโหลดจาก UTC ของแต่ละวิดีโอ Bulk การส่งข้อมูล OSS ต้องการข้อมูล aliyuncs.com จุดปลาย

สื่อส่วนตัว file_url ค่าที่ต้องการที่เก็บของคุณ SDK หรือการลงนาม URL จากผู้จัดหา A FlashData กุญแจไม่อนุญาตให้เข้าถึงถัง ตัวเลือกของข้อมูลกํากับภาพแบบสหายจะถูกจัดเก็บไว้ด้านข้างสื่อ การส่งข้อมูลปรากฏใน delivery.retryCount

#### การจัดวางวัตถุข้อมูล

```text
<prefix>/<source>/<bulkId>/results/part-NNNNNNNN.jsonl.gz
<prefix>/<source>/<bulkId>/manifest.json
```


<a id="webhooks"></a>

## รับเว็บฮุกที่เสร็จสมบูรณ์

เปิดเผยต่อสาธารณชน HTTPS callback_url ทางเลือกนอกกรอบ Bulk ส่งเสร็จสมบูรณ์หลังจากการลงแจ้งรายการแล้วเท่านั้น ซึ่งจะไม่ส่งเหตุการณ์หนึ่งแบบ (per- vitroo) และไม่มีเหตุการณ์ที่เสร็จสมบูรณ์สําหรับงานพิมพ์ที่ล้มเหลวหรือถูกยกเลิก ให้ผลสํารวจสถานะเป็นความล้มเหลว

1. ต่อเนื่องและลดความซับซ้อน delivery_id แล้วกลับมา 2xx ทันที การส่งของซ้ําถึงแปดครั้ง
2. เหตุการณ์ไม่แน่นอน ตรงกับหมายเลขและแหล่งไปยังใบเสร็จที่บันทึกไว้ของคุณ; ตรวจสอบเสร็จสิ้นผ่านทางการจัดการการตรวจสอบสิทธิ์ API ก่อนที่จะได้กลับมา ไม่สนใจ URLs ให้พ้นจากเหตุการณ์ที่ไม่สงบ

### สร้างการร้องขอด้วยการเรียกกลับ

```json
{
  "source": "youtube_metadata",
  "options": {
    "include_formats": false,
    "include_chapters": false
  },
  "callback_url": "https://your-app.example/webhooks/flashdata"
}
```

### ทําเหตุการณ์ให้สมบูรณ์

```json
{
  "delivery_id": "bulk-completion:bulk_EXAMPLE123",
  "id": "bulk_EXAMPLE123",
  "source": "youtube_metadata",
  "status": "completed",
  "links": [
    {
      "rel": "self",
      "href": "https://api.flashdata.dev/v2/bulk-jobs/bulk_EXAMPLE123",
      "method": "GET"
    },
    {
      "rel": "results",
      "href": "https://api.flashdata.dev/v2/bulk-jobs/bulk_EXAMPLE123/results",
      "method": "GET"
    }
  ]
}
```

- [สร้างตัวรับเว็บฮุคของโหนด](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#playground)

<a id="schemas"></a>

## นิยามการสลับรูปแบบ

- [BulkJobCreated](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-BulkJobCreated)
- [BulkJob](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-BulkJob)
- [BulkJobPage](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-BulkJobPage)
- [BulkJobResponse](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [CreateBulkJobRequest](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-CreateBulkJobRequest)
- [JobLink](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-JobLink)
- [Pagination](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-Pagination)
- [Problem](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-Problem)
- [FieldError](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-FieldError)
- [UpdateBulkJobRequest](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-UpdateBulkJobRequest)

<a id="schema-BulkJobCreated"></a>

### BulkJobCreated

#### BulkJobCreated

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "job",
    "upload"
  ],
  "properties": {
    "job": {
      "$ref": "#/components/schemas/BulkJob"
    },
    "upload": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "href",
        "method",
        "expiresAt",
        "contentType"
      ],
      "properties": {
        "href": {
          "type": "string",
          "format": "uri"
        },
        "method": {
          "type": "string",
          "const": "PUT"
        },
        "expiresAt": {
          "type": "string",
          "format": "date-time"
        },
        "contentType": {
          "type": "string",
          "const": "text/plain; charset=utf-8"
        }
      }
    }
  }
}
```

- [BulkJob](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-BulkJob)

<a id="schema-BulkJob"></a>

### BulkJob

#### BulkJob

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "id",
    "source",
    "status",
    "input",
    "counts",
    "delivery",
    "pauseReason",
    "error",
    "createdAt",
    "startedAt",
    "completedAt",
    "expiresAt",
    "links"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^bulk_[A-Za-z0-9_-]{8,}$"
    },
    "source": {
      "type": "string",
      "enum": [
        "youtube_metadata",
        "youtube_transcript",
        "youtube_captions",
        "youtube_trainability",
        "youtube_download"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "awaiting_upload",
        "running",
        "paused",
        "finalizing",
        "completed",
        "failed",
        "cancelled"
      ]
    },
    "input": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "bytes",
        "complete",
        "scannedBytes",
        "scannedLines"
      ],
      "properties": {
        "bytes": {
          "type": "integer",
          "minimum": 0
        },
        "complete": {
          "type": "boolean"
        },
        "scannedBytes": {
          "type": "integer",
          "minimum": 0
        },
        "scannedLines": {
          "type": "integer",
          "minimum": 0
        }
      }
    },
    "counts": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "accepted",
        "completed",
        "failed",
        "invalid",
        "results"
      ],
      "properties": {
        "accepted": {
          "type": "integer",
          "minimum": 0
        },
        "completed": {
          "type": "integer",
          "minimum": 0
        },
        "failed": {
          "type": "integer",
          "minimum": 0
        },
        "invalid": {
          "type": "integer",
          "minimum": 0
        },
        "results": {
          "type": "integer",
          "minimum": 0
        }
      }
    },
    "pauseReason": {
      "type": [
        "string",
        "null"
      ]
    },
    "delivery": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "customerStorage",
        "storageType",
        "uploadedParts",
        "retryCount"
      ],
      "properties": {
        "customerStorage": {
          "type": "boolean"
        },
        "storageType": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "s3",
            "s3_compatible",
            "oss",
            "gcs",
            "azure",
            "cos",
            "bos",
            "tos",
            null
          ]
        },
        "uploadedParts": {
          "type": "integer",
          "minimum": 0
        },
        "retryCount": {
          "type": "integer",
          "minimum": 0
        }
      }
    },
    "error": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "code",
            "detail"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "detail": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        }
      ]
    },
    "createdAt": {
      "type": "string",
      "format": "date-time"
    },
    "startedAt": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "completedAt": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "expiresAt": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "links": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/JobLink"
      }
    }
  }
}
```

- [JobLink](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-JobLink)

<a id="schema-BulkJobPage"></a>

### BulkJobPage

#### BulkJobPage

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "data",
    "pagination"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/BulkJob"
      }
    },
    "pagination": {
      "$ref": "#/components/schemas/Pagination"
    }
  }
}
```

- [BulkJob](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-BulkJob)
- [Pagination](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-Pagination)

<a id="schema-BulkJobResponse"></a>

### BulkJobResponse

#### BulkJobResponse

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "job"
  ],
  "properties": {
    "job": {
      "$ref": "#/components/schemas/BulkJob"
    }
  }
}
```

- [BulkJob](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-BulkJob)

<a id="schema-CreateBulkJobRequest"></a>

### CreateBulkJobRequest

#### CreateBulkJobRequest

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "source"
  ],
  "properties": {
    "source": {
      "type": "string",
      "enum": [
        "youtube_metadata",
        "youtube_transcript",
        "youtube_captions",
        "youtube_trainability",
        "youtube_download"
      ]
    },
    "options": {
      "type": "object",
      "additionalProperties": true,
      "description": "Reused for every ID. Metadata accepts include_formats and include_chapters. Transcript and captions accept language (one code or an array of 1–10 distinct codes) and auto (applies to all requested languages). Omit language to prefer en-orig, fall back to en, and return one track. With auto=true, each requested code tries its -orig track first, then the plain code. Explicit -orig codes and auto=false stay exact. languageCode identifies the selected track; requestedLanguageCode is included when it differs from the requested code. A language array returns tracks and per-language errors for each video with at least one retrieved track. If no track is retrieved, the video job fails and its reserved credits are refunded. Bulk exports use one JSONL record per video. Trainability accepts no source options. These four data sources optionally accept result_storage. Supported storage_type values are s3, s3_compatible, oss, gcs, azure, cos, bos, and tos. storage_url is the bucket name (Azure container name); object_prefix is optional. S3, S3-compatible, OSS, COS, BOS, and TOS use access_key and secret_key. S3-compatible and OSS also require a public HTTPS endpoint_url. COS, BOS, and TOS require region and use fixed provider endpoints. COS bucket names include the APPID. BOS S3-compatible HTTPS delivery supports bj, su, and hkg. GCS requires service_account with project_id, client_email, and private_key. Azure requires account_name and a container SAS sas_token with write permission. Default object_prefix is YYYYMMDD, frozen to the UTC bulk creation date. Files are written to <prefix>/<source>/<bulkId>/results/part-NNNNNNNN.jsonl.gz; manifest.json in the same bulk directory is written last. Each JSONL row includes its input index and completed, failed, or invalid status. Internal R2 results remain available through the result links for 24 hours. Download accepts the normal YouTube download parameters, requires customer storage, and does not permit browser_delivery. Download storage supports the same eight provider types and credential shapes listed above under the storage field. Download storage may include object_prefix; YYYYMMDD tokens resolve to the UTC upload date, while literal prefixes are unchanged."
    },
    "callback_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Optional public HTTPS endpoint notified once after manifest publication."
    }
  }
}
```


<a id="schema-JobLink"></a>

### JobLink

#### JobLink

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "rel",
    "href",
    "method"
  ],
  "properties": {
    "rel": {
      "type": "string",
      "enum": [
        "self",
        "results",
        "content",
        "download"
      ]
    },
    "href": {
      "type": "string",
      "format": "uri"
    },
    "method": {
      "type": "string",
      "const": "GET"
    },
    "expires_at": {
      "type": "string",
      "format": "date-time"
    },
    "filename": {
      "type": "string"
    },
    "content_type": {
      "type": "string"
    },
    "size_bytes": {
      "type": "integer",
      "minimum": 1
    }
  }
}
```


<a id="schema-Pagination"></a>

### Pagination

#### Pagination

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "hasMore",
    "limit"
  ],
  "properties": {
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "previousCursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "hasMore": {
      "type": "boolean"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  }
}
```


<a id="schema-Problem"></a>

### Problem

#### Problem

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "type",
    "title",
    "status",
    "code",
    "requestId"
  ],
  "properties": {
    "type": {
      "type": "string",
      "format": "uri-reference"
    },
    "title": {
      "type": "string"
    },
    "status": {
      "type": "integer",
      "minimum": 400,
      "maximum": 599
    },
    "code": {
      "type": "string",
      "pattern": "^[a-z0-9_]+$"
    },
    "detail": {
      "type": "string"
    },
    "requestId": {
      "type": "string",
      "pattern": "^req_"
    },
    "fieldErrors": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/FieldError"
      }
    }
  }
}
```

- [FieldError](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md#schema-FieldError)

<a id="schema-FieldError"></a>

### FieldError

#### FieldError

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "field",
    "code",
    "message"
  ],
  "properties": {
    "field": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "message": {
      "type": "string"
    }
  }
}
```


<a id="schema-UpdateBulkJobRequest"></a>

### UpdateBulkJobRequest

#### UpdateBulkJobRequest

```json
{
  "type": "object",
  "additionalProperties": false,
  "minProperties": 1,
  "properties": {
    "options": {
      "type": "object",
      "additionalProperties": true,
      "description": "Partial option update. Nested storage fields are merged so unchanged credentials do not need to be resent. Data result_storage fields are merged the same way. After all IDs have been scanned, a paused data bulk job accepts credential updates only: access_key and secret_key, GCS service_account, or Azure sas_token, depending on the storage type. The complete merged configuration is validated before it is stored."
    },
    "callback_url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri",
      "maxLength": 2048,
      "description": "Replacement completion callback, or null to remove the callback."
    }
  }
}
```

