影片和字幕 · YouTube 縮圖下載器和元資料檢視器
oEmbed 如何傳回影片的公開標題、頻道和嵌入代碼
· 工作原理
youtube 嵌入 元資料
有一種標準的、無密鑰的方法可以向視訊網站詢問連結的公共標題、作者和嵌入 HTML。這篇文章解釋了 oEmbed、請求和回應是什麼樣的，以及工具如何在不抓取頁面的情況下顯示元資料。
標題和頻道無需加載頁面 - oEmbed 旨在回答的問題
部落客無需加載觀看頁面即可了解公共影片的當前標題和頻道。只有在訪客明確按下 Fetch 後，ToolAcre 才會向 YouTube 的 oEmbed 端點要求結構化 JSON 記錄。該序列還可以防止失敗的元資料查找與格式錯誤的 URL 混淆，因為這兩個階段有不同的證據。
首先在瀏覽器中解析連結。此預檢無需網路存取即可驗證並提取 ID，從而使格式錯誤的輸入遠離縮圖主機和元資料端點。端點提供狹隘的公共表示，而不是通用資料饋送或授權機制。
oEmbed 是什麼 - 一個小標準，網站發布一個端點，用 JSON 回答“描述此 URL”
oEmbed 是用來描述公用 URL 的請求和回應約定。在這裡，YouTube 提供了一個端點，該端點接受影片 URL 並傳回用於嵌入和歸屬的 JSON 欄位。確切的查詢在網路追蹤中非常有用，因為它顯示了請求的規範資源，而不會暴露帳戶憑證。
ToolAcre 將該端點視為天花板，而不是抓取的門。它不會檢查任何觀看頁面 HTML、內部 YouTube 服務、簽名或已登出的公開請求無法到達的內容。欄位可以存在於原始 JSON 中，但仍會在應用程式合約中有意省略，因此規範化是產品決策。這可以防止下游註釋依賴上游的意外添加。
請求 — 影片 URL 和格式參數，僅此而已，發送到 youtube.com
請求前往 https://www.youtube.com/oembed，URL 設定為規範的 https://www.youtube.com/watch?v=ID 值，格式設定為 json。不新增 API 金鑰、登入 cookie 或帳戶令牌。因此，空結果是邊界觀察，而不是標識符無效或應重試受保護資料的證據。
瀏覽器發送匿名 GET，其中省略憑證、無引薦來源網址、無儲存快取並遵循重定向。 Google 直接接收它及其 Origin 標頭； ToolAcre 在該路徑中不執行伺服器或代理程式。當上游有效負載包含該工具不承諾保留的額外欄位時，這可以保持匯出穩定。
規範化回應公開元資料欄位，而不是 oEmbed HTML
大綱承諾顯示嵌入 HTML，但 normalizeOembed 故意將該欄位排除在外。規範化物件包含標題、頻道、頻道 URL、縮圖 URL 和尺寸、播放器寬度和高度、提供者和影片 ID。單獨對故障進行分類可以幫助使用者決定是否重試、檢查回應或選擇另一個允許的來源。
每個值都受到保護：缺少的文字會得到簡單的後備，尺寸必須為正，連結必須是 HTTPS。這使得匯出的 JSON 可預測，而不意味著渲染每個原始 oEmbed 屬性。可以在 DevTools 中檢查請求，但瀏覽器記錄並不意味著由 ToolAcre 儲存或僅在本機處理。
為什麼不需要金鑰或登入 - 資料已經在頁面上公開； oEmbed 只是使其結構化
不需要金鑰，因為這是已註銷的公共元資料，但公共並不意味著通用。私人、已刪除和有年齡限制的影片不提供記錄，而停用嵌入的所有者可以引起授權回應。因此，審查失敗請求的發布者應檢查嵌入可用性和視訊可見性，而不是假設十一個字元的 ID 被錯誤解析。
缺席邊界是明確的：沒有合成視圖、喜歡、描述、標籤、持續時間、發布日期或標題。無密鑰端點不會授予超出 YouTube 選擇發布的存取權限。如果編輯電子表格需要這些省略的欄位，其作者必須使用另一個允許的來源並標記該來源，而不是將空白顯示為 oEmbed 資料。
工作範例：將 oEmbed JSON 對應到 ToolAcre 的標準化記錄中
對於成功的負載，標題映射到標題，author_name 映射到頻道，author_url 映射到channelUrl，縮圖欄位映射到嵌套圖片描述，寬度和高度映射到播放器尺寸。 provider_name 成為提供者。即使上游約定使用 YouTube 頻道的作者術語，此對應也會為匯出提供穩定的應用程式名稱。
原始 HTML 可能存在於上游，但 ToolAcre 結果和匯出不會公開它。該應用程式根據經過驗證的 ID 單獨建立自己的響應式隱私增強型 iframe，從而避免對端點標記的意外信任。消費者收到可以引用或序列化的事實，而可執行的嵌入標記仍然在標準化元資料合約之外。
這不包括什麼 - 視圖計數、描述、評論、標題和登入後的任何內容
由於離線模式、阻止程式或代理，元資料嘗試可能會在回應之前失敗；它可能會透過 HTTP 狀態失敗；或者它可以傳回具有無效 JSON 的成功狀態。每個路由都會收到不同的訊息。傳輸錯誤建議檢查瀏覽器環境，而無效的 JSON 標識已到達但無法滿足端點承諾格式的回應。
縮圖探測是獨立的，可能會看到 404、另一個錯誤、200 佔位符或無法解碼的資料。兩個分支都不會下載視頻，也不會繞過對私人、已刪除或有年齡限制的內容的限制。保持分支獨立可以讓編輯保留經過驗證的海報，即使標題歸屬暫時無法使用，也不會發明遺失的元資料。
結構化公共元資料，不顯示端點的嵌入 HTML
結果是結構化的公共元資料，而不是任意 oEmbed HTML 的副本。 ToolAcre 可以將規範化事實匯出為 JSON、Markdown、CSV 或文字，並可以從經過驗證的識別碼建立已知連結。匯出的選擇會改變表示方式，而不是範圍：每種格式都反映相同的標題、頻道、圖片、播放器、提供者和 ID 記錄。
Fetch 之後，流量由直接 i.ytimg.com 影像請求和一個規範的 oEmbed 請求組成。請求省略憑證和引薦來源網址，使用無儲存和遵循的重定向，並在瀏覽器網路面板中保持可見以進行驗證。該追蹤證明瀏覽器直接聯繫了 Google；它不顯示 ToolAcre 儲存查找，也不使操作在地化。