如何匯出並核對 YouTube 觀看紀錄

確定要核對的內容

讀者想取得「完整的 YouTube 觀看紀錄」。這需要做兩種不同的核對：表格是否保留了匯出的事件，以及封存檔是否涵蓋你預期的觀看紀錄。

你可以將表格與來源檔案比對。但光憑這些檔案，無法證明它們涵蓋了你歷來所有的觀看紀錄。一位帳戶擁有者在公開提問中表示，Takeout 匯出的資料不完整。這只是一則缺漏回報，不能據此得出失敗率，也無法提供保證取得完整紀錄的方法。

請準備保存以下三項紀錄：

1. 私人筆記，記下申請的封存檔及其內容。
2. 觀看事件表，保留重複觀看與原始時間。
3. 選用的公開影片表，每個影片 ID 只選取一筆結果。

ID 是用來識別項目的值。影片 ID 識別的是影片，而非觀看事件。整個流程都必須區分這兩種用途。

申請封存檔並記錄範圍

只使用你自己的 Google 帳戶。透過官方下載指南，開啟已登入帳戶的 Google Takeout 頁面。

不要依賴固定的選單路徑或檔案名稱。請查看目前可選的產品，以及可納入的資料選項。

1. 選取觀看紀錄所需的 YouTube 或帳戶活動資料。
2. 以不公開的方式記錄帳戶與所選資料。
3. 記錄申請日期。
4. 提出封存檔申請。
5. 下載該次申請提供的所有封存檔分卷。
6. 記錄封存檔建立日期、檔案格式與各分卷名稱。
7. 保留原始檔案，不要修改。
8. 開啟工作副本，確認其中包含觀看事件。

搜尋活動和訂閱資料無法證明你看過哪些影片。計算列數前，請先根據實際內容確認紀錄類型。

所選資料界定了申請範圍，也就是你要求 Google 納入的帳戶資料。請另外記錄實際收到的內容。僅選取某個類別，不能證明下載的檔案包含所有預期紀錄。

請勿公開封存檔。選用的公開查詢只需要選定的公開影片 ID 或連結，不需要封存檔或帳戶登入憑證。下載資料不會刪除雲端副本。Google 匯出範圍與限制

建立保留每筆觀看事件的表格

匯入檔案前，先閱讀實際的欄位名稱。不要假定檔案結構、日期格式或影片欄位固定不變。

為來源中的每筆觀看事件建立一列工作資料。保留所有原始欄位。加入來源參照，讓你能在未經修改的封存檔中找到該事件。

以下是建議的工作欄位，不代表 Google 保證使用這些匯出欄名。

時間戳記是儲存的日期與時間。標準化時間是另外轉換成統一格式的時間值。兩者都不應取代來源的原始值。

來源參照可定位已存封存檔中的事件。它不一定是在不同匯出檔案間保持不變的事件 ID。兩個檔案中的列號相同，不能證明是同一筆事件。

缺少影片連結，不會抹去已記載的觀看事件。請保留事件，並將影片識別資訊標記為尚未釐清。同樣地，欄位空白表示資訊缺少，不代表觀看次數為零。

釐清時間，同時保留原意

觀看時間、影片發布時間與公開查詢時間，描述的是不同事件。

只有在確定日期格式時，才能解析日期。解析是指將儲存的文字讀取為日期與時間。如果日期有歧義，在確認其意義前，必須保留尚未釐清的狀態。

1. 保留原始時間戳記，不要修改。
2. 根據來源確認日期格式。
3. 確認來源提供的時區或時差（若有）。
4. 只有在這些資訊都確定後，才能轉換時間值。
5. 將轉換後的值另存於原始值旁。
6. 記錄所有尚未釐清的時間問題。

UTC 是協調世界時，是常用的時間基準。來源時間可以釐清時，你可以保存標準化的 UTC 時間值。不要只因為電腦使用某個時區，就將該時區套用到資料。

不要將匯入時間當作觀看時間。不要用影片發布時間填補缺少的事件時間。如果之後按日分組觀看事件，請說明統計使用的時區。在將每日總數視為已核對結果之前，先釐清時間問題。

