Chronometrica 與 CheapAPI：哪款 YouTube 留言擷取工具符合你的回覆需求？

選擇評估所需的證據

頂層留言會開啟一個討論串。回覆是在該討論串內作出的回應。上層留言是指該則回覆所屬的留言。

評估教學影片時，這2種資料列可以回答不同的問題。頂層留言文字可能顯示觀眾最先提出的問題。回覆文字可能顯示其他觀眾如何回答這些問題。上層留言連結能保留兩者之間的關係。

用1句話寫下你的評估問題。例如：「我需要閱讀觀眾在這堂課相關問題下提供的答案。」這項需求需要回覆文字。「我需要依回應數量，為最初提出的問題排序」則需要數量，但未必需要回應內容。

不要只因為工具能傳回更多文字，就收集額外文字。更多資料列會增加閱讀工作。每則回覆也需要足夠的討論串上下文，才能理解其意思。像「這樣就成功了」這種簡短回應，如果沒有上層留言，就可能難以解讀。

如果評估需要這類上下文，Chronometrica 的文件記載會將回覆列為獨立資料列。相關欄位包括 `parentCommentId`、`isReply`、`replyDepth` 與 `replyCount`。這些欄位可協助區分回覆資料列及其所屬的留言。Chronometrica 功能規格

Actor 是託管的資料收集程式。這裡的選擇重點，是輸出必須包含哪些內容。先決定所需證據，再選擇文件記載會提供該證據的 Actor。

比較文件記載的結果類型

下表著重於會改變推薦結果的選擇條件。

資料來源：Chronometrica 功能規格、Chronometrica 輸入結構定義、CheapAPI 功能規格、CheapAPI 輸入結構定義。

結構定義列出可接受的輸入欄位及其規則。準備輸入資料時，請查閱結構定義，因為產品的設定選項可能改變。

限制不同，不能證明價格或速度上有優勢。這些限制說明各項輸入設定允許 Actor 收集多少資料。可取得的公開留言與所選設定仍會影響結果。

只提供較少資料列類型的工具，也可能是正確選擇。如果評估只使用最初提出的問題，加入回覆文字可能只會增加閱讀工作，卻無助於決策。如果評估必須檢視討論串中的答案，回覆數量就缺少了所需的文字內容。

請將這項區別與其他產品問題分開看待。本篇比較未證實收集速度、成本或完整性有何差異。

收集前分別設定限制

Chronometrica 使用 `maxCommentsPerVideo` 設定頂層留言限制。可接受的值為1至1,000。當 `includeReplies` 為 true 時，`maxRepliesPerComment` 可接受的值為1至100。頂層留言限制與回覆限制各自獨立。Chronometrica 輸入結構定義

這項區別會改變匯出工作的規劃方式。啟用回覆後，頂層留言限制不會變成總資料列數的限制。每則選中的上層留言都可能增加回覆資料列，最多可達設定的回覆上限。

對於1部影片，允許的最大數量計算方式如下：

`top-level cap + (top-level cap × reply cap)`

使用這項計算，估計這2項設定所允許的最大結果。這是上界，也就是在所述條件下的最大值。它不是你將收到多少資料列的預測。

實用的限制應符合你的評估能力。先決定你能檢視多少個最初提出的問題，再決定每個問題下需要閱讀多少則回覆。收集前記錄這2個數量，讓後續報告更容易說明。

擴大工作範圍時，請保留每次收集的設定。否則，較多的結果可能看似代表更多討論，實際上卻只是提高收集上限的結果。設定也是解讀資料列數所需的證據。

從1部相關的公開影片開始

下列輸入使用目前文件記載的欄位。它會啟用回覆，並分別設定較小的限制：

{
  "startUrls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  ],
  "maxCommentsPerVideo": 2,
  "includeReplies": true,
  "maxRepliesPerComment": 2
}

此網址用來示範輸入格式。請將它換成相關的公開影片。範例中列出此網址，不代表目前能取得該影片的留言。Chronometrica 輸入結構定義

Chronometrica 也提供公開的留言與回覆 Task。Task 是已儲存的輸入預設組合。你可以從這組預設輸入開始，再依評估問題檢查設定。留言與回覆匯出 Task

首次收集的目的很明確：確認傳回的欄位能支援預定的評估工作。檢查你是否能辨識回覆資料列，並將它們連結至上層留言。將連結的文字一起閱讀，確認這項關聯是否提供足夠的上下文。

輸入有效，並不代表結果包含所需證據。加入更多影片前，請先檢查輸出。首次收集的規模較小，能讓你逐筆人工查看記錄，因此更容易完成這項檢查。

逐步檢視含5筆資料列的虛構結果

