
這個方法的實用成果是一份稽核紀錄:儲存比對結果,持續列出已核對項目、明確的無法觀看提示,以及待釐清項目。這個方法無法復原已刪除或私人影片的內容,也不要求你移除或替換項目。
從自己已有的播放清單紀錄開始
首先要問的不是哪個工具能找到更多影片,而是哪份已儲存的紀錄包含你要檢查的播放清單項目。
使用自己現有的匯出檔或清冊。匯出檔是從來源儲存下來的紀錄副本。保留原始檔案,不要修改。另建副本進行作業,避免後續檢查覆蓋先前的證據。
請私下記錄以下資料:
- 與這份紀錄相關的擁有者帳戶。
- 播放清單名稱,以及紀錄中如有提供的播放清單 ID。
- 儲存這份紀錄的日期。
- 檔案格式和來源檔案名稱。
- 紀錄涵蓋的範圍,包括所有已知缺漏。
- 來源是否保留了位置和重複項目。
ID 是識別碼,用來區分不同紀錄。播放清單 ID 用來識別播放清單。影片 ID 用來識別影片。這兩者都不同於播放清單內個別項目的 ID。
如果沒有已儲存的清冊,請先記錄這項限制,再繼續操作。你可以檢查目前的項目,並儲存看得到的證據。但你無法只靠目前的畫面,列出檢查前所有已消失的影片。
讀者遇到的問題涉及被隱藏的已刪除或私人影片項目。這個方法不以帳戶中是否有特定顯示控制項為前提。請檢查擁有者畫面實際顯示的內容。仍有缺漏的部分應繼續列為待釐清,不要假設畫面上的清單包含所有舊項目。
分別保留播放清單項目與影片資料
播放清單項目是將一部影片連結至播放清單的一筆紀錄。同一部影片可以出現在多個已儲存的位置。稽核時必須分別保留這些位置。
YouTube 官方的 `playlistItem` 資源說明了這項區別。這項資源有自己的 ID、播放清單 ID、位置和影片 ID。其中的 `snippet.publishedAt` 時間表示項目加入播放清單的時間,不是影片的發布時間。這是結構定義參考資料,不能證明本次研究曾匯出擁有者的私人播放清單。YouTube PlaylistItems 參考文件——於 2026 年 10 月 25 日查核;僅確認資源結構。
結構定義用來規定紀錄中的欄位。請使用官方結構定義,理解來源中實際包含的欄位。不要假設已儲存的檔案包含該結構定義中的所有欄位。
建立播放清單項目表,每個原始項目各佔一列:
| 儲存欄位 | 應保留的內容 |
|---|---|
| 來源檔案與資料列 | 可追溯至原始項目的參照 |
| 播放清單 ID | 已儲存的播放清單識別碼,如有提供 |
| 播放清單項目 ID | 已儲存的項目識別碼,如有提供 |
| 已儲存的位置 | 完全依照原始紀錄保留的位置 |
| 影片 ID | 已知的影片識別碼,如有提供 |
| 已儲存的標題 | 先前標題的證據,如有提供 |
| 加入播放清單的日期 | 紀錄中的加入日期,如有提供 |
| 來源備註 | 已知缺漏和欄位含義 |
這些是建議使用的稽核欄位,並非宣稱指標 Actor 會傳回這些欄位。
如果來源沒有播放清單項目 ID,請保留來源檔案與資料列參照。如果缺少影片 ID,請保留該列,並標示為待釐清。不要因為項目無法進行公開查詢,就將其刪除。
分別保留已儲存的標題與目前標題。分別保留加入播放清單的日期與影片發布日期。未知日期應維持未知。不能用今天的檢查日期,填補舊紀錄中的未知日期。
即使之後對工作用資料重新排序,也要保留已儲存的位置。依目前標題或影片發布日期排序時,不得覆蓋原始順序。
依照八個步驟進行稽核
1. 確定要檢查的清冊
說明這次稽核涵蓋哪份已儲存的播放清單紀錄。收集目前資料前,先計算其中的項目列數。這就是該份紀錄的預期項目總數。
如果紀錄只涵蓋部分播放清單,請明確說明。即使部分紀錄的比對完全正確,也仍然只是部分稽核,無法確認播放清單過去的完整內容。
2. 保留每一列播放清單項目
將來源欄位複製到工作用播放清單項目表。檢查列數是否仍與來源紀錄一致。
保留重複的影片 ID。重複 ID 不代表多了一部不重複影片,但每次出現仍是獨立的播放清單項目。也要保留缺少 ID、標題或日期的資料列。
3. 另建不重複影片 ID 清單
建立第二張表,每個不同的已知影片 ID 各佔一列。這份清單用於公開中繼資料檢查。中繼資料是描述性資料,例如標題或發布日期。
在第一張表中保留原始播放清單項目。只在第二張表中移除重複 ID。記錄每個不重複 ID 對應哪些播放清單項目列。
這項工作應以已知影片作為輸入。公開頻道探索的範圍不同,無法證明影片屬於你已儲存的播放清單。YouTube 頻道資料集指南 說明了這項不同的資料收集範圍。
4. 測試一筆已知影片輸入
先從不重複 ID 清單中選一部相關影片。使用下方的小規模 Actor 輸入範例。Actor 是在託管環境中執行的資料收集程式。Task 則是為該程式儲存的一組輸入設定。
加入更多 ID 前,先檢查結果。確認傳回的影片身分和狀態。執行完成本身,不能證明已從目標影片取得有用資料。
5. 將結果附加至原始播放清單項目
將每筆已接受的結果,與完全相同的影片 ID 配對。接著將結果附加至具有該 ID 的每個播放清單項目。這項操作稱為聯結,也就是透過共同識別碼連接資料列。
即使沒有相符結果,也要保留原始播放清單項目列。結果表不得取代已儲存的播放清單紀錄。
6. 直接檢查待釐清項目
使用擁有者帳戶開啟相關播放清單。盡可能檢查已知影片頁面與來源播放器。如果畫面顯示明確原因,請將其記錄下來。
保留原因的原文、來源、檢查時間,以及當時使用的帳戶情境。如果來源沒有提供明確原因,就讓該項目維持待釐清。不要只憑一般查詢失敗,就自行判定原因。
7. 核對數量
核對數量,是確認已儲存項目的總數與各項稽核結果的合計相同。請分別計算播放清單項目數與不重複影片 ID 數。
每個原始播放清單項目都必須有一個稽核狀態。重複出現的影片仍須各自保留原始項目列。下方的計數檢查會說明如何確認。
8. 儲存稽核紀錄,決定哪些項目需要複查
將原始清冊、工作用播放清單項目表、不重複 ID 檢查表,以及證據備註一起儲存。完成審查後,將稽核紀錄設為唯讀。
不要自動移除或替換播放清單項目。請另行決定是否再次檢查待釐清項目,或手動修改播放清單。
使用指標 Actor 檢查已知的公開影片
Chronometrica YouTube Metrics Scraper 的文件說明,它可從已知影片輸入取得公開影片的中繼資料與指標。指標是數值型的衡量資料,例如觀看次數。這項文件記載的範圍,符合稽核中的公開資料檢查階段。但這不代表該 Actor 是完整的播放清單匯出工具。
公開規格也支援限定範圍的頻道探索。這項功能無法提供影片屬於已儲存播放清單的證據。使用本方法時,請提供已知影片 ID 或直接指向影片的 URL。URL 就是網址。
下方的小規模輸入已通過靜態結構檢查。該檢查只評估輸入結構,並未實際執行資料收集:
{"maxItems":1,"startUrls":["https://www.youtube.com/watch?v=dQw4w9WgXcQ"]}將範例 URL 換成你要檢查的已知影片 URL。範例網址僅用於示範輸入結構,不能證明它能為你的播放清單提供有用結果。
`startUrls` 欄位存放提供的輸入。`maxItems` 欄位限制整次執行傳回的指標資料總列數。此處上限為一,適合首次檢查單部影片,無法用來檢查含有多個不重複 ID 的清冊。之後若要批次處理,請先設定適當上限,並確認每個目標 ID 都有對應結果或明確記錄其缺漏。
不要貼入播放清單 URL,就認為工具保證能匯出所有項目。此次固定採用的規格不支持這項說法。
你也可以開啟公開的 youtube-engagement-metrics-tracker Task。使用前請替換範例輸入。這個頁面與 Task ID 於 2026 年 10 月 25 日查得,但未檢查登入後的已儲存輸入,也未檢查其執行情況。
Actor 讀取的是公開資料。它不會讀取只有擁有者可存取的播放清單紀錄或私人影片,也無法復原私人或已刪除的內容。文件列出的公開指標欄位包含留言數,但這不代表它會收集留言紀錄。這些限制來自已查核的規格,並非實際執行測試的結果。Chronometrica Actor 規格——於 2026 年 10 月 25 日查核;公開預設建置版本的結構定義與 README,未進行付費執行。
儲存結果,同時保留缺漏紀錄
為不重複影片 ID 另建檢查表。即使結果不明,也要保留每次嘗試的輸入。
| 儲存欄位 | 用途 |
|---|---|
| 目標影片 ID | 將這次嘗試連結至已儲存的清冊 |
| `inputUrl` | 保留提交的來源 |
| `postId` | 核對傳回的影片身分 |
| `postUrl` | 保留傳回的影片網址 |
| `title` | 另行保留目前標題的證據 |
| `publishedAt` | 保留影片發布時間 |
| `status` | 保留傳回的結果狀態 |
| `scrapedAt` | 保留資料收集時間 |
| `postMetricStatus` | 保留指標是否可取得及精確程度的詳細資訊 |
| 稽核狀態與備註 | 記錄依據證據做出的判定 |
最後一列說明的是你自行建立的稽核欄位。不要將這些欄位描述為 Actor 的輸出。
接受配對結果前,先核對 `postId`。不要以標題相似程度作為聯結規則。如果結果無法明確確認身分相符,請保留這次嘗試並進一步檢查。
缺失值應維持缺失。缺少標題不代表影片已刪除。無法取得觀看次數,不等於觀看次數為零。傳回零與未提供數值的含義不同。
即使中繼資料結果已確認,仍可能有無法取得的指標。不要只因為缺少非必要的計數欄位,就將播放清單項目標示為待釐清。請一併檢視影片身分、傳回狀態與現有證據。
同樣地,取得中繼資料結果,不能證明你已播放該影片。如果播放情況很重要,請另行記錄播放器檢查,並保留該次檢查的時間與情境。這項稽核不會讓中繼資料查詢成為影片可觀看性測試。
以明確狀態區分失敗結果與直接證據
在自己的稽核中使用以下狀態。這些是作業用標籤,不是 Actor 文件定義的狀態值。
| 稽核狀態 | 所需證據 | 計數方式 |
|---|---|---|
| 目前已核對 | 已接受與已知 ID 相符的公開中繼資料 | 計入已核對項目 |
| 已明確確認無法觀看 | 直接來源顯示明確的無法觀看原因 | 計入已核對項目,並保留原因 |
| 待釐清 | 缺少 ID、結果不明,或沒有直接說明 | 計入待釐清項目 |
計數時,已核對項目包含「目前已核對」的項目,以及有明確無法觀看證據的項目。報告中也應分別列出這兩組數量。
明確原因只適用於紀錄中的檢查情境。請保留該情境。不要將特定帳戶或特定時間的觀察結果,擴大解讀為適用所有觀看者或未來所有檢查的結論。
單憑公開查詢失敗,無法區分原因是私人設定、刪除、地區限制,還是暫時性限制。Actor 規格已說明這項限制。請保留傳回狀態作為證據,但不要將它改寫成更具體的原因。Chronometrica Actor 規格——於 2026 年 10 月 25 日查核;文件記載的失敗判定限制,未進行執行測試。
如果後續檢查提供更充分的證據,請新增附有日期的結果,同時保留先前的觀察紀錄。後續查詢成功可以釐清目前的缺漏,但不一定能解釋先前嘗試失敗的原因。
找回標題也不等於復原原始內容。如果下一項工作需要取得已知影片的字幕,請參閱另一篇 YouTube 逐字稿與字幕缺失指南。不要將字幕證據納入播放清單項目的判定。
逐步說明原創虛構範例
以下是原創虛構範例。ID、項目與結果均為虛構,既不是匯出測試,也不是影片可觀看性測試。
一份已儲存的清冊包含三個播放清單項目:
| 已儲存的位置 | 影片 ID | 公開中繼資料檢查 | 稽核狀態 |
|---|---|---|---|
| 1 | A | 傳回與 A 相符的結果 | 目前已核對 |
| 2 | B | 沒有可接受的結果或直接說明 | 待釐清 |
| 3 | A | 將同一筆相符結果附加至此項目 | 目前已核對 |
不重複 ID 清單包含 A 與 B。這次虛構查詢傳回了與 A 相符的結果,但未能釐清 B。將 A 的結果附加至位置 1 與位置 3。不要將這兩個位置合併成一列。
播放清單項目數的計算如下:
3 個預期項目 = 2 個已核對項目 + 1 個待釐清項目。
另行計算影片識別碼數量如下:
2 個不重複影片 ID = 1 個已釐清的不重複影片 ID + 1 個待釐清的不重複影片 ID。
這裡有三個播放清單項目,不是三部不重複影片。有兩個已核對項目,不是兩個各自完成釐清的影片 ID。這些數量計算的是紀錄,不是人數。
在這個範例中,沒有明確證據說明 B 無法觀看的原因。因此,「已明確確認無法觀看」的項目數為零。這個零只表示該證據類別的數量,不代表 B 可以觀看、已刪除,或已設為私人。
下一步是使用擁有者帳戶,在播放清單與來源播放器中檢查 B。在直接證據說明結果之前,該項目維持待釐清。位置 1、2、3 全部保留在稽核紀錄中。
檢查完成的稽核紀錄
接受報告前,請完成以下檢查:
- 確認每一列原始播放清單項目都仍保留。
- 確認已儲存的位置與重複項目都完整保留。
- 確認缺少影片 ID 的資料列仍列為待釐清。
- 確認聯結使用影片 ID,且未捨棄沒有配對結果的播放清單項目。
- 確認加入播放清單的日期、影片發布日期與檢查時間仍分別保留。
- 確認每個具體的無法觀看原因都有直接證據。
- 確認缺失的指標值沒有被改成零。
- 確認預期項目數等於已核對項目數加上待釐清項目數。
- 分別報告不重複影片 ID 數與播放清單項目數。
- 說明清冊涵蓋的範圍,以及所有仍存在的缺漏。
報告應讓其他讀者能將每項判定追溯至已儲存的播放清單項目及其證據。總數一致只能確認計數相符,不能證明原始清冊涵蓋完整的播放清單。
來源與延伸閱讀
- YouTube Data API: PlaylistItems——於 2026 年 10 月 25 日查核;播放清單項目欄位與日期含義,並非私人播放清單匯出的證據
- Chronometrica YouTube Metrics Scraper——於 2026 年 10 月 25 日查核;公開預設建置版本的結構定義與 README,未進行付費執行或執行狀況測試
- youtube-engagement-metrics-tracker Task——於 2026 年 10 月 25 日查核;公開頁面與 Task ID 均存在,未測試已儲存的輸入或執行情況
- Reddit 播放清單提問——於 2026 年 5 月 26 日發布,2026 年 10 月 25 日查閱;僅呈現一位讀者的問題,並非需求或工具效能的證據
作者 Chronometrica · 更新日期
返回頂端 ↑