保留重複觀看，只移除已證實的匯入副本

兩筆事件可能有相同的影片 ID、標題或日期。這不代表它們是重複紀錄。

例如，早上和晚上各看一次同一部影片，仍應保留兩列。若按影片 ID 刪除資料列，就會遺失部分已記載的觀看紀錄。

去除重複紀錄，是指移除已確認為同一筆紀錄的多餘副本。只有在證據顯示匯入過程產生這些副本時，才能這樣做。例如，同一份未經修改的封存檔匯入了兩次，就可以透過封存檔、檔案與來源項目的參照來查核。

1. 計算匯入的觀看事件列數。
2. 檢查是否有任何封存檔分卷匯入了兩次。
3. 透過來源參照，找出重複複製的來源紀錄。
4. 只移除已證實的多餘副本。
5. 記錄移除的副本數量與原因。
6. 加入公開資訊前，先保存保留的事件數。

僅憑影片 ID 或時間戳記相同，無法證明兩列是同一筆紀錄的副本。涵蓋範圍重疊的封存檔，需要另外核對紀錄。不要將無法確定是否相同的紀錄強行合併為一筆事件。

決定是否需要公開影片資訊

如果核對後的事件表已能回答你的問題，就可以到此為止。

你也可以選擇加入中繼資料，補充目前的標題、頻道資訊與公開計數。中繼資料是描述某個項目的資訊。它描述影片，不代表另一筆觀看事件。

Chronometrica YouTube Metrics Scraper 是一個 Actor，也就是託管執行的資料蒐集程式。文件列出的輸入方式包括已知影片 ID 與影片連結。它也支援尋找公開頻道，但核對這份封存檔不需要使用該功能。

這個 Actor 讀取公開影片中繼資料與指標。指標是公開觀看次數或按讚數等計數。它不讀取個人觀看紀錄或私人影片，不蒐集留言文字，也不提供 YouTube Studio 的曝光次數、點閱率或觀眾續看率。

另外準備一份不含重複項目的已知公開影片 ID 清單。這樣可以減少重複的公開查詢，同時保留每筆觀看事件。逐字稿語料庫指南也會區分來源中的重複出現紀錄與不同影片的識別資訊。此處不重複的清單只用於選用的公開查詢。事件表必須保留重複觀看。

如果之後需要影片的口語內容文字，請另行參閱字幕擷取指南。字幕無法證明你是否看過影片，也無法證明觀看時間。

設定選用的公開查詢

youtube-engagement-metrics-tracker Task 提供可作為起點的預設設定。Task 是已儲存的 Actor 輸入預設設定。

所提供的證據已於 2026 年 10 月 25 日核對公開 Task 頁面及其 ID，但未檢查登入後的已存設定，也未執行 Task。

以下小型輸入範例已依據所提供的公開輸入規則通過格式檢查。JSON 是用來表示結構化資料的文字格式。

{
  "maxItems": 1,
  "startUrls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  ]
}

範例連結是輸入示例，不是依此方法取得的結果。

1. 使用前先檢查 Task 設定。
2. 將 `startUrls` 中的整份範例清單，替換為你要查詢的公開影片 ID 或連結。
3. 核對這份封存檔時，請直接輸入影片 ID 或連結。
4. 設定 `maxItems`，讓預期的公開結果列都能輸出。
5. 不要傳送私人封存檔或觀看事件資料列。
6. 先用一份你能完整檢查的小型清單執行查詢。
7. 分別保存輸入、輸出與查詢時間。

範例中的 `maxItems` 值將輸出限制為一列指標資料。如果清單較大，卻仍將此值設為一，輸出可能無法涵蓋整份清單。請比對送出的 ID 與結果，不要假定執行完成就代表已涵蓋每部預定查詢的影片。

這些是建議讀者採取的步驟。本指南未存取或測試任何私人封存檔，也未付費執行 Actor。文件記載的適用用途支持這項選用的公開查詢，但不能證明實際執行效能。

