「鮭魚均，因為一場鮭魚之亂被主管稱為鮭魚世代，廣義來說以年齡和臉蛋分類的話這應該算是一種 KNN 的機器學習，不正經的數據分析師，畢業後把人生暫停了半年，在 Google 和 AWS 辦過幾場演講，緩下腳步的同時找了份跨領域工作。偶而慢跑、愛跟小動物玩耍。曾立過很多志，最近是希望當一個有細節的人。」

Youtube Analytics API 教學 - 基本架構 reports.query

Youtube Analytics API 能找到的資料非常少，尤其在中文語系中，甚至可以說在我是第一個詳細寫Youtube Analytics API 的人，相較於 Data API 的自由性，Analytics 的隱私注重較高設定也更為複雜，今天以影片資訊說明，抓取你在創作者工作室 Youtube Studio 中的資訊，他需要具有高度的驗證與安全性，但也同時給予了影音串流和數位行銷的工作者，有了更加多元的資料運用方式，更靈活的追蹤每 Youtube 影片的影片資訊。這篇是 Python - 數位行銷的 Youtube 分析教學系列文章的第 19 篇，也是我參加 2021 iThome 鐵人賽中系列文章的第 19 天。

系列文章：Python — 數位行銷分析與 Youtube API 教學
昨日回顧：Youtube Analytics API 教學 - 請出示身分 Python OAuth 2.0

設定基本架構介紹 reports.query

什麼時候 (When)、你是誰(Who)，你要抓什麼資料 (What)，在基本架構的設定中，我們最先會看見的設定會是 youtube_analytics.reports().query() 這個方法，這個方法是我們使用 Analytics API 的主要方法，我們在內部的參數中最重要的第一項資訊就是時間的設定，藉由 startDate 開始的時間和 endDate 結束時間來確定你要設定的時間區間。

def main():
    request = youtube_analytics.reports().query(
        startDate='2021-08-01', 
        endDate='2021-09-29'
)
    response = request.execute()

if __name__ == "__main__":
    main()

• 你是誰？ 你的 channel ID？
  對於 Python 程式來說，他並不知道你是誰，也不知道要跟誰去呼叫這個 API 參數，所以 ids 的設定就是針對你是誰來提供資訊，Youtube API 牽涉到私人資訊，所以我就直接拿我沒什麼在經營的個人帳號來 demo 測試好了，在你進入頻道後可以在網址列的地方看見你的頻道 Channel ID 這項資訊

• 將頻道的 Channel Id 輸入進 ids 裡
  在 ids 的使用上因為除了個人的頻道以外，其實還有分像是內容管理員或是相關等等的帳號（這部分我們後面會寫一篇文章介紹），所以我們在 ids 中要先設定他的 channel == "xxx"，從以下範例可以看出完整句子：

def main():
    request = youtube_analytics.reports().query(
        startDate='2021-09-01', 
        endDate='2021-09-29',
        ids='channel==UCyRTbF-WQcgW9XV-B_kPpug'
    )
    response = request.execute()

if __name__ == "__main__":
    main()

• 設定你的 Dimension 和 metrics
  什麼時候 (When)、你是誰(Who)，接下來就是要知道你要抓什麼資料 (What)，一般來說我們會分為所謂的維度 (Dimension) 和指標 (metrics)，類似線圖中橫軸縱軸，以下設定是 dimensions= 'day' 以日期方式來切分資料，並且以 metrics= 'views,estimatedMinutesWatched' 的方式來抓取觀看次數 (view) 和預計觀看分鐘數(estimatedMinutesWatched)

def main():
    request = youtube_analytics.reports().query(
        startDate='2021-09-01', 
        endDate='2021-09-29',
        ids='channel==UCyRTbF-WQcgW9XV-B_kPpug',
        dimensions= 'day', 
        metrics= 'views,estimatedMinutesWatched',
    )
    response = request.execute()
    print(response)

if __name__ == "__main__":
    main()

• 整體狀況看來還不錯
  基本上有了這五個參數就能做最基本的資料抓取的，謹記著這三個步驟，什麼時候 (When)、你是誰(Who)，你要找什麼資料 (What)，

今天說明了 Youtube Analytics API 的基本架構 reports.query

如果有時間也歡迎看看我的夥伴們的文章

lu23770127 — SASS 基礎初學三十天
10u1 — 糟了！是世界奇觀！
juck30808 — Python — 數位行銷分析與 Youtube API 教學
HLD — 淺談物件導向與Design Pattern介紹
SiQing47 — 前端？後端？你早晚都要全端的，何不從現在開始？

Jerry Chien

【鮭魚均】 現職是 200 多萬訂閱 Youtuber 的數據分析師，專長在 Python 的開發與使用，大學雖然是資訊背景但總是斜槓跑到商管行銷領域，以工作角度來說的話，待過 FMCG、通訊軟體、社群影音產業，也算是個數位行銷體系出生的資訊人。這 30 天鐵人挑戰賽會從數位行銷角度去重新切入數據分析這件事情，期待這個社會中，每個人能在各個角力間不斷沖突而漸能找到一個平衡點回歸最初的統計建立最終的初心。

下一篇：Youtube Analytics API 教學 - 流量怎麼越來越差 'day' 維度