Kiedy przepływ pracy zaczyna się od twórcy, a nie od wideo URL, najpierw pobrać kanał i jego ostatnie filmy. To daje ograniczoną listę wideo IDs dla późniejszych metadanych lub żądania podpisy. Ten poradnik zapisuje migawkę kanału i prosty plik ID przy użyciu standardowej biblioteki Python.
Co powróci do punktu końcowego kanału
W youtube_channel źródło akceptuje uchwyt taki jak @jawed; natomiast @ przedrostek jest opcjonalny. params.video_limit steruje iloma ostatnimi wpisami, o które należy zwrócić się, od 1 do 100, z domyślną wartością 20. Mniej filmów wideo może być dostępnych.
Zwrócony videoCount opisuje całkowitą liczbę wideo kanału. W videos tablica zawiera ostatnie wpisy zwrócone przez to żądanie. Prośba o wpisy 20 nie pobiera całego archiwum kanału, a ten punkt końcowy nie oferuje udokumentowanego parametru strony do chodzenia wszystkie historyczne pliki.
Statystyki kanału i obrazy mogą być brakujące lub null. Zachowaj to rozróżnienie w danych: niedostępna liczba abonentów nie jest kanałem z 0 abonentami.
Ustaw uchwyt i mały limit kolekcji
Utwórz Klawisz API z dostępnymi kredytami. Zacznij od małego limitu, aby sprawdzić odpowiedź przed planowaniem większego przepływu pracy. Dane kanału i późniejsze pobieranie metadanych każdego z filmów są oddzielnymi żądaniami API.
export FLASHDATA_API_KEY='your-api-key'
export YOUTUBE_HANDLE='@jawed'
export VIDEO_LIMIT='20'
Zapisz migawkę kanału i wideo IDs
Zapisz ten kod jako channel-videos.py. Skrypt sprawdza, czy odpowiedź została zakończona, wyciąga ważny film IDs i zachowuje oryginalne nagrania wideo w JSON. Pisze każdy unikalny ID raz, nawet jeśli odpowiedź źródłowa zawiera duplikat wpisu.
import json
import os
import re
from pathlib import Path
from urllib.request import Request, urlopen
from urllib.error import HTTPError
key = os.environ["FLASHDATA_API_KEY"]
handle = os.environ.get("YOUTUBE_HANDLE", "@jawed").strip()
limit = int(os.environ.get("VIDEO_LIMIT", "20"))
if not handle or len(handle) > 100:
raise ValueError("Use a channel handle of at most 100 characters")
if not 1 <= limit <= 100:
raise ValueError("VIDEO_LIMIT must be between 1 and 100")
request = Request(
"https://data.flashdata.dev/v1/queries/realtime",
data=json.dumps({"source": "youtube_channel", "handle": handle,
"params": {"video_limit": limit}}).encode(),
method="POST", headers={"Content-Type": "application/json", "X-API-Key": key},
)
try:
with urlopen(request, timeout=60) as response:
payload = json.load(response)
except HTTPError as error:
raise RuntimeError(f"Channel request failed: HTTP {error.code}") from error
if payload.get("error") or payload.get("status") != "done":
raise RuntimeError("Channel request did not complete. Check Request History before retrying.")
if not isinstance(payload.get("results"), list) or not payload["results"]:
raise RuntimeError("Expected a channel result")
channel = payload["results"][0]
videos = channel.get("videos")
if not isinstance(videos, list):
raise RuntimeError("Expected a videos array")
ids = list(dict.fromkeys(
row["videoId"] for row in videos
if isinstance(row.get("videoId"), str)
and re.fullmatch(r"[A-Za-z0-9_-]{11}", row["videoId"])
))
Path("channel.json").write_text(json.dumps({
"requestedHandle": handle, "requestedLimit": limit,
"channel": channel, "usage": payload.get("usage"),
}, indent=2), encoding="utf-8")
Path("video-ids.txt").write_text("".join(video_id + "\n" for video_id in ids), encoding="utf-8")
print(f"Saved {len(videos)} returned entries and {len(ids)} unique video IDs")
print("Reported channel video count:", channel.get("videoCount"))
python3 channel-videos.py
Użyj IDs, aby wyświetlić wniosek o kontynuację
Odpowiedź kanału zawiera kompaktowe rekordy wideo: IDs, tytuły, czas trwania, ilość wyświetleń, daty przesyłania i miniatury, jeśli są dostępne. Aby uzyskać dodatkowe informacje, należy przedstawić jeden z tych IDs do youtube_metadata. Odczytaj ID z zapisanego pliku, zamiast próbować przetworzyć go z tytułu lub miniatury URL.
{"source":"youtube_metadata","video_id":"REPLACE_WITH_VIDEO_ID","params":{"include_formats":false}}
Wyślij to ciało do tego samego punktu końcowego w czasie rzeczywistym. Posiadacz miejsca należy zastąpić faktycznym znakiem 11- ID. Jeśli potrzebujesz podpisy zamiast, użyj napisy w języku decydowanie, który tor jest możliwy do przyjęcia przed złożeniem wniosku.
Planować powtarzające się zbieranie i większe obciążenia robocze
Przechowuj wideo IDs, które już przerabiałeś. Porównaj przyszłe migawki z tym zestawem, aby uniknąć wielokrotnego składania tych samych prac na dole.
Zachowaj czas kolekcji z własnymi zdjęciami. Liczenia mogą się zmieniać, a wideo może stać się niedostępne po pojawieniu się w odpowiedzi kanału.
Ograniczone migawki wideo z pamięcią mogą przegapić starsze pliki lub elementy pomiędzy rzadkimi uruchomieniami. Nie należy go opisywać jako kompletnego archiwum lub dokładnego - jednorazowego kanału zdarzeń.
W przypadku wielu wniosków dotyczących dalszych etapów procesu przetwarzania należy wybrać async lub partię w granicach planu. Zgłoszenia grup wsadowych; nie powoduje to, że każda pozycja jest wolna ani nie usuwa potrzeby uzyskania wyników pracy.
Patrz Odniesienie do kanału API, Metadane wideo API oraz async i przewodnik po serii. Dla przeszukania - pierwszy przepływ pracy, odkryj dodawanie narzędzi wyszukiwania do agenta AI.