附加公開結果，同時保留所有事件

將公開輸出存放在另一份表格。完整保留傳回的原始值及其狀態資訊。

`comments` 欄位是留言數，不是留言文字。缺少的計數仍應維持無法取得的狀態。請保留表示缺少值的 `null`，不要改成零。也要保留精確程度資訊；報告中不得將經過取整的公開計數當成精確計數。Actor 輸出規格

在目前這個版本的表格中，每個已核對的影片 ID 最多選取一筆公開觀測資料。如果之後再次查詢，請另行保存，並說明使用哪一筆觀測資料。

資料表聯結是透過相符的值合併表格。將選定的公開結果匹配到具有該已核對影片 ID 的每筆事件。保留沒有相符結果的事件。如果查詢失敗且未傳回 ID，請保留送出輸入的參照，並查核匹配關係。

檢查事件數減少與增加這兩種錯誤：

1. 如果事件數減少，檢查是否移除了沒有相符結果的事件。
2. 如果事件數增加，檢查是否有多筆公開結果匹配到同一筆事件。
3. 確認每個原始事件參照都恰好保留一次。
4. 確認重複觀看仍各自保留一列。

公開查詢失敗，不能證明影片已刪除、設為私人、受地區限制或暫時無法觀看。除非另有證據確認原因，否則請將原因保留為尚未釐清。

計算示例：三筆事件與兩個影片 ID

本例為原創虛構示例。事件標籤與查詢結果皆為教學而編造，不是私人封存檔紀錄，也不是 Actor 測試結果。

一份虛構封存檔記載了 09:00 和 17:00 的影片 A 觀看事件，以及 18:00 的影片 B 觀看事件。這個簡化示例沒有提供日期或時區。請明確保留這些限制，不要從這些值計算 UTC 時間。

事件表有三列。獨立的查詢清單有兩個影片 ID：A 和 B。在這次虛構查詢中，A 傳回中繼資料，B 則沒有。

以下計算使用不同單位：

• A 的 2 筆觀看事件 + B 的 1 筆觀看事件 = 3 筆觀看事件。
• A 的 1 個不重複 ID + B 的 1 個不重複 ID = 2 個不重複影片 ID。
• 1 筆可取得中繼資料的結果 + 1 筆無法取得中繼資料的結果 = 2 筆查詢結果。
• 聯結前的 3 列事件資料 = 聯結後的 3 列事件資料。

兩筆 A 事件都附加選定的 A 中繼資料。B 在 18:00 的事件仍然保留，中繼資料則標記為無法取得。查詢失敗不會抹去已記載的觀看事件。

報告應列出三筆已記載的觀看事件，以及兩個不重複影片 ID。這些數量不是不重複人數，也不能證明封存檔包含當天的每筆觀看事件。

如果缺少 B 的公開觀看次數，請維持缺少值的狀態。聲稱公開觀看次數為零，是一項數值判斷，這次虛構查詢並不支持該判斷。

核對封存檔涵蓋範圍與尚未釐清的狀態

將申請範圍與實際包含的檔案比對。在可行時，選取部分封存檔紀錄，與你在「我的活動」中看得到的紀錄比對。記錄比對使用的帳戶、涵蓋時段與比對日期。

YouTube 說明，關閉觀看紀錄期間看過的影片不會出現在觀看紀錄中。帳戶擁有者也可以手動刪除紀錄，或使用自動刪除功能。公開影片資訊無法重建這些缺少的私人事件。YouTube 觀看紀錄控制項

請將不同問題分開處理：

某個時段沒有紀錄，不能證明觀看次數為零。最早一列的日期很久遠，也不能證明紀錄完整。成功解析只證明你的處理流程讀取了檔案，不能證明 Google 提供了過去的每筆事件。

接受表格結果前，請確認所有封存檔分卷均已核對、原始值未經修改、時間問題仍清楚保留，而且每筆保留的來源事件在聯結公開資料後都仍然存在。封存檔缺漏與查詢失敗應分開報告。