ワークフローが作成者ではなく、ビデオURLから始まると、最初にチャンネルとその最近のビデオを取得します。 これにより、後者のメタデータやキャプションリクエストに対して、ビデオIDsの境界リストが表示されます。 このチュートリアルでは、Pythonの標準的なライブラリを使用して、チャンネルスナップショットと簡単なIDファイルを保存します。
チャンネルエンドポイントが返すもの
この youtube_channel ソースはのようなハンドルを受け入れます @jawed; この @ プレフィックスはオプションです。 params.video_limit 最近のエントリのリクエスト数をコントロールします。 1 へ へ へ へ 100, デフォルトで 20. フェーアービデオの視聴が可能です。
返された videoCount はチャンネルの動画の総数を表します。次の videos array には、このリクエストで返された最近のエントリが含まれています。 20 エントリのリクエストは、チャンネルアーカイブ全体を取得していません。このエンドポイントは、すべての履歴アップロードを歩くための文書化されたページパラメータを提供していません。
チャネル統計と画像が欠落したり、null. データの区別を保ちましょう: 利用不可の購読者数は、ゼロの購読者を持つチャネルではありません。
ハンドルと小さなコレクションの制限を設定する
作成する APIキー 利用可能なクレジットで。 より大きなワークフローを計画する前に、応答を調べるには、小さな制限から始めます。 チャネルデータの取得と、各ビデオのメタデータの取得は、API リクエストを分離します。
export FLASHDATA_API_KEY='your-api-key'
export YOUTUBE_HANDLE='@jawed'
export VIDEO_LIMIT='20'
チャネルのスナップショットとビデオIDsを保存します
このコードをそのまま保存する channel-videos.py. スクリプトは、レスポンスが完成したことを確認し、有効なビデオIDsを抽出し、元のビデオレコードをJSONに保存します。 ソース応答が重複エントリを含む場合でも、それぞれ固有のIDを一度書いています。
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
IDsを集中フォローアップリクエストに使用
チャンネル応答には、利用可能なときにIDs、タイトル、期間、ビューカウント、アップロード日、サムネイルが含まれている。 詳細については、それらのIDsの1を提出してください youtube_metadata. 読む ID 保存したファイルから、タイトルやサムネイルからパースしようとするのではなく URL.
{"source":"youtube_metadata","video_id":"REPLACE_WITH_VIDEO_ID","params":{"include_formats":false}}
同じリアルタイムエンドポイントにそのボディを送信します。 プレースホルダーは、実際の11-character IDと交換する必要があります。 代わりにキャプションが必要な場合は、 キャプション言語ガイド リクエストを提出する前に、どのトラックが受け入れられるかを決める。
繰り返しコレクションとより大きいワークロードを計画する
既に処理しているビデオIDsを保存します。 同じ下流作業を繰り返し送信することを避けるために、そのセットで将来のスナップショットを比較します。
自分のスナップショットでコレクションの時間を保持します。 カウントは変更でき、チャンネルの応答に現れた後にビデオが利用できなくなる可能性があります。
最近のビデオスナップショットは、古いアップロードや不規則な実行間アイテムを見逃すことができます。 完全なアーカイブまたは正式なイベントフィードとして記述しないでください。
複数のダウンストリームリクエストの場合、プランの制限内での非同期またはバッチ処理を選択します。 バッチグループ投稿。各項目を自由にしたり、ジョブ結果を取得する必要性を削除したりすることはありません。
詳細はこちら チャネルAPIの参照, ビデオメタデータ API とりあえず asyncとバッチガイド. まずは検索ワークフローで、 AIエージェントに検索ツールを追加.