# Bulk işleme API’si

Dosya tabanlı YouTube işleri oluşturun ve kontrol edin, sonra açıklarını ve sonuç bölümlerini alın.

Canonical referans: https://flashdata.dev/tr/docs/reference/bulk-processing
İnceleme: 2026-11-05 Tarafından FlashData

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

## API deneme alanı

Bir kaynak seçip eksiksiz Python veya Bash iş akışını, tek isteği ya da örnek yanıtı kopyalayın. Oyun alanı kodu önizler; iş göndermez. Tam iş akışları yüklemeyi, durum kontrollerini ve her sonuç parçasının alınmasını kapsar.

- [Kimlik ve dosya gereksinimleri](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#prepare)
- [Göz uç noktaları](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#endpoints)
- [Batch veya Bulk?](https://flashdata.dev/tr/docs/reference/batch-and-bulk/reference.md)

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

## Endpoints

Tüm uç noktaları https://api.flashdata.dev/v2. kullanıyor Bir iş oluşturun → bir video-ID dosyasını yükleyin → → İzleme → Açıklayın ve her sonuç kısmı.

| Yöntem Yöntemi | Yol Yolu Yolu | Action Action Action |
| --- | --- | --- |
| POST | /v2/bulk-jobs | Bir Bulk işi oluşturun |
| POST | /v2/bulk-jobs/{bulkId}/start | Yüklemeye ve başlayın |
| GET | /v2/bulk-jobs/{bulkId} | İş statüsü alın |
| GET | /v2/bulk-jobs | Liste listesi |
| POST | /v2/bulk-jobs/{bulkId}/pause | Pause a job |
| PATCH | /v2/bulk-jobs/{bulkId} | Güncelleme iş seçenekleri |
| POST | /v2/bulk-jobs/{bulkId}/resume | Bir iş |
| DELETE | /v2/bulk-jobs/{bulkId} | Bir iş iptal et |
| GET | /v2/bulk-jobs/{bulkId}/results | Sonuç açıklayın |
| GET | /v2/bulk-jobs/{bulkId}/results/{partNumber} | Sonuç parçaların indirilmesi |

- [Batch veya Bulk?](https://flashdata.dev/tr/docs/reference/batch-and-bulk/reference.md)
- [End-to-end Bulk rehberi](https://flashdata.dev/tr/docs/guides/bulk/reference.md)
- [OpenAPI spesifikasyonu](https://flashdata.dev/docs/openapi.json)

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

## Doğrulama ve giriş

FLASHDATA_API_KEY'u seçilmiş kaynağa erişmekle anahtara ayarlayın. Yaratılış, kontroller ve sonuçlar için aynı anahtarı ve hesabı yeniden kullanın. İşleme, hesabın bakiyesini ve normal per-source fiyatlandırmasını kullanır. YouTube Download sahibi erişim ve options.storage gerektirir.

Bulk-api/ adında bir çalışma klasörü oluşturun ve bu örnekleri ondan çalıştırın. Oyun odasının tam tamamlanmış Python İş akışı, akış kullanımlarını kullanır Python 3.10+ standart kütüphane; bireysel Python Aşağıdaki uç nokta örnekleri istekler gerektirir; cURL Örnekler kullanım kullanımı Bash, cURL 7.76+, jq ve gzip. Her eylem için bir dil seçin, böylece tekrar çalışmaya başlamazsınız.

Giriş bir UTF-8 dosyası ile bir 11-character YouTube ID hattına kadar 2 GiB'ye kadar. IDs, URLs değil. Yüklemeden önce IDs'u tekrarlayın; tekrarlanan IDs ayrı olarak işlenir.

| Source Source Source | Paylaşılan seçenekler |
| --- | --- |
| youtube_metadata | include_formats, include_chapters |
| youtube_transcript | dil, auto |
| youtube_captions | dil, auto |
| youtube_trainability | Hiçbir seçenek yok |
| youtube_download | Media seçenekleri ve depolama destinasyonları |

### Python bağımlılık

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

- [API anahtarlar ve başlıklar](https://flashdata.dev/tr/docs/guides/headers-and-authentication/reference.md)
- [Depolama alanları](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#storage)

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

## Create request fields

| Field | Tür Türü Tipi | Kullanım Kullanımı |
| --- | --- | --- |
| source | string | Gerekli. ID her giriş için bir destek kaynağı. |
| options | object | Paylaşılan kaynak seçenekleri. Veri kaynakları result_storage'u kurabilir; YouTube Download depolama gerektirir. |
| callback_url | string | Seçmeli halk HTTPS tamamlanma çağrısını tamamlayın. Açık yayından sonra sent. |

- [Full request şema](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-CreateBulkJobRequest)
- [Webhook](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#webhooks)

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

## Bir Bulk işi oluşturun

Bir iş oluşturun, bir işletme kurmak UTF-8 Biriyle metin dosyası 11-character YouTube Video video ID per line to per line To line to upload.hrefSonra başlayın. İşi tek başına oluşturmak işlemeye başlamaz.

Bu örnek video-ids.txt'u yazar ve 201 makb'ı bulk-created.json'ya kurtarır. Bu makbuz özel ve yeniden job.id'u her sonraki istek için saklayın. Bir iş oluşturmak awaiting_upload'da bırakır; URL yükleme 15 dakika sonra sona erer.

### Endpoint

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

### Python

bulk_create.py'u toplu olarak / bulk-created.json'nun yanında kurtarın. Tamamlanan senaryoyu kopyalayın, sonra komutunu aşağıda çalıştırın.

#### 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))
```

#### Bulk-api / Run

```bash
python bulk_create.py
```


### cURL / Bash

#### Bulk-api / Run

```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/tr/docs/reference/bulk-processing/reference.md#schema-CreateBulkJobRequest)
- [BulkJobCreated](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-BulkJobCreated)
- [Problem](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Yanıtlar ve talep şemaları

| HTTP statüsü | Anlam Anlamı |
| --- | --- |
| 201 | Bulk Bir iş ile yaratılan bir iş 15- dakika doğrudan yükleme URL |
| 401 | Gerekli veya geçersiz |
| 422 | İstek doğrulama başarısız oldu |
| 503 | Gerekli bir bağımlılık veya katalog geçici olarak kullanılamaz |

#### İstek gövdesi

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

#### 201 · application/json

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


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

## Yüklemeye ve başlayın

UTF-8 video ID dosyası, 2 GiB'ye kadar (2147483648 bytes). Başlangıçta dosya değişmeden tutun.

İlk önce ilk PUT video-ids.txt makbuzun upload.href with with with ile upload.contentTypeHayır, hayır X-API-Key. Örnek aramalar sadece başarılı yüklemeden sonra başlar. Yükleme dosyasını daha sonra tutar.

| Parametre parametresi | Konum Konum Location | Gereklilik |
| --- | --- | --- |
| bulkId | path | Zorunlu · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Endpoint

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

### Python

bulk_start.py'u toplu olarak / bulk-created.json'nun yanında kurtarın. Tamamlanan senaryoyu kopyalayın, sonra komutunu aşağıda çalıştırın.

#### 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))
```

#### Bulk-api / Run

```bash
python bulk_start.py
```


### cURL / Bash

#### Bulk-api / Run

```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/tr/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Yanıtlar

| HTTP statüsü | Anlam Anlamı |
| --- | --- |
| 200 | Bulk işi başladı veya mevcut idempotent devlet |
| 401 | Gerekli veya geçersiz |
| 404 | Kaynak bulunamadı ya da çağrıcı tarafından sahip değil |
| 409 | Kaynak durumu veya idempotency çatışma |
| 422 | İstek doğrulama başarısız oldu |
| 503 | Gerekli bir bağımlılık veya katalog geçici olarak kullanılamaz |

#### 200 · application/json

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


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

## İş statüsü alın

job.status, giriş, say, pauseReason ve hata. Aynı ID'u bir gecikme ile kontrol edin; Tamamlanan, her videonun başarılı olduğu anlamına gelmez.

| Parametre parametresi | Konum Konum Location | Gereklilik |
| --- | --- | --- |
| bulkId | path | Zorunlu · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Endpoint

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

### Python

bulk_status.py'u toplu olarak / bulk-created.json'nun yanında kurtarın. Tamamlanan senaryoyu kopyalayın, sonra komutunu aşağıda çalıştırın.

#### 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))
```

#### Bulk-api / Run

```bash
python bulk_status.py
```


### cURL / Bash

#### Bulk-api / Run

```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/tr/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Yanıtlar

| HTTP statüsü | Anlam Anlamı |
| --- | --- |
| 200 | Bulk iş durumu |
| 401 | Gerekli veya geçersiz |
| 404 | Kaynak bulunamadı ya da çağrıcı tarafından sahip değil |

#### 200 · application/json

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


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

## Liste listesi

Yanıt veri ve paginasyon içeriyor. pagination.nextCursor'u bir sonraki istekte bulunan null'ye kadar kontrol parametresi olarak gönder. 1'dan 50'ye limit kullanın; varsayılan 20.

| Parametre parametresi | Konum Konum Location | Gereklilik |
| --- | --- | --- |
| cursor | query | İsteğe bağlı · {"type":"string","maxLength":512} |
| limit | query | İsteğe bağlı · {"type":"integer","minimum":1,"maximum":50,"default":20} |

### Endpoint

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

### Python

list_bulk_jobs.py'u toplu olarak / bulk-created.json'nun yanında kurtarın. Tamamlanan senaryoyu kopyalayın, sonra komutunu aşağıda çalıştırın.

#### 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))
```

#### Bulk-api / Run

```bash
python list_bulk_jobs.py
```


### cURL / Bash

#### Bulk-api / Run

```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/tr/docs/reference/bulk-processing/reference.md#schema-BulkJobPage)
- [Problem](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Yanıtlar

| HTTP statüsü | Anlam Anlamı |
| --- | --- |
| 200 | Bulk iş sayfası |
| 401 | Gerekli veya geçersiz |

#### 200 · application/json

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


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

## Pause a job

Pause yeni gönderimler ve sonuç paketleme. Mevcut işler orijinal ayarları ve suçlamaları ile devam eder. Hazırlandığında işi yeniden yapılandırın.

| Parametre parametresi | Konum Konum Location | Gereklilik |
| --- | --- | --- |
| bulkId | path | Zorunlu · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Endpoint

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

### Python

pause_bulk_job.py'u toplu olarak / bulk-created.json'nun yanında kurtarın. Tamamlanan senaryoyu kopyalayın, sonra komutunu aşağıda çalıştırın.

#### 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))
```

#### Bulk-api / Run

```bash
python pause_bulk_job.py
```


### cURL / Bash

#### Bulk-api / Run

```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/tr/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Yanıtlar

| HTTP statüsü | Anlam Anlamı |
| --- | --- |
| 200 | Pa used toplu iş veya mevcut idempotent durumu |
| 401 | Gerekli veya geçersiz |
| 404 | Kaynak bulunamadı ya da çağrıcı tarafından sahip değil |

#### 200 · application/json

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


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

## Güncelleme iş seçenekleri

Yüklemeyi beklerken Güncelleme seçenekleri veya tüm girişin okunmasından önce duraklanırken. Mevcut işler onların ayarlarını tutar. Eğer piusing hala ilerlemedeyse, bir 409 cevabı bekleyin ve yeniden deneyin. Tüm girişler okunduktan sonra, sadece teslimat bilgileri güncellenebilir. callback_url to null'yu kaldırmak için ayarlayın.

Bu örnek tamamlanma callback ayarını kaldırır. Kaynak seçeneklerini değiştirmek için options nesnesi gönderin. Önce duraklatın ve duraklatmanın uygulanmasını bekleyin; 409 güncellemenin henüz uygulanamayacağını belirtir. Mevcut alt işler özgün seçeneklerini korur.

| Parametre parametresi | Konum Konum Location | Gereklilik |
| --- | --- | --- |
| bulkId | path | Zorunlu · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Endpoint

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

### Python

update_bulk_job.py'u toplu olarak / bulk-created.json'nun yanında kurtarın. Tamamlanan senaryoyu kopyalayın, sonra komutunu aşağıda çalıştırın.

#### 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))
```

#### Bulk-api / Run

```bash
python update_bulk_job.py
```


### cURL / Bash

#### Bulk-api / Run

```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/tr/docs/reference/bulk-processing/reference.md#schema-UpdateBulkJobRequest)
- [BulkJobResponse](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Yanıtlar ve talep şemaları

| HTTP statüsü | Anlam Anlamı |
| --- | --- |
| 200 | Güncelleme toplu iş durumu |
| 401 | Gerekli veya geçersiz |
| 404 | Kaynak bulunamadı ya da çağrıcı tarafından sahip değil |
| 409 | Kaynak durumu veya idempotency çatışma |
| 422 | İstek doğrulama başarısız oldu |

#### İstek gövdesi

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

#### 200 · application/json

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


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

## Bir iş

pauseReason ilk olarak, kredi eklemek veya depolama bilgilerini güncellemek gibi, o zaman aynı Bulk ID.

| Parametre parametresi | Konum Konum Location | Gereklilik |
| --- | --- | --- |
| bulkId | path | Zorunlu · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Endpoint

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

### Python

resume_bulk_job.py'u toplu olarak / bulk-created.json'nun yanında kurtarın. Tamamlanan senaryoyu kopyalayın, sonra komutunu aşağıda çalıştırın.

#### 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))
```

#### Bulk-api / Run

```bash
python resume_bulk_job.py
```


### cURL / Bash

#### Bulk-api / Run

```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/tr/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Yanıtlar

| HTTP statüsü | Anlam Anlamı |
| --- | --- |
| 200 | Mevcut toplu iş durumu |
| 401 | Gerekli veya geçersiz |
| 404 | Kaynak bulunamadı ya da çağrıcı tarafından sahip değil |

#### 200 · application/json

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


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

## Bir iş iptal et

Yeni gönderimleri durdurun. Mevcut işler hala finish ve normal suçlamaları alabilir. İptal edilen bir iş son bir açık yayınlamaz.

| Parametre parametresi | Konum Konum Location | Gereklilik |
| --- | --- | --- |
| bulkId | path | Zorunlu · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Endpoint

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

### Python

cancel_bulk_job.py'u toplu olarak / bulk-created.json'nun yanında kurtarın. Tamamlanan senaryoyu kopyalayın, sonra komutunu aşağıda çalıştırın.

#### 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))
```

#### Bulk-api / Run

```bash
python cancel_bulk_job.py
```


### cURL / Bash

#### Bulk-api / Run

```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/tr/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Yanıtlar

| HTTP statüsü | Anlam Anlamı |
| --- | --- |
| 200 | Mevcut toplu iş durumu |
| 401 | Gerekli veya geçersiz |
| 404 | Kaynak bulunamadı ya da çağrıcı tarafından sahip değil |

#### 200 · application/json

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


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

## Sonuç açıklayın

JSON'u indirmek için yönlendirmeyi izleyin ve sonuç dosyaları almak için bağlantılarını kullanın. Fetch depolamak imzaladı URLs Seninsiz olmadan API anahtar. Sonuçlar 24 saat boyunca tüm Bulk iş tamamlandıktan sonra kullanılabilir.

Kimliği doğrulanmış API isteği Location başlığıyla 302 döndürür. Bu HTTPS depolama URL adresini X-API-Key olmadan ayrı bir istekte alın. Örnek manifest.json dosyasını kaydeder. 409 sonuçların hazır olmadığını, 410 ise süresinin dolduğunu belirtir.

| Parametre parametresi | Konum Konum Location | Gereklilik |
| --- | --- | --- |
| bulkId | path | Zorunlu · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Endpoint

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

### Python

bulk_manifest.py'u toplu olarak / bulk-created.json'nun yanında kurtarın. Tamamlanan senaryoyu kopyalayın, sonra komutunu aşağıda çalıştırın.

#### 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))
```

#### Bulk-api / Run

```bash
python bulk_manifest.py
```


### cURL / Bash

#### Bulk-api / Run

```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/tr/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Yanıtlar

| HTTP statüsü | Anlam Anlamı |
| --- | --- |
| 200 | JSON, yönlendirmeden sonra ortaya çıktı |
| 302 | Kısa süreli özel R2 URL adresine yönlendirir; API kimlik bilgileri bu adrese iletilmemelidir · Location |
| 401 | Gerekli veya geçersiz |
| 404 | Kaynak bulunamadı ya da çağrıcı tarafından sahip değil |
| 409 | Kaynak durumu veya idempotency çatışma |
| 410 | Koruma sonucu sona ermiştir |

#### 200 · application/json

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


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

## Sonuç parçaların indirilmesi

parts[].number'dan her manifest.json'u kullanın. Her uç nokta bir 302'u bir gzip NDJSON dosyasına döndürür; API anahtarı olmadan indirme, baskı, sonra bir JSON nesneyi satır başına açın. Sıfır tabanlı indekse katılın. Örnek tüm parçaları alır ve hem .ndjson.gz hem de .ndjson dosyaları tutar.

| Parametre parametresi | Konum Konum Location | Gereklilik |
| --- | --- | --- |
| bulkId | path | Zorunlu · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |
| partNumber | path | Zorunlu · {"type":"integer","minimum":0} |

### Endpoint

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

### Python

bulk_parts.py'u toplu olarak / bulk-created.json'nun yanında kurtarın. Tamamlanan senaryoyu kopyalayın, sonra komutunu aşağıda çalıştırın.

#### 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)))
```

#### Bulk-api / Run

```bash
python bulk_parts.py
```


### cURL / Bash

#### Bulk-api / Run

```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/tr/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Yanıtlar

| HTTP statüsü | Anlam Anlamı |
| --- | --- |
| 200 | Gzip-comated NDJSON, yönlendirmeden sonra indirildi |
| 302 | Kısa süreli özel R2 URL adresine yönlendirir; API kimlik bilgileri bu adrese iletilmemelidir · Location |
| 401 | Gerekli veya geçersiz |
| 404 | Kaynak bulunamadı ya da çağrıcı tarafından sahip değil |
| 409 | Kaynak durumu veya idempotency çatışma |
| 410 | Koruma sonucu sona ermiştir |

#### 200 · application/x-ndjson

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


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

## İş ülkeleri ve saklama

Sonuçlar 24 saat boyunca tüm Bulk iş tamamlandıktan sonra kullanılabilir. Onları expiresAt'dan önce kurtarın. Hedefinizde medya, kovanızın tutma politikasını takip eder. Tamamlanan bir iş başarısız videolar içerebilir; counts.invalid kayıtları giriş hatlarını reddetti.

| Devlet Devleti | Sonraki eylem |
| --- | --- |
| awaiting_upload | Dosyayı yükleyin ve başlayın. |
| running | Aynı ID'u arka tarafta; input.complete, taramanın bittiğini gösteriyor. |
| paused | pauseReason'u okuyun, onu düzeltin, sonra özgeçmiş edin. |
| finalizing | Sonuç ambalajı ve açık yayın bekleyin. |
| completed | Açık ve her bölümünü indirin. Her satırın durumu ve hatası. |
| failed / cancelled | Inspect hatası ve devlet kurtarıldı. Son bir açık yayınlanmaz. |

- [Hatalar ve durum kodları](https://flashdata.dev/tr/docs/errors/reference.md)
- [Bir duraklamalı Bulk işi yeniden keşfedin](https://flashdata.dev/tr/docs/guides/bulk/reference.md#controls)

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

## Depolama teslimatı

Bir sağlayıcıyı yapılandırmak ve tam istek alanlarını önizlemek için oyun alanını kullanın. Müşteri depolama kimlikleri seçilmiş depolama nesnesine aittir; X-API-Key yalnızca FlashData API talepleri.

| Source Source Source | Create request field field | Teslimat Teslimatı |
| --- | --- | --- |
| Metadata, transkrips, lisans kontrolleri | options.result_storage | Seçmeli. Copies NDJSON sonuç parçaları ve kovanıza açık. |
| youtube_download | options.storage | Gerekli. Aracınıza medya gönderin; result_storage ve browser_delivery kabul edilmez. |

- [Sağlayıcı credential fields](https://flashdata.dev/tr/docs/sources/youtube_download/reference.md#storage)
- [Bir depolama destinasyonunu yapılandırın](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#playground)

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

### Gönderilen dosyaları bulun

Veriler ortaya çıkıyor ve nesne anahtarlarını, boyutları ve listelerini listeliyor. SHA-256 çekler. FlashData'dan farklı, hangi API href değerlerini listeler. YYYYMMDD veri yollarında UTC Bulk oluşturma tarihi kullanır; medyada her videonun UTC yükleme tarihini kullanır. Bulk OSS veri teslimatı aliyuncs.com uç noktası gerektirir.

Özel medya file_url değerleri için depolama SDK uygulamanız veya sağlayıcının imzalı URL adresi gerekir. FlashData anahtarı bucket erişimi vermez. İsteğe bağlı meta veri dosyaları medyanın yanında saklanır. Teslimat tekrarları delivery.retryCount içinde görünür.

#### Veri nesne düzeni

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


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

## Tamamlanan bir webhook alın

Bir kamu HTTPS callback_url dış seçeneklerin dışında. Bulk sadece açık yayınlamadan sonra tamamlanıyor; video etkinliklerine hiçbir şey göndermiyor ve başarısız veya iptal edilen işler için tamamlanmamış bir olay yok. Bir geri dönüş olarak durumu ankete devam edin.

1. Persist ve deduplicate delivery_id, sonra 2xx'i hemen geri döndürür. Teslimat geri çekilme ile sekiz kez yeniden yapılır.
2. Olaylar imzalanmamış. Kurtarılan makbuza boş ve kaynak; API'u yenidentrieval'den önce gerçekleştirilmiş yönetim üzerinden doğrulayın. URLs'u açık olmayan bir olaydan görmezden gelin.

### Bir callback ile çağrı oluşturun

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

### Tamamlama olayı · illüstrasyon

```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"
    }
  ]
}
```

- [Bir Node webhook alıcı](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#playground)

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

## Schema Açıklamaları

- [BulkJobCreated](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-BulkJobCreated)
- [BulkJob](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-BulkJob)
- [BulkJobPage](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-BulkJobPage)
- [BulkJobResponse](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [CreateBulkJobRequest](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-CreateBulkJobRequest)
- [JobLink](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-JobLink)
- [Pagination](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-Pagination)
- [Problem](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-Problem)
- [FieldError](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#schema-FieldError)
- [UpdateBulkJobRequest](https://flashdata.dev/tr/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/tr/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/tr/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/tr/docs/reference/bulk-processing/reference.md#schema-BulkJob)
- [Pagination](https://flashdata.dev/tr/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/tr/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/tr/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."
    }
  }
}
```

