創作者觀眾分析是做什麼的？

YouTube 並未發布觀眾人口統計資料。youtube-channel-profile 所使用的 Data API 也沒有這類數據。有兩個誠實的來源：頻道擁有者自己的 Analytics（經同意後分享），或人類核准的第三方付費估算。除此之外的任何方式都是猜測。請明確告知這一點。

同意規則

擁有者的數據來自擁有者本人。他們選擇分享哪些內容、用於哪些日期，以及誰可以查看。在您要求存取之前，請先取得書面同意（電子郵件或訊息）。
擁有者使用自己的帳戶登入。切勿要求他們的密碼或驗證碼，也不要替他們輸入任何代碼。
付費需取得同意。在每次進行付費查詢前，先詢問人類使用者，並告知費用金額。
切勿根據姓名、臉孔、聲音、留言或縮圖推斷年齡、性別或地點。
資料僅供該項工作使用。僅向擁有者及其核准的人員顯示（YouTube 政策 III.E.3.b）。應要求，在 7 天內刪除資料（III.E.4.g）。若保留資料，則每 30 天需重新確認擁有者的同意（III.E.4.b）。

途徑 1：擁有者從 YouTube Studio 分享（從這裡開始）

此方式不需要 API 操作，適合一次性簡報。

選項 A，匯出：請擁有者開啟 YouTube Studio，依序前往 Analytics > Audience 分頁。他們選擇一個日期範圍（最近 90 天是良好的預設值），然後分享年齡、性別和主要國家的螢幕截圖或匯出檔。

選項 B，唯讀存取：擁有者開啟 YouTube Studio，依序前往 Settings > Permissions > Invite。他們輸入人類使用者的 Google 帳戶電子郵件，並選擇 Viewer (Limited) 角色。該角色可以查看 Analytics 但無法查看收益。邀請會在 30 天後到期。工作結束後，擁有者從同一個畫面移除存取權限。品牌帳戶頻道必須先切換到頻道權限設定。

途徑 2：YouTube Analytics API（重複性或較大型工作）

當擁有者或其團隊會執行此操作，或屬於有書面同意的長期合作時使用此途徑。

在 Google Cloud 中建立專案。啟用 YouTube Analytics API 和 YouTube Data API v3。
設定 OAuth 同意畫面：使用者類型設定為「外部」，發布狀態設定為「測試中」。將擁有者的 Google 帳戶新增為測試使用者。
建立一個類型為「桌面應用程式」的 OAuth 用戶端 ID，並下載用戶端檔案。將其視為機密。
僅要求下列範圍：
- https://www.googleapis.com/auth/yt-analytics.readonly
- https://www.googleapis.com/auth/youtube.readonly（reports.query 參考文件現在也要求此範圍）
- 只有在擁有者同意分享收益時，才新增 yt-analytics-monetary.readonly。
在擁有者親自登入的機器上執行登入程序。例如：

# pip install google-auth-oauthlib requests
from google_auth_oauthlib.flow import InstalledAppFlow
import requests
SCOPES = ["https://www.googleapis.com/auth/yt-analytics.readonly",
          "https://www.googleapis.com/auth/youtube.readonly"]
creds = InstalledAppFlow.from_client_secrets_file("client_secret.json", SCOPES).run_local_server(port=0)
base = "https://youtubeanalytics.googleapis.com/v2/reports"
common = {"ids": "channel==MINE", "startDate": "2026-08-01", "endDate": "2026-10-31"}
auth = {"Authorization": f"Bearer {creds.token}"}
age_gender = requests.get(base, headers=auth, params={**common,
    "metrics": "viewerPercentage", "dimensions": "ageGroup,gender"}).json()
countries = requests.get(base, headers=auth, params={**common,
    "metrics": "views,estimatedMinutesWatched", "dimensions": "country",
    "sort": "-views", "maxResults": 10}).json()

當 Google 詢問時，擁有者會選擇正確的頻道。channel==MINE 表示他們登入時使用的頻道。
讀取 columnHeaders 和 rows。viewerPercentage 僅涵蓋已登入的觀眾。當沒有資料時，YouTube 會省略 rows。請將其回報為「無法取得」，切勿回報為零。
僅將權杖保留在記憶體中。之後，撤銷該權杖：擁有者可以在 myaccount.google.com/permissions 執行此操作。測試中應用程式的重新整理權杖也會在 7 天後過期。

途徑 3：付費估算 (Influencers Club MCP)

Influencers Club 可估算公開 YouTube 頻道的觀眾人口統計資料。這是第三方模型，並非 YouTube 數據。每次查詢會消耗點數。

執行 check_credits（免費）並記錄餘額。
告知人類使用者此工具及其費用，然後等待同意。2026 年 11 月 5 日檢查的伺服器 README 中的費用：enrich_by_handle_analytics 花費 0.8 點，並回傳觀眾人口統計資料。enrich_by_handle 花費 1 點；在較舊的伺服器上，需傳遞 include_audience_data 為 true 以取得觀眾區段。enrich_by_handle_raw 花費 0.03 點，且無觀眾數據。請先閱讀工具本身的描述，因為版本可能不同。
針對單一頻道進行一次呼叫，將 platform 設定為 youtube，handle 設定為頻道代碼或頻道 ID。
如果任何呼叫回傳限制或點數錯誤，請停止。請勿重試，並回報已完成多少次查詢。
請勿為此目的使用 get_audience_locations 或 get_audience_interests。它們是免費的篩選值列表，而非創作者的觀眾資料。

將結果標示為「由 Influencers Club 估算」，提供查詢日期，且切勿將其與擁有者的數據混合而不說明來源。

簡報中應撰寫的內容

每個數據的來源：擁有者的 YouTube Analytics 及其日期範圍、擁有者的 Studio 匯出，或第三方估算。
已登入觀眾的年齡和性別比例，以及依觀看次數排名的前幾名國家。
如果沒有取得同意且未核准任何付費，則撰寫「觀眾人口統計資料：無法取得，需要擁有者的 Analytics 或付費估算。」這是一個完整的答案。

最後更新檢查日期：2026 年 11 月 5 日，對照 YouTube Analytics API 參考、指標與授權頁面、YouTube 說明中心的頻道權限，以及 Influencers Club MCP README 與使用限制。

創作者觀眾分析