# Bir videonun metadata

Bir YouTube video ID'u unvanı, kanalı, süresi ve mevcut sayılardan kurtarmış bir kayıt haline getirin. Orijinal cevabı tutun ve onunla birlikte kullanın.

Canonical referans: https://flashdata.dev/tr/docs/guides/video-metadata-recipe
İnceleme: 2026-11-05 Tarafından FlashData

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

## Başlamadan önce başlamadan önce

youtube_metadata izni ve mevcut kredilerle bir anahtar kullanın. Python 3.10+ isteklerle veya Bash ile cURL 7.76+ ve jq+ ile. Onda Windows, kullanımı Git Bash Çünkü, Bash Versiyon.

- [API anahtarı alın](https://flashdata.dev/app/api-keys)
- [Ajan denemesi ve hesap bağlama](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md)
- [Krediler ve fiyatlandırma](https://flashdata.dev/tr/docs/guides/credits-and-billing/reference.md)

<a id="input"></a>

## 1. Bir video seçin

video-metadata klasörü oluşturup request.json dosyasını oraya kaydedin. O klasörde terminal açın. video_id yerine izleme URL adresinden veya YouTube Search sonucundan aldığınız 11 karakterli ID değerini yazın; tam URL adresini göndermeyin.

Her iki opsiyonlu bayrakları da açıkça ayarlayın: bu ilk istek omits medya formatları ve bölümler. Videoyu ya da komutlarını indirmeden metadata'yı alır.

### video-metadata/request.json

```json
{
  "source": "youtube_metadata",
  "video_id": "FUfGcZ092b0",
  "params": {
    "include_formats": false,
    "include_chapters": false
  }
}
```


<a id="run"></a>

## 2. Fetch ve metadata

Bir versiyon seçin ve senaryoyu request.json'nun yanında kurtarın. FLASHDATA_API_KEY'u okur veya anahtarınızı gizli bir şekilde sorar. Ajanslar bu ortamı gizli mağazalarından yüklenmelidir.

snapshot-001 ile çıkış klasörü olarak çalıştırın. Yeni bir klasör bir metadata sorgu gönderir ve rapor edilen kullanımını kurtarır. Senaryo, video.json yazmadan önce talep edilen ID ile tam bir video içeren başarılı bir yanıt için kontrol eder.

### Python

#### Python ortamınıza yükleme

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

#### video-metadata/metadata.py

```python
import argparse
import getpass
import json
import os
import re
from datetime import datetime, timezone
from pathlib import Path

import requests

parser = argparse.ArgumentParser()
parser.add_argument("folder", help="New output folder, or an existing saved snapshot")
out = Path(parser.parse_args().folder)

if not out.exists():
    body = Path("request.json").read_bytes()
    request = json.loads(body)
    if (not isinstance(request, dict) or request.get("source") != "youtube_metadata"
            or not isinstance(request.get("video_id"), str)
            or not re.fullmatch(r"[A-Za-z0-9_-]{11}", request["video_id"])):
        raise SystemExit("Use youtube_metadata and an 11-character video_id, not a URL")
    key = os.environ.get("FLASHDATA_API_KEY") or getpass.getpass("FlashData API key: ")
    if not key.strip():
        raise SystemExit("An API key is required")
    out.mkdir()
    (out / "request.json").write_bytes(body)
    (out / "requested-at.txt").write_text(
        datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"), encoding="utf-8"
    )
    try:
        response = requests.post(
            "https://data.flashdata.dev/v1/queries/realtime",
            headers={"X-API-Key": key, "Content-Type": "application/json",
                     "Accept": "application/json"},
            data=body, timeout=120, allow_redirects=False,
        )
    except requests.RequestException:
        raise SystemExit(f"Request interrupted. Keep {out} and check History before retrying.")
    (out / "result.json").write_bytes(response.content)
    (out / "response-headers.txt").write_text(
        "\n".join(f"{k}: {v}" for k, v in response.headers.items()), encoding="utf-8"
    )
    (out / "http-status.txt").write_text(str(response.status_code), encoding="utf-8")
else:
    print(f"Reading saved response from {out}; no API call.")

if not (out / "http-status.txt").exists():
    raise SystemExit("Incomplete attempt. Keep the folder and check History before retrying.")
status = (out / "http-status.txt").read_text().strip()
if status != "200":
    raise SystemExit(f"HTTP {status}: inspect {out}/result.json and response-headers.txt")
try:
    data = json.loads((out / "result.json").read_bytes())
except ValueError:
    raise SystemExit("Invalid JSON; inspect the saved result.json")
request = json.loads((out / "request.json").read_bytes())
if not isinstance(data, dict) or data.get("source") != "youtube_metadata" or data.get("status") != "done":
    raise SystemExit("Metadata request did not finish successfully; inspect result.json")
videos = data.get("results")
if (not isinstance(videos, list) or len(videos) != 1 or not isinstance(videos[0], dict)
        or videos[0].get("videoId") != request["video_id"]):
    raise SystemExit("Expected one metadata object matching the requested video_id")
record = {
    "request": request,
    "requested_at": (out / "requested-at.txt").read_text().strip(),
    "usage": data.get("usage"), "result_file": "result.json",
}
for filename, value in (("video.json", videos[0]), ("record.json", record)):
    (out / filename).write_text(json.dumps(value, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
print(f"Saved {videos[0]['videoId']} to {out}/video.json")
```

#### Video-metadata / Run from Video-metadata /

```bash
python metadata.py snapshot-001
```


### Bash

#### Araçlarınızı kontrol edin

```bash
curl --version
jq --version
```

#### video-metadata/metadata.sh

```bash
#!/usr/bin/env bash
set -euo pipefail
out="${1:?Usage: bash metadata.sh OUTPUT_FOLDER}"

if [[ ! -e "$out" ]]; then
  jq -e '.source == "youtube_metadata" and
    (.video_id | if type == "string" then length == 11 and test("^[A-Za-z0-9_-]{11}$")
     else false end)' request.json > /dev/null
  if [[ -z "${FLASHDATA_API_KEY:-}" ]]; then
    read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
    printf '\n'
  fi
  : "${FLASHDATA_API_KEY:?An API key is required}"
  mkdir -- "$out"
  cp request.json "$out/request.json"
  date -u +'%Y-%m-%dT%H:%M:%SZ' > "$out/requested-at.txt"
  curl --fail-with-body --silent --show-error --max-time 120 \
    --request POST 'https://data.flashdata.dev/v1/queries/realtime' \
    --header "X-API-Key: $FLASHDATA_API_KEY" \
    --header 'Content-Type: application/json' --header 'Accept: application/json' \
    --data-binary "@$out/request.json" \
    --dump-header "$out/response-headers.txt" --output "$out/result.json" \
    --write-out '%{http_code}' > "$out/http-status.txt" || {
      printf 'Request failed. Keep %s and inspect its saved files before retrying.\n' "$out" >&2
      exit 1
    }
else
  printf 'Reading saved response from %s; no API call.\n' "$out"
fi

if [[ ! -f "$out/http-status.txt" ]] || [[ "$(cat "$out/http-status.txt")" != 200 ]]; then
  printf 'Incomplete or failed attempt. Inspect the saved files and History before retrying.\n' >&2
  exit 1
fi
video=$(jq -e --slurpfile request "$out/request.json" '
  if .source != "youtube_metadata" or .status != "done"
  then error("Expected a successful youtube_metadata response") else . end
  | .results
  | if type != "array" then error("Expected a metadata array")
    elif length != 1 then error("Expected exactly one video") else .[0] end
  | if type != "object" then error("Expected a metadata object")
    elif .videoId != $request[0].video_id then error("Returned videoId does not match the request")
    else . end' "$out/result.json")
printf '%s\n' "$video" > "$out/video.json"
jq --slurpfile request "$out/request.json" \
  --arg requested_at "$(tr -d '\r\n' < "$out/requested-at.txt")" \
  '{request: $request[0], requested_at: $requested_at, usage, result_file: "result.json"}' \
  "$out/result.json" > "$out/record.json"
printf 'Saved %s to %s/video.json\n' "$(jq -r .videoId "$out/video.json")" "$out"
```

#### Video-metadata / Run from Video-metadata /

```bash
bash metadata.sh snapshot-001
```



<a id="output"></a>

## 3. Video kayıtlarını okuyun

Başarı baskıları <video ID> snapshot-001/video.json. Tam metadata nesnesi ve record.json için tam sunulan istek için bu dosyayı okuyun, requested_at ve kullanımı. Bu dosyaları okumak, API çağrısını yapmaz.

### Python

#### Yerel olarak okuyun

```bash
python -m json.tool snapshot-001/video.json
python -m json.tool snapshot-001/record.json
```


### Bash

#### Yerel olarak okuyun

```bash
cat snapshot-001/video.json
cat snapshot-001/record.json
```



<a id="expected"></a>

### Örnek çıktı

Abbreviated, illüstrasyonel video.json. Geri dönen değerler değişir. Senaryo, null değerleri de dahil olmak üzere mevcut her alanı korur ve result.json'da tam yanıt tutar.

#### video-metadata/snapshot-001/video.json

```json
{
  "videoId": "FUfGcZ092b0",
  "title": "Example research video",
  "channel": "Example channel",
  "duration": 120,
  "viewCount": null,
  "transcriptLanguages": [
    "en"
  ]
}
```


<a id="fields"></a>

### alanları okuyun

| Field | Bunu için kullanın |
| --- | --- |
| videoId | Kaydın stabil anahtarı. Başlık ve kanal ekran isimleri değişebilir. |
| duration | Video uzunluğu saniyede. Eksik veya null değerleri bilinmeyen olarak koruma. |
| viewCount / likeCount / commentCount | Bu snapshot'da mevcut saylar. Null veya eksik bilinmemektedir; sıfır raporlanmış bir sayıdır. |
| transcriptLanguages | Ayrı bir komut isteği için güncel dil kodları. Bu liste, bir iznin otomatik veya manuel olup olmadığını tanımlamaz. |


<a id="reuse"></a>

## snapshot'ı yeniden kullanın veya başka bir şey talep edin

video.json ve record.json'u kurtarma cevabından yeniden inşa etmek için aynı komutu çalıştırın. Anahtar veya ağ isteği gerekli değildir. Üst düzey request.json, snapshot-001 ile depolanan girdiyi değiştirmez.

### Python

#### Reuse kaydedilen veriler

```bash
python metadata.py snapshot-001
```


### Bash

#### Reuse kaydedilen veriler

```bash
bash metadata.sh snapshot-001
```


- [Kaydet ve tekrarlama sonuçları](https://flashdata.dev/tr/docs/guides/save-results/reference.md)

<a id="chapters"></a>

### Mevcut bölümler ekleyin

Bölüm işaretleyicilerini içerecek şekilde, request.json'u bu sürümle değiştir ve yeni bir çıkış klasörü kullanın. include_chapters: true mevcut olduğunda bölümler döndürür; onları yaratmaz. Hem include_chapters hem de include_formats varsayılan olarak true'ye karşı varsayılan olarak.

#### video-metadata/request.json

```json
{
  "source": "youtube_metadata",
  "video_id": "FUfGcZ092b0",
  "params": {
    "include_formats": false,
    "include_chapters": true
  }
}
```

#### Python

##### Başka bir snapshot talep edin

```bash
python metadata.py snapshot-002
```


#### Bash

##### Başka bir snapshot talep edin

```bash
bash metadata.sh snapshot-002
```


- [Metadata alanları ve seçenekleri](https://flashdata.dev/tr/docs/sources/youtube_metadata/reference.md)

<a id="recover"></a>

## metadata kullanılamıyorsa

| Ne oldu? | Yapılacak işlem |
| --- | --- |
| Invalid video_id | Sadece 11-character ID kullanın. Giriş isteği göndermeden önce geçerlilik durur. |
| Özel, kaldırıldı veya sınırlı video | Bu ID için başarısızlık tutun. Kaynak hatasına göz atın ve aynı öğeyi defalarca göndermek yerine erişilebilir bir video seçin. |
| Boş sonuç veya farklı bir videoId | Senaryo video.json yazmadan durur. Kaydı kullanmadan önce kaydedilen istek ve yanıt.Inspect the save request and response before using the record. |
| Eksik sayılar, bölümler veya diller | Eşleşen meta veri kaydı yine de başarılı olabilir. Kullanılamayan alanları bilinmiyor olarak koruyun; uydurma değerlerle doldurmayın. |
| 401 / 403 / 402 | Anahtarı kontrol edin, youtube_metadata izni ve dengesi, sırasıyla, yeni bir denemeden önce. |
| 429 | Retry-After'de response-headers.txt'da okuyun ve bekleyin. Senaryo asla otomatik olarak yeniden yazmıyor. |
| Timeout, 5xx, geçersiz JSON veya eksik bir klasör | Tekrar göndermeden önce History'u deneyin ve kontrol edin. klasörü yeniden kullanmak yeni bir istek yapmaz. |

### Python

inspect_metadata.py'un yanında metadata.py'u kurtarın, sonra onu çalıştırın.

#### video-metadata/inspect_metadata.py

```python
from pathlib import Path

for name in ("http-status.txt", "response-headers.txt", "result.json"):
    path = Path("snapshot-001") / name
    print(f"--- {name} ---")
    print(path.read_text(encoding="utf-8", errors="replace") if path.exists() else "Not saved")
```

#### Inspect yerel olarak

```bash
python inspect_metadata.py
```


### Bash

#### Inspect yerel olarak

```bash
for name in http-status.txt response-headers.txt result.json; do
  printf '\n--- %s ---\n' "$name"
  if [[ -f "snapshot-001/$name" ]]; then cat "snapshot-001/$name"; else printf 'Not saved\n'; fi
done
```


- [Tarih İstek Tarihi](https://flashdata.dev/app/jobs)
- [Hatalar ve durum kodları](https://flashdata.dev/tr/docs/errors/reference.md)

<a id="next"></a>

## Videoyu iş akışınızda kullanın

videoId'u arama sonuçlarınıza veya veri setinize katılmak için kullanın. Konuşma içeriği için, bir sonraki belirli bir satır takip edin. Birkaç IDs için zenginleştirme kılavuzunu kullanın. Bunlar kendi izni ve suçlamaları ile ayrı taleplerdir.

- [Erişim süreleri silinmiş](https://flashdata.dev/tr/docs/guides/timestamped-captions-recipe/reference.md)
- [En zengin seçilmiş video IDs](https://flashdata.dev/tr/docs/guides/enrich-youtube-videos/reference.md)
