عندما يبدأ تدفق العمل بصانع بدلا من شريط فيديو URL، أولا استرجع القناة وأشرطة الفيديو الأخيرة. هذا يعطيك قائمة مُقيدة بالفيديو IDs من أجل الوجبات الفوقية أو طلبات الإخفاء. ويوفّر هذا التعليم لقناة مقطوعة وملف بسيط من طراز ID باستخدام المكتبة المعيارية للشركة Python.
ما عودة القناة النهائية
The youtube_channel المصدر يقبل التعامل مثل @jawed; ؛ هذا @ الـ (بريفيكس) اختياري params.video_limit ويتحكم في عدد القيود التي طلبتها مؤخراً، من 1 إلى 100، مع عجز عن سداد تكاليف 20. وقد تكون هناك أشرطة فيديو أقل.
عادوا videoCount ويصف العدد الإجمالي للفيديو في القناة. The videos ويحتوي الصفيفة على القيود التي أعيدت مؤخراً بموجب هذا الطلب. ولا يسترد طلب إدخالات من شركة 20 محفوظات القناة بأكملها، ولا توفر هذه النقطة النهائية مواصفات موثقة للمسيرة في جميع عمليات التحميل التاريخية.
إحصاءات وصور القنوات قد تكون مفقودة أو null. حافظ على هذا التمييز في بياناتكم: فالعدد غير المتوفر للمشتركين ليس قناة لا يوجد فيها أي مشترك.
وضع المقبض والحد الأدنى للمجموعات
خلق مفتاح API مع الائتمانات المتاحة ابدأ بحدّ صغير لتفتيش الاستجابة قبل التخطيط لتدفق عمل أكبر. وتفصل بين الطلبات المقدمة من شركة API بيانات القناة، ثم تُحضر بعد ذلك البيانات الوصفية الخاصة بكل شريط فيديو.
export FLASHDATA_API_KEY='your-api-key'
export YOUTUBE_HANDLE='@jawed'
export VIDEO_LIMIT='20'
وفّر طلقات القناة والفيديو IDs
احفظ هذا الرمز channel-videos.py. يتحقق السكربت من اكتمال الاستجابة، ويستخرج معرّفات الفيديو الصالحة، ويحفظ سجلات الفيديو الأصلية بصيغة JSON. يكتب كل معرّف فريد مرة واحدة حتى لو تكرر في استجابة المصدر.
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
Use the IDs for a focused follow-up request
وتشتمل استجابة القناة على سجلات فيديو مدمجة: IDs، وعناوين، ومدة، وحسابات النظر، ومواعيد الحملات، وأجهزة الإبهام عند توافرها. وللاطلاع على تفاصيل إضافية، يرجى تقديم واحدة من تلك الـ IDs إلى youtube_metadata. اقرأ ID من الملف المنقذ بدلاً من محاولة طرده من عنوان أو إبهام URL.
{"source":"youtube_metadata","video_id":"REPLACE_WITH_VIDEO_ID","params":{"include_formats":false}}
أرسل تلك الجثة إلى نفس نقطة النهاية في الوقت الحقيقي يجب أن يُستعاض عن صاحب المسكن بـ 11-منتج ID. إذا كنت بحاجة للاختباء بدلا من ذلك، استخدام دليل لغة الأسقف تقرير المسار المقبول قبل تقديم الطلب.
جمع التكاليف المتكررة وعبء العمل الأكبر
خزن الفيديو IDs كنت قد جهزت بالفعل. قارن الطلقات المستقبلية مع تلك المجموعة لتلافي تقديم نفس العمل في المجرى المائي بشكل متكرر.
حافظ على وقت التحصيل مع طلقاتك الخاصة الكونتات يمكن أن تتغير و الفيديو يمكن أن يصبح غير متاح بعد ظهوره في استجابة القناة.
قد تفوت طلقات فيديو محدودة مؤخراً تحميلات أو أصنافاً كبيرة بين الجرعات المتردية لا تصفه كمحفوظات كاملة أو بث حدث دقيق
لطلبات المعالجة اللاحقة المتعددة، اختر async أو batch ضمن حدود خطتك. تجمع الدفعة عمليات الإرسال؛ ولا تجعل عناصرها مجانية ولا تلغي ضرورة استرجاع نتائج المهام.
انظر Channel API reference, Video Metadata API و دليل الأسينك والدفعة. بحثاً عن سير العمل إضافة أدوات بحث إلى عامل في مجال مكافحة الإرهاب.