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

使用 Google Takeout 匯出你自己的 YouTube 觀看紀錄。接著核對每筆已記載的觀看事件，包括同一部影片的重複觀看。保留原始時間，並記錄封存檔的涵蓋範圍。你可以核對匯出的紀錄，但不能假定其中包含你看過的每一部影片。Google 說明，提出申請到建立封存檔之間的資料變更，可能不會納入封存檔。已刪除的資料也可能不在其中。[Google 資料下載指南](https://support.google.com/accounts/answer/3024190?hl=en-GB)

觀看事件是一次有紀錄的觀看動作。同一部影片看了兩次，就是兩筆事件。封存檔是下載下來的帳戶資料副本。主要結果應將封存檔記載的每筆觀看事件各存成一列。

你可以稍後再加入目前的公開影片資訊。請將這個步驟分開處理。公開影片資訊無法補回缺少的私人觀看事件。

## 確定要核對的內容

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

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

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

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

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

## 申請封存檔並記錄範圍

只使用你自己的 Google 帳戶。透過[官方下載指南](https://support.google.com/accounts/answer/3024190?hl=en-GB)，開啟已登入帳戶的 Google Takeout 頁面。

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

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

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

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

請勿公開封存檔。選用的公開查詢只需要選定的公開影片 ID 或連結，不需要封存檔或帳戶登入憑證。下載資料不會刪除雲端副本。[Google 匯出範圍與限制](https://support.google.com/accounts/answer/3024190?hl=en-GB)

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

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

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

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

| 工作欄位 | 應保存的內容 | 資訊缺少時的處理規則 |
| --- | --- | --- |
| 封存檔參照 | 封存檔申請或已存副本的參照 | 查明不明來源 |
| 來源檔案與事件參照 | 檔案名稱及資料列或項目位置 | 進一步處理前，先加入參照 |
| 原始活動文字 | 來源提供的活動文字原文 | 缺少文字時保留空白 |
| 原始事件時間 | 來源的原始時間戳記 | 不要以其他日期替代 |
| 來源時區 | 來源提供的時區或時差（若有） | 缺少時區時，標記為尚未釐清 |
| 標準化事件時間 | 在可行時，保存經核對並統一格式的時間值 | 在時間釐清前，先不設定 |
| 原始影片連結 | 來源的原始連結（若有） | 即使沒有連結，也要保留事件 |
| 已核對的影片 ID | 根據來源確認的影片識別資訊 | 無法確認的影片識別資訊，繼續標記為尚未釐清 |
| 時間核對狀態 | 時間是否已釐清 | 保留無法確定的原因 |
| 公開查詢狀態 | 尚未查詢、已匹配或尚未釐清 | 與封存檔涵蓋範圍分開記錄 |

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

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

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

## 釐清時間，同時保留原意

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

| 時間 | 意義 | 正確用途 |
| --- | --- | --- |
| 封存檔事件時間 | 封存檔記載觀看動作發生的時間 | 將已記載的觀看事件排序或分組 |
| 影片發布時間 | 影片發布的時間 | 描述影片 |
| 公開查詢時間 | 蒐集公開資訊的時間 | 標明公開觀測資料的時間 |
| 封存檔申請或建立時間 | 申請匯出或建立匯出資料的時間 | 描述封存檔 |

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

另外準備一份不含重複項目的已知公開影片 ID 清單。這樣可以減少重複的公開查詢，同時保留每筆觀看事件。[逐字稿語料庫指南](/zh-Hant/articles/%E5%BE%9E%E6%90%9C%E5%B0%8B%E7%B5%90%E6%9E%9C%E5%BB%BA%E7%AB%8B-youtube-%E9%80%90%E5%AD%97%E7%A8%BF%E8%AA%9E%E6%96%99%E5%BA%AB/)也會區分來源中的重複出現紀錄與不同影片的識別資訊。此處不重複的清單只用於選用的公開查詢。事件表必須保留重複觀看。

如果之後需要影片的口語內容文字，請另行參閱[字幕擷取指南](/zh-Hant/articles/%E5%8F%96%E5%BE%97-youtube-%E9%80%90%E5%AD%97%E7%A8%BF-%E6%AA%A2%E6%9F%A5%E7%BC%BA%E5%B0%91%E5%AD%97%E5%B9%95/)。字幕無法證明你是否看過影片，也無法證明觀看時間。

## 設定選用的公開查詢

[youtube-engagement-metrics-tracker Task](https://apify.com/chronometrica/youtube-metrics-scraper/examples/youtube-engagement-metrics-tracker) 提供可作為起點的預設設定。Task 是已儲存的 Actor 輸入預設設定。

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

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

```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。文件記載的適用用途支持這項選用的公開查詢，但不能證明實際執行效能。

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

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

| Actor 欄位 | 記錄內容 |
| --- | --- |
| `inputUrl` | 送出的輸入 |
| `postId` | 傳回的影片 ID（若有） |
| `postUrl` | 傳回的影片連結（若有） |
| `title` | 目前可取得的影片標題 |
| `publishedAt` | 影片發布時間值 |
| `views`, `likes`, `comments`, `remixes` | 公開計數（若可取得） |
| `postMetricStatus` | 公開影片計數的可用狀態與精確程度 |
| `status` | 傳回結果的狀態 |
| `scrapedAt` | 公開資料蒐集時間 |

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

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

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

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

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

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

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

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

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

| 虛構事件 | 影片標籤 | 原始時間 | 公開查詢結果 |
| --- | --- | --- | --- |
| E1 | A | 09:00 | 可取得中繼資料 |
| E2 | A | 17:00 | 可取得中繼資料 |
| E3 | B | 18:00 | 無法取得中繼資料 |

事件表有三列。獨立的查詢清單有兩個影片 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 觀看紀錄控制項](https://support.google.com/youtube/answer/95725?hl=en)

請將不同問題分開處理：

| 觀察到的狀態 | 可以得出的結論 | 下一項核對 |
| --- | --- | --- |
| 缺少預期的觀看紀錄檔案 | 缺少預期的封存檔內容 | 檢查所選資料與下載的分卷 |
| 無法釐清時間 | 事件時間仍不確定 | 檢查原始格式與來源時區 |
| 缺少影片 ID | 事件缺少已核對、可供查詢的影片識別資訊 | 保留事件並檢查其來源 |
| 已知 ID 尚未送出 | 尚未進行公開查詢 | 只有在需要中繼資料時才送出 |
| 公開查詢失敗 | 目前的中繼資料仍未釐清 | 保留結果，不要猜測原因 |
| 預期時段沒有紀錄 | 涵蓋範圍尚未釐清 | 比對封存檔範圍與帳戶擁有者看得到的觀看紀錄 |

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

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

## 選擇下一步

先完成私人封存檔的核對。保存申請範圍、保留的事件數、重複觀看次數、時間問題，以及發現的涵蓋缺漏。說明結果時，應稱為該封存檔記載的觀看事件。

如果這些紀錄已能回答你的問題，請保留核對後的表格及未經修改的來源檔案。如果目前的公開影片資訊有幫助，請查看 [Chronometrica YouTube Metrics Scraper](https://apify.com/chronometrica/youtube-metrics-scraper)，替換範例輸入，再用一份不含重複影片的小型清單進行查詢。將結果附加到每筆相符的事件，並保留沒有相符結果的事件。

如果仍無法確定涵蓋範圍，請說明缺少的時段或紀錄類型，以及你做過哪些核對。最終結果也必須保留這項不確定性。

## 來源與延伸閱讀

- [Google 帳戶說明：下載你的資料；已於 2026 年 10 月 25 日核對。支持封存檔申請與匯出限制的說明，但不保證觀看紀錄完整](https://support.google.com/accounts/answer/3024190?hl=en-GB)
- [YouTube 說明：觀看紀錄及其控制項；已於 2026 年 10 月 25 日核對。支持關閉觀看紀錄、刪除與自動刪除所造成限制的說明](https://support.google.com/youtube/answer/95725?hl=en)
- [Chronometrica YouTube Metrics Scraper；已於 2026 年 10 月 25 日核對公開規格。僅處理公開中繼資料，不存取私人觀看紀錄，也未進行付費執行測試](https://apify.com/chronometrica/youtube-metrics-scraper)
- [YouTube Metrics Scraper 預設建置版本的結構定義；已於 2026 年 10 月 25 日核對建置版本 1.1.2。範例輸入通過格式驗證，並非執行測試](https://api.apify.com/v2/acts/cykekv5MVPOSaBpoP/builds/default)
- [youtube-engagement-metrics-tracker Task；已於 2026 年 10 月 25 日核對公開頁面與 ID。未測試登入後的設定或實際執行](https://apify.com/chronometrica/youtube-metrics-scraper/examples/youtube-engagement-metrics-tracker)
- [帳戶擁有者針對 Takeout 匯出不完整的公開提問；於 2026 年 10 月 25 日觀察到。僅為一則缺漏回報，沒有確切發布日期，也沒有經驗證的復原方法](https://www.reddit.com/r/youtube/comments/1p0emm6/how_to_export_my_full_youtube_history/)