Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Contoh

Ambil satu data meta video

Kemudia mengubah YouTube video ID menjadi rekaman tersimpan judul, saluran, durasi dan jumlah yang tersedia. Simpan respon asli dan penggunaan bersama itu.

Pada halaman ini

Sebelum kau mulai

Gunakan kunci dengan kebenaran youtube_metadata dan kredit yang tersedia. Pilih Python 3.10+ dengan requests, atau Bash dengan cURL 7.76+ dan jq. Pada Windows, gunakan Git Bash untuk versi Bash.

1. Pilih satu video

Sekarang membuat folder video metadata dan menyimpan request.json disana. Buka terminal di dalam folder itu. Renang video_id dengan 11-karakter ID dari jam URL atau hasil YouTube Search; jangan lulus URL penuh.

Tetapkan kedua bendera opsional secara eksplisit: permintaan pertama ini mengabaikan format media dan bab. Ia mengambil data meta tanpa mengunduh video atau kapsinya.

video-metadata/request.json
{
  "source": "youtube_metadata",
  "video_id": "FUfGcZ092b0",
  "params": {
    "include_formats": false,
    "include_chapters": false
  }
}

2. Ambil dan simpan data metanya

Ia memilih salah satu versi dan menyimpan skripnya di samping request.json. Ia membaca FLASHDATA_API_KEY atau meminta kunci anda pada prompt tersembunyi. Agen-agen Agen harus memuat bahwa variabel lingkungan dari toko rahasia mereka.

Lulus dengan snapshot-001 sebagai folder keluaran. Sebuah folder baru mengirim satu pertanyaan metadata dan menyimpan penggunaannya yang dilaporkan. script checks untuk respon sukses yang berisi tepat satu video dengan ID yang diminta sebelum menulis video.json.

Pasang di lingkungan Python anda
python -m pip install requests
video-metadata/metadata.py
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")
Fuhrer Jalankan dari video-metadata/
python metadata.py snapshot-001

3. Bacalah rekaman videonya

Sidik jari sukses yang disimpan <video ID> ke snapshot-001/video.json. Baca berkas tersebut untuk objek data meta penuh dan record.json untuk permintaan yang diajukan secara tepat, requested_at dan penggunaan. Pembacaan file ini tidak membuat panggilan API.

Baca secara lokal
python -m json.tool snapshot-001/video.json
python -m json.tool snapshot-001/record.json

Contoh output

video.json. Nilai yang telah dikembalikan bervariasi. Naskah ini melestarikan setiap bidang yang tersedia, termasuk nilai null, dan menjaga respon lengkap dalam result.json.

video-metadata/snapshot-001/video.json
{
  "videoId": "FUfGcZ092b0",
  "title": "Example research video",
  "channel": "Example channel",
  "duration": 120,
  "viewCount": null,
  "transcriptLanguages": [
    "en"
  ]
}

Baca ladangnya

UkrainianGunalah untuk
videoIdCatatan kunci stabil. Gelaran dan nama tampilan saluran dapat berubah.
durationPanjang video dalam detik. Simpanan nilai hilang atau null sebagai tidak diketahui.
viewCount / likeCount / commentCountHitungan yang tersedia dalam petikan ini. Nama Null atau hilang tidak diketahui; nol adalah jumlah yang dilaporkan.
transcriptLanguagesKode Bahasa Calon Calon Anak untuk permintaan kapsi yang terpisah. Daftar ini tidak mengidentifikasi apakah trek otomatis atau manual.

Gunakan kembali snapshot atau permintaan lain

Mengelabui perintah yang sama untuk membangun kembali video.json dan record.json dari respon yang disimpan. Tidak ada kunci atau permintaan jaringan yang diperlukan. Pengeditan request.json tidak mengubah masukan yang disimpan dengan snapshot-001.

Nama data disimpan
python metadata.py snapshot-001

Termasuk bab - bab yang tersedia

Untuk menyertakan penanda bab, ganti request.json dengan versi ini dan gunakan folder keluaran baru. include_chapters: true mengembalikan bab ketika tersedia; tidak membuatnya. Baik include_chapters maupun include_formats baku ke true ketika diabaikan.

video-metadata/request.json
{
  "source": "youtube_metadata",
  "video_id": "FUfGcZ092b0",
  "params": {
    "include_formats": false,
    "include_chapters": true
  }
}
\"CURUKAN Snapshot Lain\"
python metadata.py snapshot-002

Jika data meta data meta tidak tersedia

Apa yang terjadi?Tindakan
video_id tidak sahHanya menggunakan 11-karakter ID. Pengesahan input formoid berhenti sebelum mengirim permintaan.
Private, dihapus atau video terbatasTetap gagal untuk ID. Tak perlu lagi mengirimkan barang yang sama.
Hasil kosong atau videoId yang berbedaNaskah berhenti tanpa menulis video.json. Periksa permintaan dan tanggapan yang disimpan sebelum menggunakan catatan.
Cacat, bab, atau bahasa yang hilangSebuah catatan metadata yang cocok masih bisa sukses. Simpan field yang tidak tersedia sebagai tidak diketahui; jangan isi dengan nilai-nilai yang diciptakan.
401 / 403 / 402Periksa kuncinya, youtube_metadata izin dan keseimbangan, masing-masing, sebelum percobaan baru.
429Toanny Baca Retry-After di response-headers.txt dan tunggu. Naskah tidak pernah mengulang secara otomatis.
Had waktu habis, 5xx, JSON tidak sah atau folder tidak lengkapJangan coba-coba dan periksa History sebelum mengirimkan lagi. Melepaskan kembali foldernya tidak membuat permintaan baru.

Simpan inspect_metadata.py di samping metadata.py, kemudian jalankan.

video-metadata/inspect_metadata.py
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")
Periksalah secara setempat
python inspect_metadata.py

Guna video dalam alur kerja Anda

Use videoId untuk bergabung dengan rekor ini ke hasil pencarian atau dataset anda. Untuk konten yang diucapkan, ambil gambar tertentu selanjutnya. Untuk beberapa IDs, gunakan panduan pengayaan. Ini adalah permintaan terpisah dengan izin dan tuntutan mereka sendiri.