Belgeleri incele
Örnekler
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.
Bu sayfada
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.
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.
{
"source": "youtube_metadata",
"video_id": "FUfGcZ092b0",
"params": {
"include_formats": false,
"include_chapters": false
}
}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 -m pip install requestsimport 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")
python metadata.py snapshot-001curl --version
jq --version#!/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"
bash metadata.sh snapshot-0013. 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 -m json.tool snapshot-001/video.json
python -m json.tool snapshot-001/record.jsoncat snapshot-001/video.json
cat snapshot-001/record.jsonÖ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.
{
"videoId": "FUfGcZ092b0",
"title": "Example research video",
"channel": "Example channel",
"duration": 120,
"viewCount": null,
"transcriptLanguages": [
"en"
]
}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. |
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 metadata.py snapshot-001bash metadata.sh snapshot-001Mevcut 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.
{
"source": "youtube_metadata",
"video_id": "FUfGcZ092b0",
"params": {
"include_formats": false,
"include_chapters": true
}
}python metadata.py snapshot-002bash metadata.sh snapshot-002metadata 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. |
inspect_metadata.py'un yanında metadata.py'u kurtarın, sonra onu çalıştırın.
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")python inspect_metadata.pyfor 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
doneVideoyu 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.