此範例為虛構內容。它不是 Actor 執行結果、效能基準測試，也不是客戶結果。

這次評估選取2則頂層留言。第1則收集到2則回覆。第2則收集到1則回覆。因此，匯出資料包含：

• 2筆頂層留言資料列。
• 3筆回覆資料列。
• 合計5筆資料列。

為方便閱讀，將上層留言標示為 A 與 B。把前2則回覆放在 A 下方，其餘1則回覆放在 B 下方。這些標籤僅用於說明範例，不是建議新增的輸出欄位。

在這個虛構結果中，回覆占資料列的 `3 / 5 × 100 = 60%`。這個百分比只描述已收集的資料列。它不代表不重複的作者、影片的所有留言，或所有觀眾。1個人可能撰寫多筆資料列。

頂層留言上限為2則，每則上層留言的回覆上限為2則時，算出的上界是 `2 + (2 × 2) = 6` 筆資料列。虛構結果包含5筆。這些限制允許收集6筆資料列，但不保證會有6筆。

現在假設其中1則虛構回覆更正了教學影片中的答案。閱讀該回覆可能改變評估結果。只含回覆數量的上層留言資料列，無法呈現更正的文字。這就是需要回覆文字的實際原因。

如果評估只需要找出哪些最初提出的問題有人回應，回覆數量可能就已足夠。同一個虛構討論串可能適合不同的收集選擇，因為研究問題不同。

這個範例也說明，收集總數為何需要清楚標示。「已收集5筆資料列，其中包含3則回覆」能描述這個結果。「5位觀眾」或「全部5則留言」則宣稱了範例未能證實的事實。

採用小規模收集與評估方法

使用這個方法，將產品選擇轉為可檢查的結果。

1. 定義必須閱讀的內容。寫明你是否必須閱讀回覆，或只需評估頂層問題。指出這些文字將支援哪項決策。如果回覆的措辭可能改變決策，就將回覆文字列入需求。
2. 明列限制。設定頂層留言上限，並在需要時設定回覆上限。收集前計算允許的最大數量。在評估筆記中，將限制記錄在影片網址旁，讓其他讀者能解讀結果。
3. 保留記錄連結。在匯出資料中保留留言 ID 與上層留言連結。ID 用於識別一筆記錄。上層留言連結會將回覆連接至其所屬留言。移除這些欄位後，即使文字仍可閱讀，也可能難以進行後續分組。
4. 區分資料列類型。將頂層留言與回覆視為不同類型的記錄來閱讀。Chronometrica 文件記載的相關欄位包括 `isReply` 與 `parentCommentId`。計數或分組前，先檢查傳回結果中的這些欄位。Chronometrica 功能規格
5. 將回覆分組以便閱讀。使用保留的連結，將每則回覆放在其上層留言下方。讓無法對應的連結維持可見。如果匯出資料缺少所需的上層留言，不要猜測哪則留言提供了上下文。將該情況標記為待檢查。
6. 每筆已收集的資料列只計算1次。報告頂層留言資料列數、回覆資料列數，以及兩者總和。將 `replyCount` 與這項計算分開。它是數量欄位，不是另一組已收集的文字資料列。
7. 檢查證據是否回答了問題。擴大收集前，先閱讀小規模結果。確認所需文字與連結都存在。如果評估只需要頂層留言文字，請重新評估收集回覆是否增加了有用的證據。

這些步驟能讓其他人檢查你的結果。它們也能將收集選擇與對討論內容的結論分開。缺少上層留言，是需要報告的上下文問題。資料列總數較少，是需要說明的收集結果。兩者都不能支持憑空編造有關影片的答案。

區分回覆數量與已收集的回覆

常見的計數錯誤，是將上層留言的 `replyCount` 加到匯出資料中已有的回覆資料列數。這可能讓同一批討論被計算2次。

請保留2項獨立指標。第1項是實際收集到的回覆資料列數。第2項是留言記錄中儲存的回覆數量。清楚標示每項指標。不要假設儲存的數量等於匯出資料中的回覆資料列數。

收集限制允許取得的回覆資料列數，可能少於討論串實際包含的回覆數。因此，結果必須區分可供檢查的文字與可供報告的數量。只有已收集的文字，才能支持有關某則回覆說了什麼的陳述。

保留未知值。如果欄位缺失，不要用0取代。0對數量作出了明確陳述。缺失值則表示，無法從該欄位得知數量。

處理上層留言連結時，也要同樣謹慎。將無法對應上層留言的回覆保留在可見的待檢查群組中。它的文字仍可能有用，但匯出資料並未提供完整關聯，無法讓你有把握地閱讀討論串。