Chuyển đến nội dung
VI
Lấy khóa API
Duyệt tài liệu

Ví dụ

Thu thập siêu dữ liệu của một video

Quay một YouTube video ID vào danh hiệu, kênh, thời gian và số lượng có sẵn của nó. Giữ phản ứng và sử dụng bên cạnh nó.

Trên trang này

Trước khi bắt đầu

Dùng phím youtube_metadata Cho phép và tín dụng sẵn có. Chọn Python 3.10+ với yêu cầu, hoặc Bash có cURL 7.76+ và jq. Vào Windowssử dụng Git Bash cho Bash phiên bản.

1. Chọn một video

Tạo một thư mục đường thẳng video và lưu request.json ở đó. Mở một thiết bị cuối trong thư mục đó. Thay thế video_id với 11- Hồ sơ. ID từ một cái đồng hồ URL hoặc một YouTube Search kết quả; không vượt qua đầy đủ URL.

Đặt rõ cả hai cờ tùy chọn: Yêu cầu đầu tiên này bỏ qua định dạng phương tiện và chương. Nó thu thập siêu dữ liệu mà không cần tải video hoặc tiêu đề của nó.

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

2. Lấy và lưu siêu dữ liệu

Chọn một phiên bản và lưu văn lệnh bên cạnh request.json. Nó đọc FLASHDATA_API_KEY hoặc yêu cầu chìa khóa của bạn tại một dấu nhắc ẩn. Các tác nhân nên tải biến môi trường đó từ cửa hàng bí mật của họ.

Chạy với ảnh chụp...001 là thư mục xuất. Một thư mục mới gửi một yêu cầu siêu dữ liệu và lưu cách sử dụng đã báo cáo. Các tập lệnh kiểm tra một phản ứng thành công chứa chính xác một video với yêu cầu ID trước khi ghi video.json.

Cài đặt trong môi trường Python của bạn
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")
Chạy từ video-metadata /
python metadata.py snapshot-001

3. Đọc đĩa thu hình

Lưu bản in thành công <video ID> đến snapshot-001/video.json. Đọc tập tin đó cho đối tượng siêu dữ liệu đầy đủ và record.json cho yêu cầu được nộp, requested_at và sử dụng. Đọc những tập tin này không gọi cho API.

Đọc ở địa phương
python -m json.tool snapshot-001/video.json
python -m json.tool snapshot-001/record.json

Đầu ra Ví dụ

Được viết tắt, minh họa video.json. Các giá trị được trả lại khác nhau. Văn lệnh bảo tồn mọi lĩnh vực, bao gồm giá trị của null, và giữ câu trả lời đầy đủ trong result.json.

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

Đọc các cánh đồng

Tìm kiếmDùng nó đi
videoIdKỷ lục ổn định. Tên và kênh hiển thị có thể thay đổi tên.
durationĐoạn phim dài vài giây. Bảo tồn bị mất hoặc null giá trị như chưa biết.
viewCount / likeCount / commentCountCác số liệu có trong hình ảnh này. Không biết là không biết; số không là một số báo cáo.
transcriptLanguagesỨng cử ngôn ngữ để yêu cầu một tiêu đề riêng. Danh sách này không xác định được đường ray là tự động hay bằng tay.

Dùng lại ảnh chụp hay yêu cầu khác

Chạy cùng một lệnh để xây dựng lại video.json và record.json từ phản ứng được cứu rỗi. Không cần yêu cầu phím hay mạng. Sửa chữa cấp cao request.json không thay đổi dữ liệu được lưu trữ bằng ảnh chụp-001.

Dùng lại dữ liệu đã lưu
python metadata.py snapshot-001

Gồm các chương sẵn sàng

Để bao gồm các đánh dấu chương, thay thế request.json với phiên bản này và dùng một thư mục xuất mới. include_chapters: true hoặc gửi các chương đến khi có sẵn, nhưng không tạo ra chúng. Cả hai include_chapters và include_formats mặc định true khi bị bỏ qua.

video-metadata/request.json
{
  "source": "youtube_metadata",
  "video_id": "FUfGcZ092b0",
  "params": {
    "include_formats": false,
    "include_chapters": true
  }
}
Yêu cầu chụp ảnh khác
python metadata.py snapshot-002

Nếu không có siêu dữ liệu

Chuyện gì đã xảy raCách xử lý
video_id không hợp lệChỉ sử dụng 11- Hồ sơ. ID. Việc nhập chứng nhận bị dừng trước khi gửi yêu cầu.
Riêng, bị gỡ bỏ hay bị hạn chế videoCứ để thất bại như thế ID. Hãy kiểm tra lỗi nguồn, rồi chọn một video có thể truy cập, thay vì liên tục gửi cùng một mục.
Kết quả trống hoặc khác videoIdVăn lệnh dừng lại mà không cần ghi video.json. Kiểm tra yêu cầu lưu và đáp ứng trước khi dùng hồ sơ.
Thiếu số, chương hoặc ngôn ngữMột bản ghi siêu dữ liệu tương ứng vẫn có thể thành công. Bảo tồn các trường không sẵn sàng là không rõ; không điền vào chúng những giá trị đã phát minh.
401 / 403 / 402Kiểm tra chìa khóa đi. youtube_metadata cho phép và số dư trước một nỗ lực mới.
429Đọc Retry-After in response-headers.txt và chờ đợi. Văn lệnh không bao giờ tự động sao lưu.
Thời hạn, 5xx, không hợp lệ JSON hoặc thư mục không đầy đủCứ tiếp tục cố gắng và kiểm tra History trước khi nộp lại. Việc sử dụng lại thư mục của nó không đưa ra yêu cầu mới.

Lưu inspect_metadata.py bên cạnh metadata.pyVậy thì chạy đi.

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")
Kiểm tra cục bộ
python inspect_metadata.py

Dùng đoạn phim trong luồng làm việc của bạn

Sử dụng videoId để tham gia kỷ lục này vào kết quả tìm kiếm của bạn hoặc bộ dữ liệu. Để biết thêm chi tiết, xin hãy tìm một phụ đề cụ thể. Đối với một số IDs, hãy dùng hướng dẫn làm giàu. Đây là những yêu cầu khác nhau với sự cho phép và cáo buộc của riêng họ.